Annotate deprecated_args decorator to preserve wrapped function type signature

[mharding-hpe]

Pull Request check-list

• Do tests and lints pass with this change?

Everything passes except one standalone test: tests/test_commands.py::TestRedisCommands::test_psync

However, I ran the tests on the master branch of the repo and got the same result, so I assume that test failure is unrelated to my changes.

• Do the CI tests pass with this change (enable it first in your forked repo and wait for the github action build to finish)?

mharding-hpe#2

• Is the new or changed code fully tested?

• Is a documentation update included (if this change modifies existing APIs, or introduces new ones)?

N.A

• Is there an example added to the examples folder (if applicable)?

N/A

Description of change

Opened to resolve issue #3700

Added type annotations to the deprecated_args decorator, to clarify that the type of callable will not be modified by anything inside the different functions (thus preserving its original signature). Without this, mypy interprets the type of redis.Redis() to be Any.

This issue was introduced between v6.0.0b2 and v6.0.0. So ideally this fix would be backported to the v6.0 and v6.1 branches, but I don't know the policy for that in this project.

[petyaslavova]

Hi @mharding-hpe, thank you for your contribution! It will be reviewed shortly.
Regarding backporting to previous versions: as per our policy, we only backport critical fixes, so this change will be included in newer versions only.

[Copilot]

Pull Request Overview

This PR adds precise type annotations to the deprecated_args decorator so that wrapped functions retain their original signatures for tools like MyPy.

• Introduces a TypeVar C bound to Callable for preserving callables' types
• Annotates deprecated_args to return Callable[[C], C] and its inner decorator to accept and return C
• Imports the necessary types and updates the typing imports

Comments suppressed due to low confidence (1)

redis/utils.py:4

• Importing Callable from collections.abc may not support subscripting for type annotations on all supported Python versions. Consider importing Callable from typing instead to ensure Callable[[C], C] works universally.

from collections.abc import Callable