1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
"""Backward compatibility for newer/less buggy typing features.
## Important
Import from here to avoid introducing a runtime dependency on [`typing_extensions`]
## Notes
- `Protocol38`
- https://github.com/narwhals-dev/narwhals/pull/2064#discussion_r1965921386
- https://github.com/narwhals-dev/narwhals/pull/2294#discussion_r2014534830
- `TypeVar` defaults
- https://typing.python.org/en/latest/spec/generics.html#type-parameter-defaults
- https://peps.python.org/pep-0696/
- `@deprecated`
- https://docs.python.org/3/library/warnings.html#warnings.deprecated
- https://typing.python.org/en/latest/spec/directives.html#deprecated
- https://peps.python.org/pep-0702/
[`typing_extensions`]: https://github.com/python/typing_extensions
"""
from __future__ import annotations
# ruff: noqa: ARG001, ANN202, N802
import sys
from typing import TYPE_CHECKING, Any
if TYPE_CHECKING:
from typing import Callable, Protocol as Protocol38
if sys.version_info >= (3, 13):
from typing import TypeVar
from warnings import deprecated
else:
from typing_extensions import TypeVar, deprecated
_Fn = TypeVar("_Fn", bound=Callable[..., Any])
else: # pragma: no cover
if sys.version_info >= (3, 13):
from typing import TypeVar
from warnings import deprecated
else:
from typing import TypeVar as _TypeVar
def TypeVar(
name: str,
*constraints: Any,
bound: Any | None = None,
covariant: bool = False,
contravariant: bool = False,
**kwds: Any,
):
return _TypeVar(
name,
*constraints,
bound=bound,
covariant=covariant,
contravariant=contravariant,
)
def deprecated(message: str, /) -> Callable[[_Fn], _Fn]:
def wrapper(func: _Fn, /) -> _Fn:
return func
return wrapper
# TODO @dangotbanned: Remove after dropping `3.8` (#2084)
# - https://github.com/narwhals-dev/narwhals/pull/2064#discussion_r1965921386
if sys.version_info >= (3, 9):
from typing import Protocol as Protocol38
else:
from typing import Generic as Protocol38
__all__ = ["Protocol38", "TypeVar", "deprecated"]
|
