python (3.12.0)
ˑe d dl mZmZ d dlZd dlmZ d dlZd dlZd dlZd dlZd dl Z d dl
Z d dl Z d dl
Z
d dlZd dl
mZmZmZmZ d dlmZmZmZmZmZmZmZmZ g dZ dddd Z dddd Z d Z d
Z d Z!d Z"d Z#d Z$d Z%d Z&d Z'g Z(i Z)ddddZ* e+ fdZ, G d d Z- G d d Z. G d d e-e.d
Z/ G d d e/d
Z0 G d! d"e1 Z2 G d# d$e2% Z3e/d& Z4e/d' Z5e/d( Z6e/d) Z7e/d* Z8e/d+ Z9e/d, Z:d- Z;e/d. Z<e0 e*d
d/ Z=e/d0 Z>e/d1 Z?e/d2 Z@ G d3 d4e-d
ZAd5e3d6eBfd7ZCd5e3d6eBfd8ZD G d9 d: ZEd; ZFd< ZGd= ZHd> ZIe*d? ZJd@ ZKdA ZL G dB dCe-d
ZM G dD dEeMd
ZN G dF dGe.eMd
ZO G dH dIeOd
ZP G dJ dKe.eNd
ZQ G dL dMeOd
ZR G dN dOeOd
ZS G dP dQe.eNd
ZTdR ZU G dS dTeNd
ZV G dU dVeNd
ZWe/dW ZX G dX dYeNd
ZY G dZ d[ ZZ e+h d\ Z[ e+h d] Z\e[e\z d^hz Z]d_ Z^d` Z_ddbZ`dddZag dedfdggdhZbej di Zde(j edj dj Zg ej eeg dk Zi ej eei [g[i G dl dme Zjekdn Zl G do dpeej% Zm G dq dre.eNd
Zn G ds dt Zodu Zpdv Zqdw Zre
j e
j e
j e
j eeefZwddxZxdy Zydz Zzd{ Z{d| Z|d}Z}d~e5d6e5fdZ~d Zd Zd Z e ej ee Zd Zd Zd Zd Z ed Z ed Z ed Z edd
Z edd
Z edd
Z edd
Z edd
e1 Z edee ZeOZ eej j* d Z eej j, da Z eej j. d Z eej j0 da Z eej j2 da Z eej j4 da Z eej j6 da Z eej j8 da Z eej j: d Z eej j< da Z eej j> da Z eRej j@ dc Zde_ eej jD dad Z eej jH da Z eej jJ dc Z eej jL dc Z eej jN da Z eej jP da Z ePej jR d d Z eSeddd Zde_ eedadd Z eej\ dad Z eedadd Z ee+dadd Z eej jd da Z eej jf da Z eej jh dc Z eej jj da Z eejl dad Z eejp dad Z eedcdd Z eej dcd Z eejx dc Z eejz da Z eej| dc Z eej j~ d Z eej j dc Z ee1dadd Zde_ ep G d dem Zep G d dem Zep G d dem Zep G d dem Zep G d dem Zep d Zep d ZddZ e+h d Z e+h d Z G d de1 ZddZe1j eddi Zd Zee_ G d de1 Zdd
ddZe1j eddi Zd e_ e/d Ze/dÄ Z G dĄ dū ZeZdZ G dƄ dee Z G dȄ dee Z G dʄ dee Z G d̄ de1 Z G d΄ deݬ% Zedz e_ ee j eސj < ee j da Z ee j da Z G dф deݬ% Z
edz e
_ e
e j e
j < dԄ Z G dՄ dem Zd
dddddלdeBdeBdeBdeBdee1e3 ede3f z df de3d6efd߄Zddd f Z d Zy) )abstractmethodABCMetaN) defaultdict)WrapperDescriptorTypeMethodWrapperTypeMethodDescriptorType GenericAlias)_idfuncTypeVar ParamSpec TypeVarTuple
ParamSpecArgsParamSpecKwargs
TypeAliasTypeGeneric)c AnnotatedAnyCallableClassVar ConcatenateFinal
ForwardRefr LiteralOptionalr ProtocolTupleTyper r
Union AbstractSet
ByteString ContainerContextManagerHashable ItemsViewIterableIteratorKeysViewMapping MappingViewMutableMappingMutableSequence
MutableSetSequenceSized
ValuesView Awaitable
AsyncIterator
AsyncIterable Coroutine
CollectionAsyncGeneratorAsyncContextManager
Reversible SupportsAbs
SupportsBytesSupportsComplex
SupportsFloat
SupportsIndex SupportsInt
SupportsRoundChainMapCounterDequeDict DefaultDictList OrderedDictSet FrozenSet
NamedTuple TypedDict GeneratorBinaryIOIOMatchPatternTextIOAnyStr assert_type assert_nevercastclear_overloadsdataclass_transformfinalget_args
get_origin
get_overloadsget_type_hints is_typeddict
LiteralStringNeverNewType
no_type_checkno_type_check_decoratorNoReturn NotRequiredoverloadoverrider r Required reveal_typeruntime_checkableSelfText
TYPE_CHECKING TypeAlias TypeGuardr UnpackFallow_special_formsc ^ | t d S t | t rt | || S | S )N)moduleis_class)type
isinstancestrr )argrq ro s :/BuggyBox/python/3.12.0/bootstrap/lib/python3.12/typing.py
_type_convertrx s3 G
{Dz#s#f7JKK J Tc t t f}|s|t fz
}|r
|t fz
}t | || } t | t r | j |v rt | d | t t t t t t fv r| S |r| t t fv r| S t | t s| t t fv rt d| d t! | t" u rt | d| dd | S )N)rq ro is not valid as type argumentzPlain z Got z.100.)r r r r rx rt
_GenericAlias
__origin__ TypeErrorr r\ ra r] rh rk _SpecialFormrs tuple)rv msg is_argumentrq ro invalid_generic_formss rw _type_checkr s
%h / (, !eX - !
F@S
TC3
& NN 3 33% =>??
sM8UD)DD
sx&7 7
#|$/B(B&%CDEE CyE3%uS4L233 Jry c N | du xs t | t t t t f S N.)rt r listr _ConcatenateGenericAlias)rv s rw _is_param_exprr s, #: @C
D)%= >@ @ry c | j t j j u xr t | dk( xr t |d S )N r )r~ collectionsabcr lenr )typargss rw _should_unflatten_callable_argsr sE +//222 =Ta ;N47$; <ry c X t | t r6| j dk( r | j S | j d| j S | du ryt | t j
r | j S t | t r ddj d | D z dz S t | S ) Nbuiltinsr| ....[, c 3 2 K | ] }t | y wN)
_type_repr).0ts rw <genexpr>z _type_repr.<locals>.<genexpr> s :z!} : ])
rt rs
__module__ __qualname__types FunctionType__name__r joinreprobjs rw r r s #t >>Z '## #..!3#3#3"455
cz#u))*||#u TYY :c :::S@@ 9ry c b g }| D ] }t |t rt |t r/|D ]) }t |g D ] }||vs|j | + St |d r||vsd|j | vt
|dd D ] }||vs|j | t | S N__typing_subst____parameters__ )rt rs r _collect_parametersappendhasattrgetattr)r
parametersr x collecteds rw r r s J
) a
5
!
5!4aS!9 5I
2")))45
5 Q*
+
"!!!$ Q 0"5
)J& %%a(
) )$ ry c
|st | d t | }||k7 r t d||kD rdnd d| d| d| y )N is not a generic classToo manyfew arguments for ; actual , expected )r r )clsr elenalens rw _check_genericr sm 3% 6788 z?D t|$v% @PSu U##'& D6; < < ry c g }| D ]= }t |dd }||r|d du s|j | -|j | ? |S )N __typing_unpacked_tuple_args__.)r extendr )r newargsrv subargss rw _unpack_argsr , sW G # ?F GBK34F NN7 # NN3 Nry c t | }t | t | k r2g }| D ]) }||v s|j | |j | + |} | S r )setr r remove)params
all_params
new_paramsr s rw _deduplicater 6 s^ VJ
:V$
%AJ!!!$!!!$ % Mry c g }| D ]O }t |t t j f r |j |j
?|j
| Q t t | S r ) rt _UnionGenericAliasr UnionTyper __args__r r r r r ps rw _remove_dups_flattenr D s_
F
a,eoo> ? MM!** % MM! f% &&ry c g }| D ]? }t |t r |j |j /|j | A t | S r )rt _LiteralGenericAliasr r r r r s rw _flatten_literal_paramsr T sL R
F
a- . MM!** % MM!
=ry typedc ( fd}| || S |S )Nc t j }|t < t j |j
~t j fd }|S )Nr c P t | i |S # t $ r Y nw xY w | i |S r )_cachesr )r kwdsfuncs rw innerz+_tp_cache.<locals>.decorator.<locals>.inners s>
t}d3d33
&& &s
) functools lru_cacher _cleanupsr cache_clearwraps)r cacher r s ` rw decoratorz _tp_cache.<locals>.decoratorh s^ 1 ##%06
**+ '
' ry r )r r r s ` rw _tp_cacher c s% ( ry c t | t r| j S t | t t t
j f r t | t rft d | j D }| j }t | | r| j |d d |d f } n| j | } |r t | } t fd| j D }|| j k( r| S t | t rt | j | S t | t
j r$t j t j | S | j# | S | S )Nc 3 V K | ]! }t |t r t | n| # y wr )rt ru r r rv s rw r z _eval_type.<locals>.<genexpr> s* $.c3#7
3S@s ')r c 3 : K | ] }t | y wr )
_eval_type)r aglobalnslocalnsrecursive_guards rw r z _eval_type.<locals>.<genexpr> s ^a
1h I^s )rt r _evaluater} r r r r r __unpacked__r r~ rm r reduceoperatoror_ copy_with)r r r r r is_unpackedev_argss ``` rw r r s) !Z {{8Wo>>!m\5??CD a & :: D ..K.q$7LL$s)T"X!67LL&1I^STS]S]^^ ajj H a & g6 6 a ) ##HLL': :;;w' ' Hry c e Zd Z dZd Zy)_Final) __weakref__c " d|vr t d y )N_rootz&Cannot subclass special typing classesr )r r r s rw __init_subclass__z_Final.__init_subclass__ s $ DE E ry N)r r r __slots__r r ry rw r r s ( IFry r c e Zd Z dZdZy) _NotIterabler N)r r r r __iter__r ry rw r r s IHry r c \ e Zd ZdZd Zd Zd Zd Zd Zd Z d Z
d Z d
Z d Z
ed Zy
)r )_name__doc___getitemc V || _ |j | _ |j | _ y r )r r r r )selfgetitems rw __init__z_SpecialForm.__init__ s!
%%
ry c 8 |dv r | j S t | )N> r r )r AttributeError)r items rw __getattr__z_SpecialForm.__getattr__ s / /:: T""ry c t d| )NCannot subclass r r basess rw __mro_entries__z _SpecialForm.__mro_entries__ s *4(344ry c d| j z S Ntyping.r r s rw __repr__z_SpecialForm.__repr__ 4::%%ry c | j S r r r s rw
__reduce__z_SpecialForm.__reduce__ zzry c t d| )NzCannot instantiate r )r r r s rw __call__z_SpecialForm.__call__ s -dX677ry c t | |f S r r r others rw __or__z_SpecialForm.__or__ T5[!!ry c t || f S r r$ r% s rw __ror__z_SpecialForm.__ror__ UD[!!ry c t | d )Nz! cannot be used with isinstance()r r r s rw __instancecheck__z _SpecialForm.__instancecheck__ 4& ABCCry c t | d )Nz! cannot be used with issubclass()r r r s rw __subclasscheck__z _SpecialForm.__subclasscheck__ r/ ry c & | j | | S r )r r r s rw __getitem__z_SpecialForm.__getitem__ s }}T:..ry N)r r r r r
r r r r r" r' r* r. r2 r r5 r ry rw r r sO 0I'
# 5&8""DD / /ry r )r c e Zd Zd Zy)_LiteralSpecialFormc N t |t s|f} | j | g| S r )rt r r r4 s rw r5 z _LiteralSpecialForm.__getitem__ s) *e,$ J t}}T/J//ry N)r r r r5 r ry rw r7 r7 s 0ry r7 c ( e Zd Z fdZ fdZ xZS )_AnyMetac H | t u r t d t |
| S )Nz+typing.Any cannot be used with isinstance())r r superr. )r r __class__s rw r. z_AnyMeta.__instancecheck__ s& 3; IJ Jw(--ry c 2 | t u ryt | S )Nz
typing.Any)r r< r )r r= s rw r z_AnyMeta.__repr__ s 3; w !!ry )r r r r. r
__classcell__r= s @rw r: r: s .
" "ry r: c e Zd Z fdZ xZS )r c P | t u r t d t | | g|i |S )NzAny cannot be instantiated)r r r< __new__r r kwargsr= s rw rC z Any.__new__ s/ #: 89 9ws4T4V44ry )r r r rC r? r@ s @rw r r s 5 5ry r ) metaclassc t | d Nz is not subscriptabler r4 s rw ra ra s
tf 12
33ry c t | d rH r r4 s rw r] r] & s ( tf 12
33ry c t | d rH r r4 s rw rh rh ? s tf 12
33ry c t | d rH r r4 s rw r\ r\ S s , tf 12
33ry c < t || d }t | |f S N accepts only single type.r r} r r r s rw r r n , " zdV+E#F GD w ''ry c < t || d }t | |f S rM rO rP s rw r r rQ ry c |dk( r t d t |t s|f}dt fd|D }t | }t | dk( r|d S t | dk( rt d |v rt
| |d S t
| | S )
Nr z Cannot take a Union of no types.z)Union[arg, ...]: each arg must be a type.c 3 6 K | ] }t | y wr r r r r s rw r zUnion.<locals>.<genexpr> s ?q{1c*? r r r name)r rt r r r rs r r r r s @rw r r s : R:;; j% ( ]
5C?J??J%j1J
:!!}
:!T
j 8!$
DD dJ //ry c t | |f S r r$ )leftrights rw _make_unionr_ s u ry c J t || d }t |t d f S )Nz requires a single type.)r r rs )r r rv s rw r r s, 6
jTF*B"C
DC d4j !!ry c
t | } t d t t t | D }t
| | S # t
$ r Y w xY w)Nc 3 & K | ] \ }}| y wr r )r r _s rw r zLiteral.<locals>.<genexpr> s ^A1^s )r r r r _value_and_type_iterr r r4 s rw r r s\ , )4J
^ d;OPZ;[6\)]^^
j 11
s -A AAc t | d rH r r4 s rw rk rk s tf 12
33ry c |dk( r t d t |t s|f}|d du s t |d t s t d dg fd|d d D |d }t | | S )Nr z&Cannot take a Concatenate of no types.r .zMThe last parameter to Concatenate should be a ParamSpec variable or ellipsis.z/Concatenate[arg, ...]: each arg must be a type.c 3 6 K | ] }t | y wr rU rV s rw r z Concatenate.<locals>.<genexpr> s AAK3'ArW )r rt r r r r[ s @rw r r s R@AA j% ( ]
rNc !Z
2 %J : ; ;
;CRACR AR:b>RJ #D* 55ry c < t || d }t | |f S rM rO rP s rw rl rl # s- +X zdV+E#F GD w ''ry c D e Zd Z dZd dddZd Zd Zd Zd Zd
Z d Z
y)
r )__forward_arg____forward_code____forward_evaluated____forward_value____forward_is_argument____forward_is_class____forward_module__NF)rr c t |t st d| |d dk( rd| d}n|} t |dd }|| _ || _ d | _ d | _ || _ || _
|| _ y # t $ r t d| w xY w)
Nz*Forward reference must be a string -- got r *(z,)[0]z<string>evalz/Forward reference must be an expression -- got F) rt ru r compile SyntaxErrorrj rk rl rm rn ro rp )r rv r rq rr arg_to_compilecodes rw r
zForwardRef.__init__] s #s# H PQ Q
q6S= U^N N Y>:v>D # $ %*"!% '2$$,!"( Y OPSw WX X Ys
A0 0Bc | j |v r| S | j r||ur||i x}}n ||}n||}| j 5t t j
j
| j d d| }t t | j || d| j | j }t ||||| j hz | _
d| _ | j S )N__dict__z*Forward references must evaluate to types.)r ro T)rj rl rp r sysmodulesgetr rt rk rn ro r rm )r r r r type_s rw r zForwardRef._evaluateu s ? 2K))WH-D GO%''7!" "&&2"KKOOD$;$;TBJPX T**Hg>< 8 8$($=$= E &0x/T=Q=Q<R*R&D " *.D &%%%ry c . t |t st S | j r@|j r4| j |j k( xr | j
|j
k( S | j |j k( xr | j |j k( S r )rt r NotImplementedrl rj rm rp r% s rw __eq__zForwardRef.__eq__ s %,! ! % %%*E*E((E,A,AA F**e.E.EE
G$$(=(== D''5+C+CC Ery c D t | j | j f S r )hashrj rp r s rw __hash__zForwardRef.__hash__ s T))4+B+BCDDry c t | |f S r r$ r% s rw r' zForwardRef.__or__ r( ry c t || f S r r$ r% s rw r* zForwardRef.__ror__ r+ ry c b | j d}nd| j }d| j | dS )N z , module=z ForwardRef())rp rj )r module_reprs rw r zForwardRef.__repr__ s@ " " * K %d&=&=%@AK T 1 1 4[MCCry TN) r r r r r
r r r r' r* r r ry rw r r U s9 7'I
)u )0&4EE""Dry r r returnc B t | t xr
t | dd S )N#__typing_is_unpacked_typevartuple__F)rt rs r r s rw _is_unpacked_typevartupler s( At$
$
E A<e DFry c H t | t t f xs t | S r )rt r r r r s rw _is_typevar_liker s a'9- . N2KA2NNry c e Zd Z d Zy)_PickleUsingNameMixinc | j S r r r s rw r z _PickleUsingNameMixin.__reduce__ s }} ry N)r r r r r ry rw r r s
9 ry r c d}t ||d }t |t r|j t u s t |t
rt
|dd rt | d |S )N*Parameters to generic types must be types.T)r r Fr{ )r rt r} r~ rm r r r )r rv r s rw _typevar_substr sW
6C
c3D
1C C 'CNNf,D C &73+N3% =>?? Jry c |j }|j | }||dz d D ] }t |t st d| t | }t | }|}||z
dz
} d }
d } t
| D ]Q \ } }
t |
t rt |
dd }|s't | dk( s6|d du s>|
t d | }
|d } S |
t ||
}t | ||
z
dz
} n || z |kD rt d | d
| d |dz
g |d | | g||z
z t |||| z
| g|| z
|z
|z
dz
z ||| z
d S ) NrX z(More than one TypeVarTuple parameter in r r r .z6More than one unpacked arbitrary-length tuple argumentr Too few arguments for r z, expected at least ) r indexrt r
r r enumeraters r minr )r aliasr r typevartuple_indexparamr plenr] r^ var_tuple_indexfillargkrv r s rw _typevartuple_prepare_substr s
!
!F d+*Q./0 P e\ * Fug NO OP t9D v;D D % % )EOGD/ %3#t$ c#CTJG3w<1,1C".#$\]]"#!!*% "4 )E4/1A56
0 8##'&(<T!VHF G G
et )'$.
/ d4 &' )TE\D(+==A
B
dUlm ry c t |t t f rt d |D }|S t | st d| |S )Nc 3 4 K | ] }t |d yw)zExpected a type.NrU r r s rw r z#_paramspec_subst.<locals>.<genexpr> s D1K#56D zFExpected a list of types, an ellipsis, ParamSpec, or Concatenate. Got )rt r r r r r rv s rw _paramspec_substr sU #e}%DDD J C
::=@ A A Jry c |j }|j | }|t | k\ rt d| t | dk( rt |d s|f}|S t || t r g |d | t || ||dz d }|S )Nr rX r )r r r r r rt r r )r r r r is rw _paramspec_prepare_substr s
!
!F TACI~0899
6{atAw 7w K
DGT "7bq75a>7D1J7 Kry c t |t s|f}t d |D }| t t fv }|r|st d| j
d t
d |D st d| j d t t | t | k7 rt d| j d | j D ] }t |dd }| || | } t | |t | j g }t | j | D ]8 \ }}t |t r|j | (|j! | : t | }t# | | S ) Nc 3 2 K | ] }t | y wr rx r r s rw r z)_generic_class_getitem.<locals>.<genexpr>
s 4=#4r zParameter list to z[...] cannot be emptyc 3 2 K | ] }t | y wr )r r s rw r z)_generic_class_getitem.<locals>.<genexpr> s 71#A&7r zParameters to zF[...] must all be type variables or parameter specification variables.z[...] must all be unique__typing_prepare_subst__)rt r r r r r allr r r r r r zipr
r r r} )r r is_generic_or_protocolr preparenew_argsnew_args rw _generic_class_getitemr sz fe $
4V4
4F Wh$7 7 $S%5%5$66KL
777 /8 9:
: s6{ s6{ * .FGI
I '' .E e%?FG" f- . sFC(:(:$;< !#"4"4f = )NE7% .(( )
x f %%ry c
t t |
|i | g }d| j v rt | j v }n7t | j
v xr# | j dk7 xr t | t k7 }|r t d d| j v rt | j }d }| j D ]? }t |t s|j t u s'| t d |j }A |at | }t |
|
k sDdj!
fd|D }dj! d |D } t d| d | d
|}t# | | _ y ) N__orig_bases__r z!Cannot inherit from plain Genericz0Cannot inherit from Generic[...] multiple times.r c 3 > K | ] }|vst | y wr ru )r r gvarsets rw r z)_generic_init_subclass.<locals>.<genexpr>N s "MaAW<L3q6"Ms c 3 2 K | ] }t | y wr r )r gs rw r z)_generic_init_subclass.<locals>.<genexpr>O s "9a3q6"9r zSome type variables (z ) are not listed in Generic[r )r< r r rz r __bases__r rs _TypedDictMetar r rt r} r~ r r r r ) r r rE tvarserrorgvarsbasetvarsets_varss_argsr s @rw _generic_init_subclassr 0 sq '3)4:6: E3<<'3---CMM) 0LLJ.0I /
;<<3<<'#C$6$67 && ,D4 /OOw.$#JL L ++
, %jG%jGg% "M5"MM "95"99 "7x @::@!D E EE u Cry c J | j d xr | j d S )N__)
startswithendswith)attrs rw
_is_dunderr V s ??4 8T]]4%88ry c V e Zd Z ddddZd Zd Zd Z fdZd Zd
Z fd Z
xZ S ) _BaseGenericAliasTNinstrZ c < || _ || _ || _ d | _ y r )_instr r~ r )r originr rZ s rw r
z_BaseGenericAlias.__init__c s
ry c | j s0t d| j d| j j d | j |i |} | |_ |S # t $ r Y |S w xY w)NzType z cannot be instantiated; use z
() instead)r r r r~ r __orig_class__r )r r rE results rw r" z_BaseGenericAlias.__call__i s zzeDJJ< 0##'??#;#;"<J H I
I $1&1 $(F !
s A A&%A&c , g }| j |vr|j | j |j | }||dz d D ]. }t |t st |t s$ t | S |j t t | S )NrX )r~ r r rt r
issubclassr r )r r resr bs rw r z!_BaseGenericAlias.__mro_entries__t s ??% ' JJt ' KK qst A! ./:a3I Sz
JJw Szry c |dv r$| j xs | j j S d| j v r!t | st | j | S t
| )N> r r r~ )r r~ r rz r r r )r r s rw r z _BaseGenericAlias.__getattr__ sU / /::9 !9!9 9 4== (D1A4??D1 1 T""ry c t t | s|dv rt | || y t | j || y )N> r r _nparams)r r< __setattr__setattrr~ )r r valr= s rw r z _BaseGenericAlias.__setattr__ s2 d t'E E G c * DOOT3 /ry c 6 | j t | S r r2 rs r- s rw r. z#_BaseGenericAlias.__instancecheck__ %%d3i00ry c t d )NzBSubscripted generics cannot be used with class and instance checksr r1 s rw r2 z#_BaseGenericAlias.__subclasscheck__ s 5 6 6ry c t t t |
t | j
D cg c] }t
| r| c}z S c c}w r )r r r< __dir__dirr~ r r r r= s rw r z_BaseGenericAlias.__dir__ sJ C)$'$8QD
4@P4QR S T TQs AA) r r r r
r" r r r r. r2 r r? r@ s @rw r r Y s> (,$
#0 16T Try r c | e Zd Zddd fd
Zd Zd Zd Zd Zed Z d
Z
d Z d Z d
Z
d Z fdZd Z xZS )r} TNr c t | ||| t |t s|f}t d |D | _ t | | _ |s|j | _ y y )Nr c 3 4 K | ] }|t u rd n| yw).N)_TypingEllipsisr s rw r z)_GenericAlias.__init__.<locals>.<genexpr> s' /$% &'/%9c /r )r< r
rt r r r r r )r r r r rZ r= s rw r
z_GenericAlias.__init__ sc
d6$&7D /)- / /
1$ 7 $ / /DO ry c t |t st S | j |j k( xr | j |j k( S r )rt r} r r~ r r% s rw r z_GenericAlias.__eq__ s> % /! !5#3#33 4MMU^^3 5ry c D t | j | j f S r )r r~ r r s rw r z_GenericAlias.__hash__ s T__dmm455ry c t | |f S r r$ r r^ s rw r' z_GenericAlias.__or__ r( ry c t || f S r r$ r r] s rw r* z_GenericAlias.__ror__ T4Z ry c * | j t t fv rt d| | j st | d t |t s|f}t
d |D }t | }| j | }| j | }|S )Nz%Cannot subscript already-subscripted r c 3 2 K | ] }t | y wr r r s rw r z,_GenericAlias.__getitem__.<locals>.<genexpr> s 4!]1%4r )
r~ r r r r rt r r _determine_new_argsr )r r r rs rw r5 z_GenericAlias.__getitem__ s " ??w 1 1 CD6 JK K""tf$; <= = $&7D4t44D!++D1 NN8 $ry c
@ | j }|D ] }t |dd }| || | } t | }t | }||k7 r t d||kD rdnd d| d| d| t t || }t
| j | j | S )Nr r r r r r r ) r r r r dictr r _make_substitutionr )r r r r r r r new_arg_by_params rw r z!_GenericAlias._determine_new_args s $$ +E e%?FG" tT* + 4y6{ 4<dTD[6e"DOTXSY Z''+fKv ? @
@ FD 12T,,T]]<LMNNry c g }|D ]V }t |t r|j | &t |dd }|r ||| }nbt |dd }|s|}nPg }|D ]; } t | t r|j || (|j || = |t
| }| j t j j k( r"t |t r|j | t | r|j |
t |t r,|j t
| j || F|j | Y |S r )
rt rs r r r
r r r~ r r r r r )
r r r r old_arg substfuncr subparamsr r s
rw r z _GenericAlias._make_substitution sH 2 8 )G'4(( );TBI#$4W$=> #G-=r B %G G & @%a 6 #NN+;A+> ? #NN+;A+> ? @
&eGn 5G+//":"::z'SX?Y (*73 (GU+ $11';KLM (q8 )r ry c h | j | j || j | j S N)rZ r )r= r~ r r r r s rw r z_GenericAlias.copy_withT s% ~~doot$**4::~VVry c | j rd| j z }nt | j }| j r3dj | j D cg c]
}t | c} }nd}| d| dS c c}w )Nr r z()r r )r r r~ r r )r rZ r r s rw r z_GenericAlias.__repr__W sm :: tzz)D doo.D ==99T]] Cjm CDD Dqa Ds A;c | j rt | j }n | j }t | j }t | dk( rt
|d t s|\ }t j ||ffS )NrX r ) r globalsr~ r r r rt r r )r r r s rw r z_GenericAlias.__reduce__c sd :: Ytzz*F__FT]]# t9>*T!We"<ED &$ //ry c D t | j t rt d| | j rt
| | S | j t u r>t |v ry|j | }||dz d D ] }t |t s|| us y | j fS )Nr r rX ) rt r~ r r r r< r r r r r )r r r r r= s rw r z _GenericAlias.__mro_entries__m s doo| 4 .th 78 8 ::7*51 1 ??g %5 D!A1Q34[
a!23
!!ry c # " K t | y wr )rm r s rw r z_GenericAlias.__iter__| s Tls
)r r r r
r r r' r* r r5 r r r r r r r r? r@ s @rw r} r} s] 2 .2 05 6"! >O:<|W
!0
" ry r} c ^ e Zd Zddd fd
Zed Zd Zd Z fdZd Z d
Z
d Z xZ S ) _SpecialGenericAliasTNr c | |j }t | ||| || _ |j dk( rd|j
d| _ y d|j d|j
d| _ y )Nr r zA generic version of r| )r r< r
r r r r )r r nparamsr rZ r= s rw r
z _SpecialGenericAlias.__init__ sv <??D
d6
* 263F3F2GqIDL 263D3D2EQvGZGZF[[\]DLry c t |t s|f}dt fd|D }t | || j | j | S )Nr c 3 6 K | ] }t | y wr rU rV s rw r z3_SpecialGenericAlias.__getitem__.<locals>.<genexpr> ;q{1c*;rW )rt r r r r r r r s @rw r5 z _SpecialGenericAlias.__getitem__ sH &%( YF:;F;;tVT]]3~~f%%ry c \ t | j || j | j S r )r} r~ r r r r s rw r z _SpecialGenericAlias.copy_with s$ T__f"&**4::? ?ry c d| j z S r r r s rw r z _SpecialGenericAlias.__repr__ r ry c t |t r t |j | j S t |t st || j S t
| | S r )rt r r r~ r} r< r2 )r r r= s rw r2 z&_SpecialGenericAlias.__subclasscheck__ sN c/ 0 cnndoo> >#}- c4??3 3w(--ry c | j S r r r s rw r z _SpecialGenericAlias.__reduce__ r ry c t | |f S r r$ r s rw r' z_SpecialGenericAlias.__or__ r( ry c t || f S r r$ r s rw r* z _SpecialGenericAlias.__ror__ r ry )
r r r r
r r5 r r r2 r r' r* r? r@ s @rw r r s@ 044 ^ & &?&."!ry r c 0 e Zd Zddd fd
Z fdZ xZS )_DeprecatedGenericAliasTNr c : t | |||| || _ y )Nr )r< r
_removal_version)r r r removal_versionr rZ r= s rw r
z _DeprecatedGenericAlias.__init__ s# t$? / ry c dd l } |j | j d| j | j t
| | S )Nr r| )r )warnings _deprecatedr r r! r< r. )r r r$ r= s rw r. z)_DeprecatedGenericAlias.__instancecheck__ sG q -d6K6K
w(..ry )r r r r
r. r? r@ s @rw r r s 8<40 / /ry r c $ e Zd Z fdZd Z xZS )_CallableGenericAliasc | j }t | dk( r t |d rt | S ddj |d d D cg c]
}t
| c} dt
|d dS c c}w )Nr r ztyping.Callable[[r r z], r )r r r r< r r r )r r r r= s rw r z _CallableGenericAlias.__repr__ sy }} t9>nT!W 57#% %YYtCRy A!
1
ABC3 d2h'(+ , As A6
c | j }t | dk( rt |d st |d d |d f}t j
t |ffS )Nr r r )r r r r r r r r s rw r z _CallableGenericAlias.__reduce__ sO }}D Q>$q'#:Sb ?DH,D (D!111ry )r r r r r r? r@ s @rw r' r' s
,2ry r' c ( e Zd Zd Zd Zed Zy)
_CallableTypec \ t | j || j | j S r )r' r~ r r r s rw r z_CallableType.copy_with s& $T__f*.**4::G Gry c t |t rt | dk7 r t d |\ }}t |t rt | |f}n||f}| j | S )Nr z6Callable must be used as Callable[[arg, ...], result].)rt r r r r __getitem_inner__)r r r r s rw r5 z_CallableType.__getitem__ sf &%(CK1,< < =
= f dD !Dk6*FF^F%%f--ry c |\ }}d}t || }|t u r| j t |f S t |t
s|f}t d |D }||fz }| j | S )Nz.Callable[args, result]: result must be a type.c 3 2 K | ] }t | y wr r r s rw r z2_CallableType.__getitem_inner__.<locals>.<genexpr> s 8C]3'8r )r Ellipsisr r rt r )r r r r r s rw r. z _CallableType.__getitem_inner__ st f> VS) 8 >>?F";< <$&7D8488 !~~f%%ry N)r r r r r5 r r. r ry rw r+ r+ s! G .
&
&ry r+ c e Zd Zed Zy)
_TupleTypec t |t s|f}t | dk\ r:|d du r3dt fd|d d D }| j g |t S dt fd|D }| j | S )Nr r .z Tuple[t, ...]: t must be a type.c 3 6 K | ] }t | y wr rU rV s rw r z)_TupleType.__getitem__.<locals>.<genexpr> s D1;q#.DrW z*Tuple[t0, t1, ...]: each t must be a type.c 3 6 K | ] }t | y wr rU rV s rw r z)_TupleType.__getitem__.<locals>.<genexpr> r rW )rt r r r r r s @rw r5 z_TupleType.__getitem__ s &%( YF v;! r
c 14CDs DDF>>"<F"<O"<= =:;F;;~~f%%ry N)r r r r r5 r ry rw r3 r3 s & &ry r3 c F e Zd Zd Zd Zd Z fdZd Zd Z fdZ xZ
S )r c t | S r r$ r s rw r z _UnionGenericAlias.copy_with s V} ry c t |t t j f st S t | j t |j k( S r )rt r r r r r r r% s rw r z_UnionGenericAlias.__eq__ s9 %"4eoo!FG! !4==!S %888ry c > t t | j S r )r frozensetr r s rw r z_UnionGenericAlias.__hash__ s Idmm,--ry c | j }t | dk( rD|d t d u rdt |d dS |d t d u rdt |d dS t | S )Nr r ztyping.Optional[rX r )r r rs r r< r r r r= s rw r z_UnionGenericAlias.__repr__ sw }} t9>Aw$t*$)*T!W*=)>a@@aDJ&)*T!W*=)>a@@w !!ry c 6 | j t | S r r r- s rw r. z$_UnionGenericAlias.__instancecheck__ r ry c B | j D ] }t || s y y NT)r r )r r rv s rw r2 z$_UnionGenericAlias.__subclasscheck__ s" == C#s# ry c @ t | \ }\ }}|t |ffS r )r< r r )r r r r r= s rw r z _UnionGenericAlias.__reduce__ s( $w 1 3 nvteT]""ry ) r r r r r r r r. r2 r r? r@ s @rw r r s+ 9
."1
# #ry r c d | D S )Nc 3 6 K | ] }|t | f y wr )rs r s rw r z'_value_and_type_iter.<locals>.<genexpr>" s -QQQL -s r )r s rw rd rd ! s
-* --ry c e Zd Zd Zd Zy)r c t |t st S t t | j
t t |j
k( S r )rt r r r rd r r% s rw r z_LiteralGenericAlias.__eq__& s? %!56! !'
673?STYTbTb?c;dddry c P t t t | j S r )r r; rd r r s rw r z _LiteralGenericAlias.__hash__, s I 24== ABCCry N)r r r r r r ry rw r r % s e Dry r c e Zd Z fdZ xZS )r c t |d t t f r
g |d d |d S t |d t rg |d d |d j }t
| | S )Nr )rt r r r r r< r )r r r= s rw r z"_ConcatenateGenericAlias.copy_with1 sm fRj4- 0.VCR[.6":. . fRj": ;9vcr{9VBZ%8%89Fw ((ry )r r r r r? r@ s @rw r r 0 s
) )ry r c > t || d }t | |f S )NrN )r r )r _UnpackGenericAliasrP s rw rm rm 9 s- ,Z zdV+E#F GD d$ 99ry c D e Zd Zd Z fdZed Zed Z xZS )rJ c : dt | j d dS )Nztyping.Unpack[r r )r r r s rw r z _UnpackGenericAlias.__repr__m s"
4==+; < =Q??ry c > | j r|S t | | S r )r r< r5 r= s rw r5 z _UnpackGenericAlias.__getitem__r s! 3 3Kw"4((ry c X | j \ }t |t r |j S y r )r rt r} r s rw r z2_UnpackGenericAlias.__typing_unpacked_tuple_args__w s& }} c= )<< ry c < t | j d t S Nr )rt r r
r s rw r z7_UnpackGenericAlias.__typing_is_unpacked_typevartuple__ s $--*L99ry ) r r r r r5 propertyr r r? r@ s @rw rJ rJ l s6 @
)
: :ry rJ c e Zd Zy)r N)r r r r ry rw r r s 2ry r > _is_protocolr r r __type_params____protocol_attrs___is_runtime_protocol __callable_proto_members_only__> r rC rz r
r r r __annotations____subclasshook____class_getitem____abstractmethods___MutableMapping__markerc t }| j d d D ]` }|j dv rt |di }g |j |D ]. }|j d r|t vs |j | 0 b |S )Nr > r r rX _abc_)r __mro__r r rz r EXCLUDED_ATTRIBUTESadd)r attrsr annotationsr s rw _get_protocol_attrsrd s
EE CR == 3 3 d$5r: 2dmm2k2 D??7+<O0O $ Lry c H t | }|j r t d |j t ury |j
D ]3 }|j j dt }|t us,||_ n t j |_ |j | g|i | y )Nz Protocols cannot be instantiatedr
) rs rS r r
_no_init_or_replace_initr_ rz r} object)r r rE r r inits rw rf rf s
t*C
:;; ||33 '}} -EF / / CL ' CLL'''ry rX c t j | dz xs |S # t $ r Y nw xY w t j | dz j j d| S # t t f$ r Y y w xY w)NrX r )r{ _getframemodulenamer _getframe f_globalsr}
ValueError)depthdefaults rw _callerrp sx
&&uqy1<W<
}}UQY'1155j'JJ J '
s **1A A21A2r c t | dv S )N> Nr r )rp )rn s rw _allow_reckless_class_checksrr s
5> 7 77ry ) r r0 r% r& r2 r# r. r! r4 r7 BufferAbstractContextManagerAbstractAsyncContextManager)zcollections.abc
contextlibc ddl m} | S )Nr getattr_static)inspectry rx s rw _lazy_load_getattr_staticr{ s
' ry c ( t | j ffS r )r r~ )psargss rw _pickle_psargsr~ s 6,,. ..ry c ( t | j ffS r )r r~ )pskwargss rw _pickle_pskwargsr s X 0 0 2 22ry c < e Zd Z fdZ fdZ fdZ fdZ xZS )
_ProtocolMetac 6 |dk( r |t fk( rnvt |v rn|D ]i }|t t hv r|j t j |j g v r?t |t rt |dd r]t d| t | , | |||fi |S )Nr rS Fz5Protocols can only inherit from other protocols, got ) r r rg r _PROTO_ALLOWLISTr} r r r r r< rC )mclsrZ r namespacerE r r= s rw rC z_ProtocolMeta.__new__ s : %G:"5
VW --}}(8(<(<T__b(QQ"41 #D.% @ $ #h(
wtT5)FvFFry c t |i | t dd r4t _ t fd j D _ y y )NrS Fc 3 J K | ] }t t |d y wr )callabler )r r r s rw r z)_ProtocolMeta.__init__.<locals>.<genexpr> s$ 67;dD126s #)r< r
r rd rU r rW rD s ` rw r
z_ProtocolMeta.__init__ sU
$)&) 3 .%8%=C " 36 6?B?U?U6 3C / /ry c b | t u rt j | | S t | dd rut skt |t s t
d | j s,| j j d t u r t
d t | dd s t
d t | | S )NrS Fz"issubclass() arg 1 must be a classrY z<Protocols with non-method members don't support issubclass()rV LInstance and class checks can only be used with @runtime_checkable protocols) r rs r2 r rr rt r rW rz r} _proto_hookr< )r r& r= s rw r2 z _ProtocolMeta.__subclasscheck__ s (?))#u5 5 C /02 eT* DEE77LL$$%78KG R 3 6> 3 w(//ry c ~ | t u rt j | | S t | dd st | | S t | dd st s t
d t | | ryt }| j D ]' } ||| }|t t | |d s' y y# t $ r Y yw xY w)NrS FrV r T) r rs r. r r< rr r r{ rU r r )r instancery r r r= s rw r. z _ProtocolMeta.__instancecheck__6 s (?))#x8 8sNE27,X6 6 3U;,. < =
= 7 $X .24** D
$Xt4 {xT4(@ A "
s B// B<;B<)r r r rC r
r2 r. r? r@ s @rw r r s G&00 ry r c | j j dd st S | j D ] }|j D ] }||j v r|j |
t c c S ;t |di }t
|t j j s^||v sct |t stt |dd s t c S y)NrS FrX T) rz r} r rU r_ r rt r r r( r r )r r& r r rc s rw r r W s << NE 2 && "MM "Dt}}$==&.)) "$(92>K; (?(?@K' ug.75.RW3X " " ! " ry c , e Zd Z dZdZdZ fdZ xZS )r r TFc : t | |i | | j j dd s!t d | j
D | _ d| j vr t | _ | j r)| j t j u r t | _ y y y )NrS Fc 3 , K | ] }|t u y wr r r r s rw r z-Protocol.__init_subclass__.<locals>.<genexpr> s "HQ1="Hs rY ) r< r rz r} anyr rS r rY r
r rf rD s rw r zProtocol.__init_subclass__ s
!4262 || 6 ""H#--"H HC S\\ 1#.C 0A0A A3CL !B ry )r r r r rS rV r r? r@ s @rw r r o s% @ IL
4
4ry r c N e Zd Z fdZd Zd Zd Zd Zd Z fdZ d Z
xZ S ) _AnnotatedAliasc t |t r|j |z }|j }t | ||d || _ y )Nr rY )rt r __metadata__r~ r< r
)r r metadatar= s rw r
z_AnnotatedAlias.__init__ sD fo . **X5H&&F
k: $ry c 8 |d }t || j S rP )r r )r r new_types rw r z_AnnotatedAlias.copy_with s !9 x):):;;ry c dj t | j dj d | j D S )Nztyping.Annotated[{}, {}]r c 3 2 K | ] }t | y wr )r r s rw r z+_AnnotatedAlias.__repr__.<locals>.<genexpr> s 9!d1g9r )formatr r~ r r r s rw r z_AnnotatedAlias.__repr__ s9 )00 t ' II9t'8'89 9
ry c b t j t | j f| j z ffS r )r r r r~ r r s rw r z_AnnotatedAlias.__reduce__ s1 )D,=,=="
ry c t |t st S | j |j k( xr | j |j k( S r )rt r r r~ r r% s rw r z_AnnotatedAlias.__eq__ sB % 1! !5#3#33 <%%););; =ry c D t | j | j f S r )r r~ r r s rw r z_AnnotatedAlias.__hash__ s T__d&7&7899ry c , |dv ryt | | S )N> r r r )r< r r s rw r z_AnnotatedAlias.__getattr__ s / / w"4((ry c | j fS r )r~ r s rw r z _AnnotatedAlias.__mro_entries__ s !!ry ) r r r r
r r r r r r r r? r@ s @rw r r s0 %<
= :)
"ry r c . e Zd Z dZd Zed Zd Zy)r r c t d )Nz&Type Annotated cannot be instantiated.r r r rE s rw rC zAnnotated.__new__
s @AAry c t |t rt | dk r t d t |d r t d d}t |d |d }t |dd }t
|| S ) Nr zUAnnotated[...] should be used with at least two arguments (a type and an annotation).r z?Annotated[...] should not be used with an unpacked TypeVarTuplez$Annotated[t, ...]: t must be a type.Trn rX )rt r r r r r r )r r r r r s rw rZ zAnnotated.__class_getitem__
s| &%(CK!O + ,
, %VAY / 4 5
54 VAYF$ vx00ry c J t dj | j )Nz Cannot subclass {}.Annotated)r r r r s rw r zAnnotated.__init_subclass__ s! * 1 1#.. A
ry N)r r r r rC r rZ r r ry rw r r s. -^ IB 1 1
ry r c l t | t r
t | dd st d| z d| _ | S )NrS FzB@runtime_checkable can be only applied to protocol classes, got %rT)r r r r rV )r s rw rg rg ! sE $ c7 #73+N "$'( ) ) #C Jry c |S r r )r r s rw rS rS ; s Jry c | S r r )r r s rw rQ rQ F s Jry c V t | dd ri S t | t r4i }t | j D ] }|6t t
j j |j d di }n|}|j j di }t |t j ri }|t t | n|}||||}}|j D ]B \ } }
|
t d }
t |
t rt! |
dd }
t# |
|| }
|
|| < D |r|S |j D ci c] \ } } | t% | c} } S |`t | t j& r
| j }n4| }
t) |
d r|
j* }
t) |
d rt |
di }||}n||}t | dd }|,t | t, ri S t/ d j1 | t | }|j D ]Y \ } }
|
t d }
t |
t r't! |
t | t j& d }
t# |
|| || < [ |r|S |j D ci c] \ } } | t% | c} } S c c} } w c c} } w )
N__no_type_check__rz rX FT)r rr __wrapped__ __globals__z1{!r} is not a module, class, method, or function.)r rt rs reversedr_ r{ r| r} r rz r GetSetDescriptorTyper varsitemsru r r _strip_annotations
ModuleTyper r _allowed_typesr r )r r r include_extrashintsr base_globalsann base_localsrZ valuer r nsobjs rw rZ rZ [ s < s'. #t S[[) $D &s{{t'Mz[] ^ ' --##$5r:C#u 9 9:.5o$tDz*7K8#3 -8 k "yy{
$ e= JE eS) &u%$ OE"5, D #d
$# $0 'u`RWR]R]R_,`$!QQ0B10E-E,`` c5++ ,||HE% / )) % / umR8H ? G C*D 1E } c> *I ++16#;8
8 KE {{} ; e =JE eS ! *30@0@ A A E
!':d ; #5\ekkm(\da,>q,A)A(\\I -aH )]s <J J%c t | t rt | j S t | d r0| j t
t fv rt | j d S t | t r>t d | j D }|| j k( r| S | j | S t | t rCt d | j D }|| j k( r| S t | j | S t | t j rQt d | j D }|| j k( r| S t j t j" | S | S )Nr~ r c 3 2 K | ] }t | y wr r r s rw r z%_strip_annotations.<locals>.<genexpr> H 0 3 Hr c 3 2 K | ] }t | y wr r r s rw r z%_strip_annotations.<locals>.<genexpr> r r c 3 2 K | ] }t | y wr r r s rw r z%_strip_annotations.<locals>.<genexpr> r r )rt r r r~ r re rb r r} r r r r r r r r r )r
stripped_argss rw r r s 2!_%!!,,//q, ALLX{4K$K!!**Q-00!]# HQZZ HH
AJJ &H{{=))!\" HQZZ HH
AJJ &HALL-88!U__% HQZZ HH
AJJ &H m<< Hry c t | t rt S t | t t t
t f r | j S | t u rt S t | t j rt j S y r ) rt r r r r r r r~ r r r tps rw rX rX sc "o&"(,$o7 8}} W}"eoo& ry c , t | t r| j f| j z S t | t t
f r-| j }t | | rt |d d |d f}|S t | t j r | j S y)Nr r ) rt r r~ r r} r r r r r r )r r s rw rW rW s "o&
"//11"}l34kk *2s 3CR>3r7+C
"eoo&{{
ry c $ t | t S r )rt r r s rw r[ r[
s
b. ))ry d rv c r t | }t | t kD r |d t dz }t d| )Nr z*Expected code to be unreachable, but got: )r r _ASSERT_NEVER_REPR_MAX_LENGTHAssertionError)rv r s rw rR rR sE $
IE
5z11445=
EeWM
NNry c t | t rt | D ] }t | | }t |d rB|j
| j
d|j k7 st |dd | j k7 r^t |t j rd|_
t |t j rd|j _
t |t st | d| _
| S # t $ r Y | S w xY w)Nr r| r T)rt rs r r r r r r r r r
MethodType__func__r_ r )rv keyr s rw r_ r_ 8 s #t s8 #C#s#CC 0###*:*:);1S\\N'KK3 d3s~~E
#u 1 12(,%#u / /015 .#t$ c"% #&
$ J
J
s &C/ / C<;C<c D t j fd }|S )Nc . | i |}t | }|S r )r_ )r r r r s rw wrapped_decoratorz2no_type_check_decorator.<locals>.wrapped_decoratorb s! $'$' T" ry )r r )r r s ` rw r` r` \ s-
__Y
ry c t d )NzYou should not call an overloaded function. A series of @overload-decorated functions outside a stub module should always be followed by an implementation that is not @overload-ed.)NotImplementedError)r r s rw _overload_dummyr k s 4
9 : :ry c t | d| } | t |j |j |j j
< t S # t $ r Y t S w xY wNr )r _overload_registryr r __code__co_firstlinenor r )r fs rw rc rc x se > j$'A
VZ1<<( 89R9RS
s 7A
A A c t | d| }|j t vrg S t |j }|j |vrg S t ||j j S r )r r r r r values)r r mod_dicts rw rY rY sa @j$'A||-- !!,,/H~~X% (//1 22ry c . t j y r )r clearr ry rw rT rT s . ry c D d| _ | S # t t f$ r Y | S w xY wr@ ) __final__r r )r s rw rV rV s: 2
H
I &
H
TKTVTT_co) covariantV_coVT_coT_contra)
contravariantCT_co)r boundrP a Deprecated alias to collections.abc.Callable.
Callable[[int], str] signifies a function that takes a single
parameter of type int and returns a str.
The subscription syntax must always be used with exactly two
values: the argument list and the return type.
The argument list must be a list of types, a ParamSpec,
Concatenate or ellipsis. The return type must be a single type.
There is no syntax to indicate optional or keyword arguments;
such function types are rarely used as callback types.
r rY )r )r" r r r a] Deprecated alias to builtins.tuple.
Tuple[X, Y] is the cross-product type of X and Y.
Example: Tuple[T1, T2] is a tuple of two elements corresponding
to type variables T1 and T2. Tuple[int, float, str] is a tuple
of an int, a float and a string.
To specify a variable-length tuple of homogeneous type, use Tuple[T, ...].
rD rA rF rG r" r6 rB rC r a Deprecated alias to builtins.type.
builtins.type or typing.Type can be used to annotate class objects.
For example, suppose we have the following classes::
class User: ... # Abstract base for User classes
class BasicUser(User): ...
class ProUser(User): ...
class TeamUser(User): ...
And a function that takes a class argument that's a subclass of
User and returns an instance of the corresponding class::
def new_user[U](user_class: Type[U]) -> U:
user = user_class()
# (Here we could write the user object to a database)
return user
joe = new_user(BasicUser)
At this point the type checker knows that joe has type BasicUser.
c ( e Zd Z dZedefd Zy)r= r r c y r r r s rw __int__zSupportsInt.__int__N
ry N)r r r r r intr r ry rw r= r= H
s# 2I
ry r= c ( e Zd Z dZedefd Zy)r; r r c y r r r s rw __float__zSupportsFloat.__float__Y
r ry N)r r r r r floatr r ry rw r; r; S
# 4I
5
ry r; c ( e Zd Z dZedefd Zy)r: r r c y r r r s rw __complex__zSupportsComplex.__complex__d
r ry N)r r r r r complexr r ry rw r: r: ^
s# 6I
W
ry r: c ( e Zd Z dZedefd Zy)r9 r r c y r r r s rw __bytes__zSupportsBytes.__bytes__o
r ry N)r r r r r bytesr r ry rw r9 r9 i
r ry r9 c ( e Zd Z dZedefd Zy)r< r r c y r r r s rw __index__zSupportsIndex.__index__z
r ry N)r r r r r r r r ry rw r< r< t
s# 4I
3
ry r< c > d xf G fdd
} t | S )r c 2 e Zd ZW Z dZedW fd Zy)r8 r r c y r r r s rw __abs__zSupportsAbs.__abs__
r ry N)r r r rT r r r
.type_paramsr s rw r8 r8
s$ WI
ry r8 r
.generic_baser r s @@rw #<generic parameters of SupportsAbs>r
s
X
ry c > d xf G fdd
} t | S )r c 8 e Zd ZW Z dZeddedW fd Zy)r> r ndigitsr c y r r )r r s rw __round__zSupportsRound.__round__
r ry Nr )r r r rT r r r r r s rw r> r>
s+ YI
Q
ry r> r r s @@rw %<generic parameters of SupportsRound>r
s
x
ry r c |D cg c] \ }}| }}}|D ci c] \ }}|t |d| d }}}t j | ||| }|x|_ |j _ |S c c}}w c c}}w )Nzfield z annotation must be a typedefaultsrq )r r
namedtuplerX rC )rZ r rq r nr fieldsnm_tpls rw
_make_nmtupler!
s !
"DAqa
"F
"
A As*D EF
F
E
#
#D&-5fFF>CCFV^^ ; M
#
s
A+A1>
_makerC _asdict_fields_sourcer
_replacer __getnewargs___field_defaults> r r rX c e Zd Zd Zy)NamedTupleMetac |D ] }|t us |t ust d t d |D }|j di }g }|D ]M }||v r|j | |s t d| dt
| dkD rdnd d d
j | t | |j |D cg c] }|| c}|d } || _
t |v rt }
t |
| _
|D ]@ } | t v rt d
| z | t vs"| | j" vs1t% | | || B t |v r| j' | S c c}w )Nz3can only inherit from a NamedTuple type and Genericc 3 < K | ] }|t u rt n| y wr ) _NamedTupler )r r s rw r z)NamedTupleMeta.__new__.<locals>.<genexpr>
s Ot{ 2e<O rX z Non-default namedtuple field z cannot follow default fieldrX sr r r r z&Cannot overwrite NamedTuple attribute )r- r r r r} r r r r! r r r classmethodrZ _prohibitedr _specialr$ r r ) r typenamer nsr r
default_names
field_namer r
class_getitemr s rw rC zNamedTupleMeta.__new__
s KD;&4w+> IK K K OOO("-
?JR $$Z0 "?
| L>*-m*<q*@3b"I#'99]#;"<!> ? ? ? x 8E(F1A(F&( &68 ! e 2M'2='AF $ .Ck!$%MPS%STTH$FNN)BRW- .
e $ $ &
)Gs 6 E N)r r r rC r ry rw r* r*
s ry r* c ||j }n
|r t d t | |t }t f|_ |S )NzIEither list of fields or keywords can be provided to NamedTuple, not bothrq )r r r! rp rH r )r4 r rE nts rw rH rH
sP & ~ C D D x :B#
B
Iry rH c t fS r )r- r s rw _namedtuple_mro_entriesr>
s
>ry c " e Zd ZddZeZd ZeZy)r c
|D ]' }t | t us|t us t d t d |D rt f}nd}t j t |g |t | }t |d s||_ i }|j di } d}
| j D ci c] \ } } | t | |
|j } } } t }
t }|D ] }|j |j j di |
j |j j dd |j |j j d d |j | | j D ] \ }}t! | }|t" u r t% | }|r|d
}t! | }|t& u r|
j) | P|t* u r|j) | j|r|
j) | ~|j) | ||_ t/ |
|_ t/ | |_ t |d s||_ |S c c} } w ) NzHcannot inherit from both a TypedDict type and a non-TypedDict base classc 3 < K | ] }t |t y wr )r r r s rw r z)_TypedDictMeta.__new__.<locals>.<genexpr>
s 5!z!W%5r. r r rX z?TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a typer: __required_keys____optional_keys__r __total__)rs r r r r rC r r r r} r r r r updaterz rX r rW re ra rb rX r; rB rC rD )r rZ r r5 totalr generic_basetp_dictrc own_annotationsr r r
required_keys
optional_keysannotation_keyannotation_typeannotation_originannotation_argss rw rC z_TypedDictMeta.__new__
sZ BDDz /D4G !A B B B
5u5 5 #:L L,,~t5J|5JT5JBOw 01%*G " &&!2B7O )..0
2
{2s7+=+=> >
MD t}} 0 01BB G H !2!23F!K L !2!23F!K L M
?+/>/D/D/F 2 +NO *? ; I-"*?";"&5a&8O(2?(C% H, !!.1"k1 !!.1 !!.1 !!.1 2" #. $-m$<!$-m$<!w , %G G
s +#Ic t d )Nz4TypedDict does not support instance and class checksr )r r& s rw r2 z _TypedDictMeta.__subclasscheck__3 s NOOry N)T)r r r rC r r" r2 r. r ry rw r r
s =~ HP *ry r rF c ||}n
|r t d |r t j dt d dt | i}t }|||d< t
| d|| }t f|_ |S ) Nz@TypedDict takes either a dict or keyword arguments, but not bothzThe kwargs-based syntax for TypedDict definitions is deprecated in Python 3.11, will be removed in Python 3.13, and may not be understood by third-party type checkers.r
stacklevelrX r r rQ ) r r$ warnDeprecationWarningr rp r rI r )r4 r rF rE r5 rq tds rw rI rI : s -\ ~ ( ) )
7
T&\ *B
YF
!< "b 6B" B
Iry rI c t fS r )
_TypedDictr= s rw <lambda>rZ s :- ry c P t || j d }t | |f S Nz accepts only a single type.r r r} rP s rw re re s0 $ zdjj\1M#N OD w ''ry c P t || j d }t | |f S r\ r] rP s rw rb rb s0 zdjj\1M#N OD w ''ry c 6 e Zd Z eZd Zd Zd Zd Zd Z d Z
y)r^ c || _ d|v r|j d d }|| _ || _ t }|dk7 r|| _ y y )Nr| r typing)r
rpartitionr
__supertype__rp r )r rZ r def_mods rw r
zNewType.__init__ sN $;??3'+D
) h %DO ry c : | j G fdd }|fS )Nc e Zd Z fdZy)&NewType.__mro_entries__.<locals>.Dummyc F | j }t d| d|d d )NzGCannot subclass an instance of NewType. Perhaps you were looking for: `z = NewType(r z)`)r r )r
subclass_namesuperclass_names rw r z8NewType.__mro_entries__.<locals>.Dummy.__init_subclass__ s: #
%k-1B"_DUUWY ry N)r r r r )rj s rw Dummyrg s
ry rk r )r r rk rj s @rw r zNewType.__mro_entries__ s! -- xry c 8 | j d| j S )Nr| )r r r s rw r zNewType.__repr__ s //"!D$5$5#677ry c | j S r )r r s rw r zNewType.__reduce__ s ry c t | |f S r r$ r% s rw r' zNewType.__or__ r( ry c t || f S r r$ r% s rw r* zNewType.__ror__ r+ ry N) r r r r
r" r
r r r r' r* r ry rw r^ r^ s, * H&
8!""ry r^ c e Zd Z dZeedefd Zeedefd Zed d Z eede
fd Z ede fd Z
ed d Zede
fd
Zed!d e defd Zede
fd
Zed!de defd Zed!de dee fd Zed"de de de fd Zede
fd Zede fd Zed#de de fd Zede
fd Zedede fd Zed ee ddfd Z ed$d Z ed d Z y)%rL r r c y r r r s rw modezIO.mode
ry c y r r r s rw rZ zIO.name
rs ry Nc y r r r s rw closezIO.close r ry c y r r r s rw closedz IO.closed rs ry c y r r r s rw filenoz IO.fileno r ry c y r r r s rw flushzIO.flush r ry c y r r r s rw isattyz IO.isatty r ry r c y r r )r r s rw readzIO.read$ r ry c y r r r s rw readablez IO.readable( r ry limitc y r r )r r s rw readlinez IO.readline, r ry hintc y r r )r r s rw readlinesz IO.readlines0 r ry offsetwhencec y r r )r r r s rw seekzIO.seek4 r ry c y r r r s rw seekablez IO.seekable8 r ry c y r r r s rw tellzIO.tell< r ry sizec y r r )r r s rw truncatez IO.truncate@ r ry c y r r r s rw writablez IO.writableD r ry r/ c y r r r r/ s rw writezIO.writeH r ry linesc y r r )r r s rw
writelinesz
IO.writelinesL r ry c y r r r s rw __enter__z IO.__enter__P r ry c y r r )r rs r tracebacks rw __exit__z IO.__exit__T r ry )r N)r r r )r z
IO[AnyStr]) r r r r rQ r ru rr rZ rv boolrx r rz r| r~ rP r r r rD r r r r r r r r r r r ry rw rL rL sd
I
c
c
c
6
$
c
6
c
4<
3
C
$
c
S
C
$
v
#
V
ry rL c H e Zd Z dZedeeef defd Z edd Z
y)rK r r/ r c y r r r s rw r zBinaryIO.write^ r ry c y r r r s rw r zBinaryIO.__enter__b r ry N)r rK ) r r r r r r r bytearrayr r r r ry rw rK rK Y sH ?I
uUI -.
3
ry rK c e Zd Z dZeedefd Zeedefd Z eede
e fd Z eede fd Z
eedefd Zed
d Zy ) rO r r c y r r r s rw bufferz
TextIO.bufferl rs ry c y r r r s rw encodingzTextIO.encodingq rs ry c y r r r s rw errorsz
TextIO.errorsv rs ry c y r r r s rw line_bufferingzTextIO.line_buffering{ rs ry c y r r r s rw newlineszTextIO.newlines rs ry c y r r r s rw r zTextIO.__enter__ r ry N)r rO )r r r r rQ r rK r ru r r r r r r r r r ry rw rO rO g s =I
#
#
ry rO c e Zd Z fdZ xZS )_DeprecatedTypec |dvrD|| j v r6t j | j d| j dt d t
| | S )N)rz r z5 is deprecated, import directly from typing instead. z will be removed in Python 3.12.r rS )rz r$ rU r rV r< __getattribute__)r rZ r= s rw r z _DeprecatedType.__getattribute__ s^ 1 1dcll6J MM<<. !((+ ~ 6"" #
w'--ry )r r r r r? r@ s @rw r r s
. .ry r c " e Zd Z g dZeZeZeZy)io)rL rO rK N)r r r __all__rL rO rK r ry rw r r s 3*G B
FHry r z.ioc e Zd Z ddgZeZeZy)rerN rM N)r r r r rN rM r ry rw r r s 0'"GG Ery r z.rec d x}fd|d|fdcS )r r r c j t dt | j t j | S )NzRuntime type is )file)printrs r r{ stderrr s rw rf rf s/
T#Y / / 2
3#**E Jry r ) .defaultsr s rw #<generic parameters of reveal_type>r s ry c * e Zd ZW fd Z Zy)_IdentityCallablec " d x}fd|d|fdcS )r rv r c y r r r s rw r" z_IdentityCallable.__call__ s ry r )r r
__classdict__s rw z <generic parameters of __call__>z2_IdentityCallable.<generic parameters of __call__> s q ry N)r r r r" __classdictcell__)r s @rw r r s
ry r )
eq_default
order_defaultkw_only_defaultfrozen_defaultfield_specifiersr r r r r .rE c ( fd}|S )Nc $ d| _ | S )N)r r r r r rE )__dataclass_transform__) cls_or_fnr r r r rE r s rw r z&dataclass_transform.<locals>.decorator
s' $ * . , 0
-
) ry r )r r r r r rE r s `````` rw rU rU s =| ry _Funcc t dt f S r )r r r ry rw r r
s Xc3h
ry c $ d d x}fd|d|fdcS )Fc t S r )r r ry rw r r !
s Xry methodr c D d| _ | S # t t f$ r Y | S w xY wr@ ) __override__r r )r s rw rd rd !
s; 0
" M
I &
M
r r )r r s rw <generic parameters of override>r !
s X q ry r r )rX __main__)r )NNF)r )r r r r r collections.abccopyregrv r r r stdlib_rer{ r r$ r r r r _typingr
r r r
r r r r r rx r r r r r r r r r r r r r r; r r r r r7 rs r: r ra r] rh r\ r r r r_ r r rk r rl r r r r r r r r r r r r r r} r r r' r+ r3 r rd r r rm rJ r _TYPING_INTERNALS_SPECIAL_NAMESr` rd rf rp rr r r r{ r r r~ pickler r r1 r r r r rg rS rQ r BuiltinFunctionTyper r r rZ r rX rW r[ r rR r_ r` r partialr r rc rY rT rV r r r r r r r r r ru rP _aliasr# r0 r3 r2 r1 r% r& r7 r. r! r4 r r rF r r, r( r* r- r+ r r r r rD dequerA r rG r) r' r$ r/ rt r" ru r6 rB rC rE r@ r? rJ r5 r r= r; r: r9 r< r8 r> r! r2 r3 r* rH rC r- r> r r rI rY re rb r^ ri rj rL rK rO r r r r| rN rM rf r rU r rd r ry rw <module>r s * ( #
^ ^ o l5 PU B@
(2 <
<
'
U < 6?[
DF F ((/6<t (/V0,d 0 "t "5H 5$ 4 4( 4 40 4 4& 4 44 ( (* ( (* )0 )0V " "
2 2B
4
4 6 62 .( .(bQDt QDhF F F
O O O "J -& -&`#&L9@Td @T\V%T Vz)!<):$ )!X / 2$ / 2L-t 2" &( &B &%T & # }D #D.D= D)}D ) /: /:d:-t :83 3 (.8<U;VV "(: 8 ,-JK
*66 7/ }n -3 0 1$VG Vr
.24w- 24j1"lM 1"hF
F
R4
$$e&?&?""E$4$4'):<PR
`]F
2:2 * !$ Oe O5 O2!H : !!2!2!2;!EF &R 3
!
N CL T] T]v&v&4( :T 24t4
5# &
+//**A . ;??,,a 0 ;??,,a 0 {44a8
{44a8
+//**A . +//**A .
KOO..
2
{$$a( ;??,,a 0
KOO..
2
111 5 [__((!-@
KOO..
2
((!
, 66: +//**A . 88!<
$OO 7
5"5w7
dAE/{ !'2 S!%e, 9ae+ > [__00!4 +//**A . ;??,,a 0
KOO..
2
991CST Z C CQMbc
dAE/[,,amD [,,a0
$$a
( +&& * ;??,,a 0 66:
dAE/ 2
(
H
h
H
H
D E B C!T !H: ll><R@ 5
F*T F*RE EN \\.+r2
>
7 ( (. ( ($;" ;"~
`
`
F
r%y
RW
F
.d
.? BKK
""A
&y"? BKK & ! CE
QQ Q Q
Q DIc(: :C ?@
Q Q Qh ry 
Browse
Usage
Versions