B `@sLddlZddlZddlZddlZddlZddlmZddlZddlmZm Z m Z m Z ej dddkZ e rteZZnddlmZmZdZyddlmZmZmZWnek rdZYnXydd lmZdZWnek rdZYnXydd lmZWnek rd d ZYnXydd lmZmZWn2ek r^GdddZGdddZYnXddZddZeedrejZnddZeedrddlmZdZ ndZdZ ej dddkrddl!Z!e!j"Z#nddZ#ddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1gZ$e peZ%e r*e$&d2d3d4ge%r:e$'d5ej ddd6kZ(e(rbe$&d7d8d9geed:rvej)Z)nXeed;rGdZ+e+dd>Z)n*Gd?d@d@ejZ,GdAd:d:ej-e,ddBZ)e dCZ.e dDZ/e dEZ0ej dFddGZ1ej dHddGZ2ej dIddGZ3ej dJddKZ4eedr8ej5Z5nXeed;rfGdLdMdMej*dd>Z6e6dd>Z5n*GdNdOdOejZ7GdPddej-e7ddBZ5eed rej dddQkrej-Z-nej dddQkrGdRdSdSej8dd>Z9e9d dTdUZ-nXeed;rGdVdWdWej*dd>Z:e:dd>Z-n*GdXdYdYejZ;GdZd d ej-e;ddBZ-eed)r\ejZ>nej dddQkrGd]d^d^ej8dd>Z?e?d+d_dUZ>nXeed;rGd`dadaej*dd>Z@e@dd>Z>n*GdbdcdcejZAGddd+d+ej-eAddBZ>dedfZBdgd-ZCeed"r4ejDZDn*ej dhdediZEGdjd"d"ejeEedkZDdldmZFGdndodoeZGeFdprGdqdpdpeje1eGejHdrZHeFdsrGdtdsdseHe2eje1e4e2feGejIdrZIeFdurGdvdudueje1eGejJdrZJeFdwr GdxdwdweJe1eGejKdrZKeed%r4ejLZLnLe r^Gdyd%d%ejMejNe.eGejMdrZLn"Gdzd%d%ejMejNe.eGejMdrZLeed#rejOZOnBeed{rGd|d#d#eje1eGejPdrZOnGd}d#d#eje1ZOeed~rejQZQe$'d~nReedr*Gdd~d~eje1eGejRdrZQe$'d~nej dddkrFeSdeed&rZejTZTnTe rGdd&d&ejUejVe/e0feGejUdrZTn&Gdd&d&ejUejVe/e0feGejUdrZTeedrejWZWndej ddkrdkrnneXejWe/e0fZWnTe r*GdddejWejVe/e0feGejWdrZWn&GdddejWejVe/e0feGejWdrZWeed$rdejYZYnd6ej ddkrdkrnnNe stZe dZ[GdddejZ\Gdd$d$ejYej]e.e^fe\ejYdrZYnTe rGdd$d$ejYej]e.e^feGejYdrZYn&Gdd$d$ejYej]e.e^feGejYdrZYeed rJej_Z_e$'dnjeed re rGdddej_ejVe/e0feGej_drZ_n&Gdddej_ejVe/e0feGej_drZ_e$'deFd rGdddeKe1eje1e4feGej`drZ`eed, rejaZandd,Zaeed. rejbZbnecZbeed1 r.ejdZdndZdddZee rHddZddpdddudwdddddd#d~g ZfddZgddZheed7 rejiZine( re sddZjGdddeZkGdd7d7ekdZieijldk r.eijljme rdnddei_lnFe r.ddlmZmnZnmoZoddZjGdddejpZkGdd7d7ekdZieed9 rBejqZqne( rPdd9Zqe( rZeqZreed( rnejsZsne( reqGdd(d(eiZsej dk rejtZtnTddZuddZvdev_wddddZxdex_wGdddeZyeydezfiZte{et_|det_leed5 rej}Z}ej~Z~ejZnpe rNGddĄdejndd>ZGdd5d5Z}ddDŽZddd4Z~n2e% rddʄZGdd̄dejZGdd5d5edZ}ej dddk rejZejZnze rddlmnZnyddlmZWnek renZYnXyddlmZWnek r enZYnXdd3Zdd2Zeed/ r0ejZnej dddk rhGddքdej8dd>Zedd/Znej dddQk rGddքdej8dd>Zed/ddUZnheed; rGddۄdejZGdd݄dej*eddBZedd>Zn&GddۄdejZGdd/d/eddBZeedr"ejZejZn.GdddZGdddeZGdddeZeed!rdejZnGdd!d!eZGdddeZeddZeedrejZejZnej dddkreddZnej dddQkrGdddej8dd>ZedddUZnheed;rFGdddejZGdddej*eddBZedd>Zn&GdddejZGdddeddBZeed0rejZnej dddkrGdddej8dd>Zedd0Znej dddQkrGdddej8dd>Zed0ddUZnXeed;rGdddej*dd>Zedd>Zn*GdddejZGdd0d0ej-eddBZdS(N)GenericCallableTypeVarTuple)rr) GenericMeta TypingMetaF) _type_vars _next_in_mro _type_checkT) _subs_tree) _tp_cachecCs|S)N)xrrY/home/kop/projects/devel/pgwui/test_venv/lib/python3.7/site-packages/typing_extensions.pyr$sr)_TypingEllipsis _TypingEmptyc@s eZdZdS)rN)__name__ __module__ __qualname__rrrrr)src@s eZdZdS)rN)rrrrrrrr,srcCs2t|}d|kr.x|dD]}||dqW|S)N __slots__)dictpop)dctZ dict_copyZslotrrr_no_slots_copy4s rcCsX|jstdt|t|}t|j}||krTtd||kr@dndt|||fdS)Nz%s is not a generic classz0Too %s parameters for %s; actual %s, expected %smanyfew)__parameters__ TypeErrorreprlen)cls parametersalenelenrrr_check_generic<s r& _generic_newcOs|j|f||S)N)__new__)Zbase_clsr"argskwargsrrrr'Vs_geqv)r+)rcGsH|j}x<|D]4}x.|D]"}||jkr|j|dkr6tSPqWtSq WdS)NT)__mro____dict__NotImplemented)CmethodsmromethodBrrr_check_methods_in_mroes   r6ClassVar ConcatenateFinal ParamSpecTypeContextManagerCounterDeque DefaultDictZOrderedDictTypedDict SupportsIndexfinalIntVarLiteralNewTypeoverloadText TypeAlias TypeGuard TYPE_CHECKINGget_args get_originget_type_hints Annotated)rrProtocolruntimeruntime_checkableNoReturn_FinalTypingBasec@s$eZdZdZdZddZddZdS) _NoReturna7Special type indicating functions that never return. Example:: from typing import NoReturn def stop() -> NoReturn: raise Exception('no way') This type is invalid in other positions, e.g., ``List[NoReturn]`` will fail in static type checkers. rcCs tddS)Nz*NoReturn cannot be used with isinstance().)r)selfobjrrr__instancecheck__sz_NoReturn.__instancecheck__cCs tddS)Nz*NoReturn cannot be used with issubclass().)r)rUr"rrr__subclasscheck__sz_NoReturn.__subclasscheck__N)rrr__doc__rrWrXrrrrrTs rT)_rootcs2eZdZdZd fdd ZddZddZZS) _NoReturnMetazMetaclass for NoReturnFcstj|||||dS)N)rZ)superr()r"namebases namespacerZ) __class__rrr(sz_NoReturnMeta.__new__cCs tddS)Nz*NoReturn cannot be used with isinstance().)r)rUrVrrrrWsz_NoReturnMeta.__instancecheck__cCs tddS)Nz*NoReturn cannot be used with issubclass().)r)rUr"rrrrXsz_NoReturnMeta.__subclasscheck__)F)rrrrYr(rWrX __classcell__rr)r`rr[sr[c@seZdZdZdZdS)rRa7Special type indicating functions that never return. Example:: from typing import NoReturn def stop() -> NoReturn: raise Exception('no way') This type is invalid in other positions, e.g., ``List[NoReturn]`` will fail in static type checkers. rN)rrrrYrrrrrrRs ) metaclassrZTKTVTT_co) covariantV_coVT_coT_contra) contravariantcsNeZdZdZdZdddZddZdd Zfd d Zd d Z ddZ Z S) _ClassVara[Special type construct to mark class variables. An annotation wrapped in ClassVar indicates that a given attribute is intended to be used as a class variable and should not be set on instances of that class. Usage:: class Starship: stats: ClassVar[Dict[str, int]] = {} # class variable damage: int = 10 # instance variable ClassVar accepts only types and cannot be further subscribed. Note that ClassVar is not a class itself, and should not be used with isinstance() or issubclass(). )__type__NcKs ||_dS)N)rm)rUtpkwdsrrr__init__sz_ClassVar.__init__c CsRt|}|jdkr6|t|d|jddddStd|jdddS)Nz{} accepts only single type.T)rZz {} cannot be further subscripted)typermtypingr formatrr)rUitemr"rrr __getitem__s z_ClassVar.__getitem__cCs.t|j||}||jkr|St||ddS)NT)rZ)rs _eval_typermrr)rUglobalnslocalnsnew_tprrrrws z_ClassVar._eval_typecs.t}|jdk r*|dt|j7}|S)Nz[{}])r\__repr__rmrtrs _type_repr)rUr)r`rrr{s  z_ClassVar.__repr__cCstt|j|jfS)N)hashrrrrm)rUrrr__hash__sz_ClassVar.__hash__cCs,t|tstS|jdk r$|j|jkS||kS)N) isinstancerlr0rm)rUotherrrr__eq__s    z_ClassVar.__eq__)N) rrrrYrrprvrwr{rrrarr)r`rrls   rlcs^eZdZdZdfdd ZddZdd Zd d Zd d ZfddZ ddZ ddZ Z S) _ClassVarMetazMetaclass for ClassVarNFcs(tj|||||d}|dk r$||_|S)N)rZ)r\r(rm)r"r]r^r_rnrZrU)r`rrr(*sz_ClassVarMeta.__new__cCs tddS)Nz*ClassVar cannot be used with isinstance().)r)rUrVrrrrW0sz_ClassVarMeta.__instancecheck__cCs tddS)Nz*ClassVar cannot be used with issubclass().)r)rUr"rrrrX3sz_ClassVarMeta.__subclasscheck__cCsbt|}|jdk r*td|jddt|d|jdd}||j|jt|j |ddS)Nz {} cannot be further subscriptedrqz{} accepts only single type.T)rnrZ) rrrmrrtrrsr __bases__rr/)rUrur"paramrrrrv6s  z_ClassVarMeta.__getitem__cCs@t|j||}||jkr|St||j|jt|j|jddS)NT)rnrZ)rsrwrmrrrrrr/)rUrxryrzrrrrwBs   z_ClassVarMeta._eval_typecs.t}|jdk r*|dt|j7}|S)Nz[{}])r\r{rmrtrsr|)rUr})r`rrr{Js  z_ClassVarMeta.__repr__cCstt|j|jfS)N)r~rrrrm)rUrrrrPsz_ClassVarMeta.__hash__cCs,t|tstS|jdk r$|j|jkS||kS)N)rr7r0rm)rUrrrrrSs    z_ClassVarMeta.__eq__)NF) rrrrYr(rWrXrvrwr{rrrarr)r`rr's  rc@seZdZdZdZdS)r7a[Special type construct to mark class variables. An annotation wrapped in ClassVar indicates that a given attribute is intended to be used as a class variable and should not be set on instances of that class. Usage:: class Starship: stats: ClassVar[Dict[str, int]] = {} # class variable damage: int = 10 # instance variable ClassVar accepts only types and cannot be further subscribed. Note that ClassVar is not a class itself, and should not be used with isinstance() or issubclass(). N)rrrrYrmrrrrr7Zs)rrc@seZdZddZddZdS) _FinalFormcCs d|jS)Nztyping_extensions.)_name)rUrrrr{ssz_FinalForm.__repr__cCs t|d|j}t||fS)Nz{} accepts only single type)rsr rtr _GenericAlias)rUr#rurrrrvvsz_FinalForm.__getitem__N)rrrr{rvrrrrrqsraWA special typing construct to indicate that a name cannot be re-assigned or overridden in a subclass. For example: MAX_SIZE: Final = 9000 MAX_SIZE += 1 # Error reported by type checker class Connection: TIMEOUT: Final[int] = 10 class FastConnector(Connection): TIMEOUT = 1 # Error reported by type checker There is no runtime checking of these properties.)doccsNeZdZdZdZdddZddZdd Zfd d Zd d Z ddZ Z S)_FinalaA special typing construct to indicate that a name cannot be re-assigned or overridden in a subclass. For example: MAX_SIZE: Final = 9000 MAX_SIZE += 1 # Error reported by type checker class Connection: TIMEOUT: Final[int] = 10 class FastConnector(Connection): TIMEOUT = 1 # Error reported by type checker There is no runtime checking of these properties. )rmNcKs ||_dS)N)rm)rUrnrorrrrpsz_Final.__init__c CsRt|}|jdkr6|t|d|jddddStd|jdddS)Nz{} accepts only single type.rqT)rZz {} cannot be further subscripted)rrrmrsr rtrr)rUrur"rrrrvs z_Final.__getitem__cCs.t|j||}||jkr|St||ddS)NT)rZ)rsrwrmrr)rUrxryrzrrrrws z_Final._eval_typecs.t}|jdk r*|dt|j7}|S)Nz[{}])r\r{rmrtrsr|)rUr})r`rrr{s  z_Final.__repr__cCstt|j|jfS)N)r~rrrrm)rUrrrrsz_Final.__hash__cCs,t|tstS|jdk r$|j|jkS||kS)N)rrr0rm)rUrrrrrs    z _Final.__eq__)N) rrrrYrrprvrwr{rrrarr)r`rrs   rcs^eZdZdZdfdd ZddZdd Zd d Zd d ZfddZ ddZ ddZ Z S) _FinalMetazMetaclass for FinalNFcs(tj|||||d}|dk r$||_|S)N)rZ)r\r(rm)r"r]r^r_rnrZrU)r`rrr(sz_FinalMeta.__new__cCs tddS)Nz'Final cannot be used with isinstance().)r)rUrVrrrrWsz_FinalMeta.__instancecheck__cCs tddS)Nz'Final cannot be used with issubclass().)r)rUr"rrrrXsz_FinalMeta.__subclasscheck__cCsbt|}|jdk r*td|jddt|d|jdd}||j|jt|j |ddS)Nz {} cannot be further subscriptedrqz{} accepts only single type.T)rnrZ) rrrmrrtrrsr rrr/)rUrur"rrrrrvs  z_FinalMeta.__getitem__cCs@t|j||}||jkr|St||j|jt|j|jddS)NT)rnrZ)rsrwrmrrrrrr/)rUrxryrzrrrrws   z_FinalMeta._eval_typecs.t}|jdk r*|dt|j7}|S)Nz[{}])r\r{rmrtrsr|)rUr})r`rrr{s  z_FinalMeta.__repr__cCstt|j|jfS)N)r~rrrrm)rUrrrrsz_FinalMeta.__hash__cCs,t|tstS|jdk r$|j|jkS||kS)N)rr9r0rm)rUrrrrrs    z_FinalMeta.__eq__)NF) rrrrYr(rWrXrvrwr{rrrarr)r`rrs  rc@seZdZdZdZdS)r9aA special typing construct to indicate that a name cannot be re-assigned or overridden in a subclass. For example: MAX_SIZE: Final = 9000 MAX_SIZE += 1 # Error reported by type checker class Connection: TIMEOUT: Final[int] = 10 class FastConnector(Connection): TIMEOUT = 1 # Error reported by type checker There is no runtime checking of these properties. N)rrrrYrmrrrrr9scCs|S)auThis decorator can be used to indicate to type checkers that the decorated method cannot be overridden, and decorated class cannot be subclassed. For example: class Base: @final def done(self) -> None: ... class Sub(Base): def done(self) -> None: # Error reported by type checker ... @final class Leaf: ... class Other(Leaf): # Error reported by type checker ... There is no runtime checking of these properties. r)frrrrA scCst|S)N)r)r]rrrrB sc@seZdZddZddZdS) _LiteralFormcCs d|jS)Nztyping_extensions.)r)rUrrrr{)sz_LiteralForm.__repr__cCs t||S)N)r)rUr#rrrrv,sz_LiteralForm.__getitem__N)rrrr{rvrrrrr'sraoA type that can be used to indicate to type checkers that the corresponding value has a value literally equivalent to the provided parameter. For example: var: Literal[4] = 4 The type checker understands that 'var' is literally equal to the value 4 and no other value. Literal[...] cannot be subclassed. There is no runtime checking verifying that the parameter is actually a value instead of a type.csNeZdZdZdZdddZddZdd Zfd d Zd d Z ddZ Z S)_LiteralaA type that can be used to indicate to type checkers that the corresponding value has a value literally equivalent to the provided parameter. For example: var: Literal[4] = 4 The type checker understands that 'var' is literally equal to the value 4 and no other value. Literal[...] cannot be subclassed. There is no runtime checking verifying that the parameter is actually a value instead of a type. ) __values__NcKs ||_dS)N)r)rUvaluesrorrrrpMsz_Literal.__init__cCsJt|}|jdkr.t|ts"|f}||ddStd|jdddS)NT)rZz {} cannot be further subscriptedrq)rrrrtuplerrtr)rUrr"rrrrvPs   z_Literal.__getitem__cCs|S)Nr)rUrxryrrrrwYsz_Literal._eval_typecs6t}|jdk r2|ddttj|j7}|S)Nz[{}]z, )r\r{rrtjoinmaprsr|)rUr})r`rrr{\s  z_Literal.__repr__cCstt|j|jfS)N)r~rrrr)rUrrrrbsz_Literal.__hash__cCs,t|tstS|jdk r$|j|jkS||kS)N)rrr0r)rUrrrrres    z_Literal.__eq__)N) rrrrYrrprvrwr{rrrarr)r`rr=s    rcs^eZdZdZdfdd ZddZdd Zd d Zd d ZfddZ ddZ ddZ Z S) _LiteralMetazMetaclass for LiteralNFcs(tj|||||d}|dk r$||_|S)N)rZ)r\r(r)r"r]r^r_rrZrU)r`rrr(qsz_LiteralMeta.__new__cCs tddS)Nz)Literal cannot be used with isinstance().)r)rUrVrrrrWwsz_LiteralMeta.__instancecheck__cCs tddS)Nz)Literal cannot be used with issubclass().)r)rUr"rrrrXzsz_LiteralMeta.__subclasscheck__cCsVt|}|jdk r*td|jddt|ts:|f}||j|jt|j |ddS)Nz {} cannot be further subscriptedrqT)rrZ) rrrrrtrrrrrr/)rUrur"rrrrv}s   z_LiteralMeta.__getitem__cCs|S)Nr)rUrxryrrrrwsz_LiteralMeta._eval_typecs6t}|jdk r2|ddttj|j7}|S)Nz[{}]z, )r\r{rrtrrrsr|)rUr})r`rrr{s  z_LiteralMeta.__repr__cCstt|j|jfS)N)r~rrrr)rUrrrrsz_LiteralMeta.__hash__cCs,t|tstS|jdk r$|j|jkS||kS)N)rrCr0r)rUrrrrrs    z_LiteralMeta.__eq__)NF) rrrrYr(rWrXrvrwr{rrrarr)r`rrns  rc@seZdZdZdZdS)rCaA type that can be used to indicate to type checkers that the corresponding value has a value literally equivalent to the provided parameter. For example: var: Literal[4] = 4 The type checker understands that 'var' is literally equal to the value 4 and no other value. Literal[...] cannot be subclassed. There is no runtime checking verifying that the parameter is actually a value instead of a type. N)rrrrYrrrrrrCs cOs tddS)z*Helper for @overload to raise when called.zYou 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.N)NotImplementedError)r)rorrr_overload_dummysrcCstS)a Decorator for overloaded functions/methods. In a stub file, place two or more stub definitions for the same function in a row, each decorated with @overload. For example: @overload def utf8(value: None) -> None: ... @overload def utf8(value: bytes) -> bytes: ... @overload def utf8(value: str) -> bytes: ... In a non-stub file (i.e. a regular .py file), do the same but follow it with an implementation. The implementation should *not* be decorated with @overload. For example: @overload def utf8(value: None) -> None: ... @overload def utf8(value: bytes) -> bytes: ... @overload def utf8(value: str) -> bytes: ... def utf8(value): # implementation goes here )r)funcrrrrEsCT_co)rgboundc@seZdZdZdZdS)r;aA special construct usable 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:: U = TypeVar('U', bound=User) def new_user(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. rN)rrrrYrrrrrr;s)extracCsHtt|r(t|tt|t|<dStt|r@t|dSdSdS)z Returns True if the given type isn't defined in typing but is defined in collections_abc. Adds the type to __all__ if the collection is found in either typing or collection_abc. FTN)hasattrrs__all__appendgetattrglobalscollections_abc) type_namerrr _define_guards    rcseZdZfddZZS)_ExtensionsGenericMetacstjdddks$tjdddkrN|jdk rNtdjddkrJtdd S|js`t|S|j |}|t k rx|S|j|j krd Sx,|j D]}t |trqt||rd SqWd S) a*This mimics a more modern GenericMeta.__subclasscheck__() logic (that does not have problems with recursion) to work around interactions between collections, typing, and typing_extensions on older versions of Python, see https://github.com/python/typing/issues/501. Nr)rrNr)rrNrrqr)abc functoolszCParameterized generics cannot be used with class or instance checksFT)sys version_info __origin__ _getframe f_globalsr __extra__r\rX__subclasshook__r0r.__subclasses__rr issubclass)rUsubclassresZscls)r`rrrX s$$      z(_ExtensionsGenericMeta.__subclasscheck__)rrrrXrarr)r`rr sr Awaitablec@seZdZdZdS)rrN)rrrrrrrrr&s)rbr Coroutinec@seZdZdZdS)rrN)rrrrrrrrr,s AsyncIterablec@seZdZdZdS)rrN)rrrrrrrrr3s AsyncIteratorc@seZdZdZdS)rrN)rrrrrrrrr:sc@seZdZdZddZdS)r>rcOs*t|trtj||Sttj|f||S)N)r+r> collectionsdequer')r"r)rorrrr(Hs  z Deque.__new__N)rrrrr(rrrrr>Csc@seZdZdZddZdS)r>rcOs*|jtkrtj||Sttj|f||S)N)_gorgr>rrr')r"r)rorrrr(Rs  z Deque.__new__N)rrrrr(rrrrr>MsAbstractContextManagerc@seZdZdZdS)r<rN)rrrrrrrrr<[sc@s2eZdZdZddZejddZeddZ dS) r<rcCs|S)Nr)rUrrr __enter__cszContextManager.__enter__cCsdS)Nr)rUexc_type exc_value tracebackrrr__exit__fszContextManager.__exit__cCs8|tkr4tdd|jDr4tdd|jDr4dStS)Ncss|]}d|jkVqdS)rN)r/).0r5rrr rsz2ContextManager.__subclasshook__..css|]}d|jkVqdS)rN)r/)rr5rrrrssT)r<anyr.r0)r"r1rrrrjs zContextManager.__subclasshook__N) rrrrrrabstractmethodr classmethodrrrrrr<`sAsyncContextManagerAbstractAsyncContextManagerc@seZdZdZdS)rrN)rrrrrrrrr|s)rrNa class AsyncContextManager(typing.Generic[T_co]): __slots__ = () async def __aenter__(self): return self @abc.abstractmethod async def __aexit__(self, exc_type, exc_value, traceback): return None @classmethod def __subclasshook__(cls, C): if cls is AsyncContextManager: return _check_methods_in_mro(C, "__aenter__", "__aexit__") return NotImplemented __all__.append('AsyncContextManager') c@seZdZdZddZdS)r?rcOs*t|trtj||Sttj|f||S)N)r+r?r defaultdictr')r"r)rorrrr(s  zDefaultDict.__new__N)rrrrr(rrrrr?sc@seZdZdZddZdS)r?rcOs*|jtkrtj||Sttj|f||S)N)rr?rrr')r"r)rorrrr(s  zDefaultDict.__new__N)rrrrr(rrrrr?s OrderedDict)rrr,c@seZdZdZddZdS)rrcOs*t|trtj||Sttj|f||S)N)r+rrr')r"r)rorrrr(s  zOrderedDict.__new__N)rrrrr(rrrrrsc@seZdZdZddZdS)rrcOs*|jtkrtj||Sttj|f||S)N)rrrr')r"r)rorrrr(s  zOrderedDict.__new__N)rrrrr(rrrrrs)rrNrq_TIntcs eZdZdZfddZZS) _CounterMetazMetaclass for Countercst|tfS)N)r\rvint)rUru)r`rrrvsz_CounterMeta.__getitem__)rrrrYrvrarr)r`rrsrc@seZdZdZddZdS)r=rcOs*t|trtj||Sttj|f||S)N)r+r=rr')r"r)rorrrr(s  zCounter.__new__N)rrrrr(rrrrr=sc@seZdZdZddZdS)r=rcOs*t|trtj||Sttj|f||S)N)r+r=rr')r"r)rorrrr(s  zCounter.__new__N)rrrrr(rrrrr=sc@seZdZdZddZdS)r=rcOs*|jtkrtj||Sttj|f||S)N)rr=rr')r"r)rorrrr(s  zCounter.__new__N)rrrrr(rrrrr=sChainMapc@seZdZdZddZdS)rrcOs*t|trtj||Sttj|f||S)N)r+rrr')r"r)rorrrr( s  zChainMap.__new__N)rrrrr(rrrrrsc@seZdZdZddZdS)rrcOs*|jtkrtj||Sttj|f||S)N)rrrr')r"r)rorrrr(s  zChainMap.__new__N)rrrrr(rrrrrsAsyncGeneratorc@seZdZdZdS)rrN)rrrrrrrrrscCsdd}||_||_|S)aQNewType creates simple unique types with almost zero runtime overhead. NewType(name, tp) is considered a subtype of tp by static type checkers. At runtime, NewType(name, tp) returns a dummy function that simply returns its argument. Usage:: UserId = NewType('UserId', int) def name_by_id(user_id: UserId) -> str: ... UserId('user') # Fails type check name_by_id(42) # Fails type check name_by_id(UserId(42)) # OK num = UserId(5) + 1 # type: int cSs|S)Nr)rrrrnew_type:szNewType..new_type)r __supertype__)r]rnrrrrrD'scCs8t|tstt|dr|jSx|jdk r2|j}q W|S)z@This function exists for compatibility with old typing versions.rN)rrAssertionErrorrrr)r"rrrrOs    rcCsLt}xBt|jddD],\}}t|trt|tkr|j|d}qW|S)z@This function exists for compatibility with old typing versions.Nrq)object enumerater.rrrr)r"Z next_in_mroicrrrr Zs r rIterableIteratorHashableSized Container Collection ReversiblecCszt}xn|jddD]\}|jdkr&qt|di}x>t|jt|D] }|dsN|dkrN||qNWqW|S)Nr)rOr__annotations___abc_)__abstractmethods__r __weakref__ _is_protocol_is_runtime_protocolr/__args__r__next_in_mro__rr__orig_bases__r __tree_hash__rYrrpr(r_MutableMapping__markerr) setr.rrlistr/keys startswithadd)r"attrsbase annotationsattrrrr_get_protocol_attrsis    rcstfddtDS)Nc3s|]}tt|dVqdS)N)callabler)rr)r"rrr}sz,_is_callable_members_only..)allr)r"r)r"r_is_callable_members_only|srcOst|jrtddS)Nz Protocols cannot be instantiated)rrrr)rUr)r*rrr_no_inits rcsZeZdZdZesd fdd ZfddZfddZfd d ZesRe d d Z Z S) _ProtocolMetazInternal metaclass for Protocol. This exists so Protocol classes can be generic without deriving from Generic. Nc sL|dks t|dk r<|dk s ttdd|Ds:t|nt|}d} xJ|D]B} | tkrbtdt| trN| jttfkrN| dk rtd| j } qNW| dkr|} njt |} t | | kstdd fdd|Dt dd|Drd nd d d d| Df| }|} |dk r>t |tjkr>||kr>|f|}td d|D}t d d|Drvtdd|D}|||dtt|j||||dd} tt| d|s| nt||| _ |rtdd|Dnd| _t| | _|dkr| | _n|dk r|j| _|j| _t| drH|r8t| n tt| | _ | S)Ncss|]}t|tVqdS)N)rr)rtrrrrsz(_ProtocolMeta.__new__..z!Cannot inherit from plain GenericzACannot inherit from Generic[...] or Protocol[...] multiple times.z1Some type variables (%s) are not listed in %s[%s]z, c3s|]}|krt|VqdS)N)str)rr)gvarsetrrrscss|]}|jtkVqdS)N)rr)rbrrrrsrrOcss|]}t|VqdS)N)r)rgrrrrscss$|]}t|trt|n|VqdS)N)rrr)rrrrrrscss |]}t|to|tk VqdS)N)rrr)rrrrrrscss|]}|tk r|VqdS)N)r)rrrrrrs)rrT)rZrcss*|]"}|tkrdn|tkrdn|VqdS).rN)rr)rarrrrsr )!rrr rrrrrrOrrrrrrrABCMetarupdater\r( __setattr__rrr rr _abc_registry _abc_cacherr~r rr)r"r]r^r_tvarsr)originr orig_basesgvarsrtvarsetZ initial_basesrU)r`)rrr(sj                z_ProtocolMeta.__new__cstj||jdds2tddjD_jrxfjddD]T}|tt fksH|j dkrl|j t ksHt |tr||jsHt |tr|jt ksHtd|qHWt_fdd}d jkr|_dS) Nrcss*|]"}|tkp t|to |jtkVqdS)N)rOrrr)rrrrrrsz)_ProtocolMeta.__init__..rqzcollections.abcz7Protocols can only inherit from other protocols, got %rcsjddstSt|ts$tdxttD]h}xb|jD]T}||jkr\|j|dkrZtSPt|di}t|t j r:||kr:t|t r:|j r:Pq:WtSq.WdS)Nrz"issubclass() arg 1 must be a classrT) r/getr0rrrrrr.rrsMappingrr)rrrr)r"rr _proto_hooks$      z+_ProtocolMeta.__init__.._proto_hookr)r\rpr/rrrrr.rrrr_PROTO_WHITELISTrr rrrrr)r"r)r*rr)r`)r"rrps$        z_ProtocolMeta.__init__csZtddrtr$tjr$dSjrJtfddtDrJdStt S)NrFTc3s8|]0}t|o.tt|d p.t|dk VqdS)N)rrr)rr)instancerUrrrsz2_ProtocolMeta.__instancecheck__..) rrrr`rrrr\rrW)rUr )r`)r rUrrWs  z_ProtocolMeta.__instancecheck__cs|jdk r*tdjddkr&tddS|jddrf|jddsftdjddkr^dStd |jddrt|stdjddkrtt | |Std tt | |S) Nrqr)rrzCParameterized generics cannot be used with class or instance checksFrr)rrrszBInstance and class checks can only be used with @runtime protocolsz.css|]}t|tVqdS)N)rr)rr rrrr0sz0Parameters to %r[...] must all be type variablesz(Parameters to %r[...] must all be uniquez'Cannot subscript already-subscripted %sr)rr)rrr)rrrrrrrrOrr!rrr rr r&r`rrrr/rr)rUparamsrr)prependr)r rrv$sD       z_ProtocolMeta.__getitem__)NNNNN) rrrrY OLD_GENERICSr(rprWrXrrvrarr)r`rrs@ ,  rc@s eZdZdZdZdZddZdS)rOaBase class for protocol classes. Protocol classes are defined as:: class Proto(Protocol): def meth(self) -> int: ... Such classes are primarily used with static type checkers that recognize structural subtyping (static duck-typing), for example:: class C: def meth(self) -> int: return 0 def func(x: Proto) -> int: return x.meth() func(C()) # Passes static type check See PEP 544 for details. Protocol classes decorated with @typing_extensions.runtime act as simple-minded runtime protocol that checks only the presence of given attributes, ignoring their type signatures. Protocol classes can be generic, they are defined as:: class GenProto({bases}): def meth(self) -> T: ... rTcOsBt|tkrtdtr.tt||f||St|j|f||S)NzIType Protocol cannot be instantiated; it can be used only as a base class)rrOrrr'r r)r"r)rorrrr(ms  zProtocol.__new__N)rrrrYrrr(rrrrrOMs)rbzProtocol, Generic[T]z Protocol[T])r^)r r_collect_type_varscOst|jrtddS)Nz Protocols cannot be instantiated)rrrr)rUr)r*rrrr|s cseZdZfddZZS)rcsVtddrtr$tjr$dSjrJtfddtDrJdStS)NrFTc3s8|]0}t|o.tt|d p.t|dk VqdS)N)rrr)rr)r"r rrrsz2_ProtocolMeta.__instancecheck__..) rrrr`rrrr\rW)r"r )r`)r"r rrWs  z_ProtocolMeta.__instancecheck__)rrrrWrarr)r`rrscs<eZdZdZdZdZfddZeddZdd Z Z S) rOaBase class for protocol classes. Protocol classes are defined as:: class Proto(Protocol): def meth(self) -> int: ... Such classes are primarily used with static type checkers that recognize structural subtyping (static duck-typing), for example:: class C: def meth(self) -> int: return 0 def func(x: Proto) -> int: return x.meth() func(C()) # Passes static type check See PEP 544 for details. Protocol classes decorated with @typing_extensions.runtime act as simple-minded runtime protocol that checks only the presence of given attributes, ignoring their type signatures. Protocol classes can be generic, they are defined as:: class GenProto(Protocol[T]): def meth(self) -> T: ... rTcs|tkrtdt|S)NzIType Protocol cannot be instantiated; it can only be used as a base class)rOrr\r()r"r)ro)r`rrr(szProtocol.__new__cst|ts|f}|s,|tk r,td|jdtfdd|D}|tkrtdd|Dsd}xt||tr~|d7}qfWtd|d||t t |t |krtd n t ||t ||S) Nz)Parameter list to {}[...] cannot be emptyz*Parameters to generic types must be types.c3s|]}t|VqdS)N)r )rr )r rrrsz-Protocol.__class_getitem__..css|]}t|tVqdS)N)rr)rr rrrrsrrqzJParameters to Protocol[...] must all be type variables. Parameter {} is {}z.Parameters to Protocol[...] must all be unique) rrrrrtrrOrrr!rr&r)r"r rr)r r__class_getitem__s(    zProtocol.__class_getitem__c sg}djkrtjk}n tjk}|r0tddjkrtj}d}xNjD]D}t|trR|jtt fkrR|jtkr|dnd}|dk rtd|j }qRW|dkr|}nZt |}t ||ksd fdd|D} d d d|D} td | || |}t|_ jd ds2td djD_fd d} djkrP| _js\dSxVjD]L}|ttfksd|jdkr|jtksdt|tr|jsdtd|qdWt_dS)Nrz!Cannot inherit from plain GenericrrOzECannot inherit from Generic[...] and/or Protocol[...] multiple types.z, c3s|]}|krt|VqdS)N)r)rr)rrrrsz-Protocol.__init_subclass__..css|]}t|VqdS)N)r)rrrrrrsz1Some type variables ({}) are not listed in {}[{}]rcss|]}|tkVqdS)N)rO)rrrrrrscsjddstStdds>tdjddkr6tStdtsftdjddkr^tStdt |t sxtd xtt D]h}xb|j D]T}||jkr|j|dkrtSPt|d i}t |t jr||krt |tr|jrPqWtSqWd S) NrrFr,r)rrzBInstance and class checks can only be used with @runtime protocolsz._proto_hookrzcollections.abcz7Protocols can only inherit from other protocols, got %r)r/rrrrrrrrrOrrrrtrrrrrrrrrrrrp) r"r)r*rerrorrrZthe_basers_varss_argsrr)r"rr__init_subclass__sX               zProtocol.__init_subclass__) rrrrYrrr(rrrrarr)r`rrOs   cCs&t|tr|jstd|d|_|S)a4Mark a protocol class as a runtime protocol, so that it can be used with isinstance() and issubclass(). Raise TypeError if applied to a non-protocol class. This allows a simple-minded structural check very similar to the one-offs in collections.abc such as Hashable. zB@runtime_checkable can be only applied to protocol classes, got %rT)rrrrr)r"rrrrQ6s c@s$eZdZdZejedddZdS)r@r)returncCsdS)Nr)rUrrr __index__QszSupportsIndex.__index__N)rrrrrrrrrrrrr@Ms)r r,c Cs>y tdjddkrtdWnttfk r8YnXdS)Nrqr)rrrsz4TypedDict does not support instance and class checksF)rrrrAttributeError ValueError)r"rrrr _check_fails]s  rcOs,|s td|d|dd}}t||S)Nz)TypedDict.__new__(): not enough argumentsrrq)rr)r)r*_rrr _dict_newhsrz,($cls, _typename, _fields=None, /, **kwargs))totalc OsZ|s td|d|dd}}|r>|d|dd}}n4d|krj|d}ddl}|jdtddntd|ry |\}Wqtk rtd t|dYqXnsz*_TypedDictMeta.__new__..__required_keys__r__optional_keys__ __total__)r(rr\r$r(rrrritemsrr/r frozensetr,r-rr.) r"r]r^r'rZtp_dictrZown_annotationsZown_annotation_keysZ required_keysZ optional_keysr)r`)r rr(s0           z_TypedDictMeta.__new__)T)T) rrrrpr(rrWrXrarr)r`rr$s&r$r)aA simple typed name space. At runtime it is equivalent to a plain dict. TypedDict creates a dictionary type that expects all of its instances to have a certain set of keys, with each key associated with a value of a consistent type. This expectation is not checked at runtime but is only enforced by type checkers. Usage:: class Point2D(TypedDict): x: int y: int label: str a: Point2D = {'x': 1, 'y': 2, 'label': 'good'} # OK b: Point2D = {'z': 3, 'label': 'bad'} # Fails type check assert Point2D(x=1, y=2, label='first') == dict(x=1, y=2, label='first') The type info can be accessed via the Point2D.__annotations__ dict, and the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets. TypedDict supports two additional equivalent forms:: Point2D = TypedDict('Point2D', x=int, y=int, label=str) Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str}) The class syntax is only supported in Python 3.6+, while two other syntax forms work for Python 2.7 and 3.2+ csHeZdZdZfddZddZddZdd Zd d Zd d Z Z S)_AnnotatedAliasaKRuntime representation of an annotated type. At its core 'Annotated[t, dec1, dec2, ...]' is an alias for the type 't' with extra annotations. The alias behaves like a normal typing alias, instantiating is the same as instantiating the underlying type, binding it to types is also the same. cs2t|tr|j|}|j}t||||_dS)N)rr1 __metadata__rr\rp)rUrmetadata)r`rrrps   z_AnnotatedAlias.__init__cCs$t|dkst|d}t||jS)Nrqr)r!rr1r2)rUr rrrr copy_withsz_AnnotatedAlias.copy_withcCs&dt|jddd|jDS)Nz#typing_extensions.Annotated[{}, {}]z, css|]}t|VqdS)N)r )rrrrrr sz+_AnnotatedAlias.__repr__..)rtrsr|rrr2)rUrrrr{ s z_AnnotatedAlias.__repr__cCstjt|jf|jffS)N)operatorgetitemrMrr2)rUrrr __reduce__sz_AnnotatedAlias.__reduce__cCs*t|tstS|j|jkrdS|j|jkS)NF)rr1r0rr2)rUrrrrrs   z_AnnotatedAlias.__eq__cCst|j|jfS)N)r~rr2)rUrrrrsz_AnnotatedAlias.__hash__) rrrrYrpr4r{r7rrrarr)r`rr1s r1c@s0eZdZdZdZddZeddZddZd S) rMaAdd context specific metadata to a type. Example: Annotated[int, runtime_check.Unsigned] indicates to the hypothetical runtime_check module that this type is an unsigned int. Every other consumer of this type can ignore this metadata and treat this type as int. The first argument to Annotated must be a valid type (and will be in the __origin__ field), the remaining arguments are kept as a tuple in the __extra__ field. Details: - It's an error to call `Annotated` with less than two arguments. - Nested Annotated are flattened:: Annotated[Annotated[T, Ann1, Ann2], Ann3] == Annotated[T, Ann1, Ann2, Ann3] - Instantiating an annotated type is equivalent to instantiating the underlying type:: Annotated[C, Ann1](5) == C(5) - Annotated can be used as a generic type alias:: Optimized = Annotated[T, runtime.Optimize()] Optimized[int] == Annotated[int, runtime.Optimize()] OptimizedList = Annotated[List[T], runtime.Optimize()] OptimizedList[int] == Annotated[List[int], runtime.Optimize()] rcOs tddS)Nz&Type Annotated cannot be instantiated.)r)r"r)r*rrrr(BszAnnotated.__new__cCsLt|trt|dkrtdd}t|d|}t|dd}t||S)Nr,zUAnnotated[...] should be used with at least two arguments (a type and an annotation).z$Annotated[t, ...]: t must be a type.rrq)rrr!rrsr r1)r"r r rr3rrrrEs zAnnotated.__class_getitem__cOstd|jdS)NzCannot subclass {}.Annotated)rrtr)r"r)r*rrrrPszAnnotated.__init_subclass__N) rrrrYrr(rrrrrrrrMs  cCs\t|trt|jSt|tjrXtdd|jD}||jkrB|S||}|j |_ |S|S)z2Strips the annotations from a given type. css|]}t|VqdS)N)_strip_annotations)rrrrrr[sz%_strip_annotations..) rr1r8rrsrrrr4_special)rZ stripped_argsrrrrr8Us     r8cCs*tj|||d}|r|Sdd|DS)a]Return type hints for an object. This is often the same as obj.__annotations__, but it handles forward references encoded as string literals, adds Optional[t] if a default value equal to None is set and recursively replaces all 'Annotated[T, ...]' with 'T' (unless 'include_extras=True'). The argument may be a module, class, method, or function. The annotations are returned as a dictionary. For classes, annotations include also inherited members. TypeError is raised if the argument is not of a type that can contain annotations, and an empty dictionary is returned if no annotations are present. BEWARE -- the behavior of globalns and localns is counterintuitive (unless you are familiar with how eval() and exec() work). The search order is locals first, then globals. - If no dict arguments are passed, an attempt is made to use the globals from obj (or the respective module's globals for classes), and these are also used as the locals. If the object does not appear to have globals, an empty dictionary is used. - If one dict argument is passed, it is used for both globals and locals. - If two dict arguments are passed, they specify globals and locals, respectively. )rxrycSsi|]\}}t||qSr)r8)rkrrrrr+sz"get_type_hints..)rsrLr/)rVrxryZinclude_extrashintrrrrLcscCs t|dko|do|dS)z3Returns True if name is a __dunder_variable_name__.__)r!rendswith)r]rrr _is_dundersr?cseZdZdZfddZeddZddZdfd d Zd d Z e fd dZ ddZ ddZ fddZddZddZZS) AnnotatedMetazMetaclass for Annotatedc s8tdd|Dr"tdtttj||||f|S)Ncss|]}|tk VqdS)N)r)rrrrrrsz(AnnotatedMeta.__new__..zCannot subclass )rrrrMr\r()r"r]r^r_r*)r`rrr(szAnnotatedMeta.__new__cCs |dS)Nr,)r )rUrrrr2szAnnotatedMeta.__metadata__cCsP|\}}}t|ts t|}n|d|}ddd|D}d|||fS)Nrz, css|]}t|VqdS)N)r )rargrrrrsz+AnnotatedMeta._tree_repr..z %s[%s, %s])rrrsr| _tree_reprr)rUtreer"rr3Ztp_reprZmetadata_reprsrrrrBs    zAnnotatedMeta._tree_reprNcsh|tkr tStj||d}t|dtrd|ddtkrd|dd}|dd}t|||dfS|S)N)rr)rqrr,)rMr\r rr)rUrr)rZsub_tpZ sub_annot)r`rrr s  zAnnotatedMeta._subs_treecCsX|jdkrtd|}x"t|tr<|dtkr<|d}qWt|trP|dS|SdS)z6Return the class used to create instance of this type.NzCCannot get the underlying type of a non-specialized Annotated type.rrq)rrr rrrM)rUrCrrr _get_conss   zAnnotatedMeta._get_conscst|ts|f}|jdk r&t|St|tr Callable[P, T]: '''A type-safe decorator to add logging to a function.''' def inner(*args: P.args, **kwargs: P.kwargs) -> T: logging.info(f'{f.__name__} was called') return f(*args, **kwargs) return inner @add_logging def add_two(x: float, y: float) -> float: '''Add two numbers together.''' return x + y Parameter specification variables defined with covariant=True or contravariant=True can be used to declare covariant or contravariant generic types. These keyword arguments are valid, but their actual semantics are yet to be decided. See PEP 612 for details. Parameter specification variables can be introspected. e.g.: P.__name__ == 'T' P.__bound__ == None P.__covariant__ == False P.__contravariant__ == False Note that only parameter specification variables defined in global scope can be pickled. cCst|S)N)rO)rUrrrr) szParamSpec.argscCst|S)N)rP)rUrrrr* szParamSpec.kwargsNF)rrgrkc st|g||_t||_t||_|r.)rr))rsr|rtrrr)rUr)r|rr{Y sz!_ConcatenateGenericAlias.__repr__cCst|j|jfS)N)r~rr)rUrrrr_ sz!_ConcatenateGenericAlias.__hash__)rrrrpr{rrarr)r`rrbS s rbcsZ|dkrtdt|ts |f}t|dts6tddtfdd|D}t||S)Nrz&Cannot take a Concatenate of no types.rzAThe last parameter to Concatenate should be a ParamSpec variable.z/Concatenate[arg, ...]: each arg must be a type.c3s|]}t|VqdS)N)rsr )rr )r rrrl sz'_concatenate_getitem..)rrrr:rb)rUr#r)r r_concatenate_getitemb s rccCs t||S)a&Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a higher order function which adds, removes or transforms parameters of a callable. For example:: Callable[Concatenate[int, P], int] See PEP 612 for detailed information. )rc)rUr#rrrr8t s c@seZdZddZddZdS)_ConcatenateFormcCs d|jS)Nztyping_extensions.)r)rUrrrr{ sz_ConcatenateForm.__repr__cCs t||S)N)rc)rUr#rrrrv sz_ConcatenateForm.__getitem__N)rrrr{rvrrrrrd srda&Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a higher order function which adds, removes or transforms parameters of a callable. For example:: Callable[Concatenate[int, P], int] See PEP 612 for detailed information. c@seZdZdZddZdS)_ConcatenateAliasMetazMetaclass for Concatenate.cCsdS)Nztyping_extensions.Concatenater)rUrrrr{ sz_ConcatenateAliasMeta.__repr__N)rrrrYr{rrrrre srec@s4eZdZdZdZddZddZddZd d Zd S) _ConcatenateAliasBasea&Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a higher order function which adds, removes or transforms parameters of a callable. For example:: Callable[Concatenate[int, P], int] See PEP 612 for detailed information. rcCs tddS)Nz-Concatenate cannot be used with isinstance().)r)rUrVrrrrW sz'_ConcatenateAliasBase.__instancecheck__cCs tddS)Nz-Concatenate cannot be used with issubclass().)r)rUr"rrrrX sz'_ConcatenateAliasBase.__subclasscheck__cCsdS)Nztyping_extensions.Concatenater)rUrrrr{ sz_ConcatenateAliasBase.__repr__cCs t||S)N)rc)rUr#rrrrv sz!_ConcatenateAliasBase.__getitem__N) rrrrYrrWrXr{rvrrrrrf s  rfc@s0eZdZdZddZddZddZdd Zd S) rezMetaclass for Concatenate.cCs tddS)Nz+TypeAlias cannot be used with isinstance().)r)rUrVrrrrW sz'_ConcatenateAliasMeta.__instancecheck__cCs tddS)Nz+TypeAlias cannot be used with issubclass().)r)rUr"rrrrX sz'_ConcatenateAliasMeta.__subclasscheck__cOs tddS)NzCannot instantiate TypeAlias)r)rUr)r*rrrrG sz_ConcatenateAliasMeta.__call__cCs t||S)N)rc)rUr#rrrrv sz!_ConcatenateAliasMeta.__getitem__N)rrrrYrWrXrGrvrrrrre s c@seZdZdZdZdS)r8a&Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a higher order function which adds, removes or transforms parameters of a callable. For example:: Callable[Concatenate[int, P], int] See PEP 612 for detailed information. rN)rrrrYrrrrrr8 s c@seZdZddZdS)_TypeGuardFormcCs d|jS)Nztyping_extensions.)r)rUrrrr{ sz_TypeGuardForm.__repr__N)rrrr{rrrrrg srgcCst|d|}t||fS)a Special typing form used to annotate the return type of a user-defined type guard function. ``TypeGuard`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeGuard[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeGuard`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the type inside ``TypeGuard``. For example:: def is_str(val: Union[str, float]): # "isinstance" type guard if isinstance(val, str): # Type of ``val`` is narrowed to ``str`` ... else: # Else, type of ``val`` is narrowed to ``float``. ... Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower form of ``TypeA`` (it can even be a wider form) and this may lead to type-unsafe results. The main reason is to allow for things like narrowing ``List[object]`` to ``List[str]`` even though the latter is not a subtype of the former, since ``List`` is invariant. The responsibility of writing type-safe type guards is left to the user. ``TypeGuard`` also works with type variables. For more information, see PEP 647 (User-Defined Type Guards). z{} accepts only single type.)rsr rtr)rUr#rurrrrH s,c@seZdZddZddZdS)rgcCs d|jS)Nztyping_extensions.)r)rUrrrr{ sz_TypeGuardForm.__repr__cCs t|d|j}t||fS)Nz{} accepts only a single type)rsr rtrr)rUr#rurrrrv sz_TypeGuardForm.__getitem__N)rrrr{rvrrrrrg sa Special typing form used to annotate the return type of a user-defined type guard function. ``TypeGuard`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeGuard[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeGuard`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the type inside ``TypeGuard``. For example:: def is_str(val: Union[str, float]): # "isinstance" type guard if isinstance(val, str): # Type of ``val`` is narrowed to ``str`` ... else: # Else, type of ``val`` is narrowed to ``float``. ... Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower form of ``TypeA`` (it can even be a wider form) and this may lead to type-unsafe results. The main reason is to allow for things like narrowing ``List[object]`` to ``List[str]`` even though the latter is not a subtype of the former, since ``List`` is invariant. The responsibility of writing type-safe type guards is left to the user. ``TypeGuard`` also works with type variables. For more information, see PEP 647 (User-Defined Type Guards). csNeZdZdZdZdddZddZdd Zfd d Zd d Z ddZ Z S) _TypeGuarda Special typing form used to annotate the return type of a user-defined type guard function. ``TypeGuard`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeGuard[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeGuard`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the type inside ``TypeGuard``. For example:: def is_str(val: Union[str, float]): # "isinstance" type guard if isinstance(val, str): # Type of ``val`` is narrowed to ``str`` ... else: # Else, type of ``val`` is narrowed to ``float``. ... Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower form of ``TypeA`` (it can even be a wider form) and this may lead to type-unsafe results. The main reason is to allow for things like narrowing ``List[object]`` to ``List[str]`` even though the latter is not a subtype of the former, since ``List`` is invariant. The responsibility of writing type-safe type guards is left to the user. ``TypeGuard`` also works with type variables. For more information, see PEP 647 (User-Defined Type Guards). )rmNcKs ||_dS)N)rm)rUrnrorrrrps sz_TypeGuard.__init__c CsRt|}|jdkr6|t|d|jddddStd|jdddS)Nz{} accepts only a single type.rqT)rZz {} cannot be further subscripted)rrrmrsr rtrr)rUrur"rrrrvv s z_TypeGuard.__getitem__cCs.t|j||}||jkr|St||ddS)NT)rZ)rsrwrmrr)rUrxryrzrrrrw s z_TypeGuard._eval_typecs.t}|jdk r*|dt|j7}|S)Nz[{}])r\r{rmrtrsr|)rUr})r`rrr{ s  z_TypeGuard.__repr__cCstt|j|jfS)N)r~rrrrm)rUrrrr sz_TypeGuard.__hash__cCs,t|tstS|jdk r$|j|jkS||kS)N)rrhr0rm)rUrrrrr s    z_TypeGuard.__eq__)N) rrrrYrrprvrwr{rrrarr)r`rrhE s*   rhcs^eZdZdZdfdd ZddZdd Zd d Zd d ZfddZ ddZ ddZ Z S)_TypeGuardMetazMetaclass for TypeGuardNFcs(tj|||||d}|dk r$||_|S)N)rZ)r\r(rm)r"r]r^r_rnrZrU)r`rrr( sz_TypeGuardMeta.__new__cCs tddS)Nz+TypeGuard cannot be used with isinstance().)r)rUrVrrrrW sz _TypeGuardMeta.__instancecheck__cCs tddS)Nz+TypeGuard cannot be used with issubclass().)r)rUr"rrrrX sz _TypeGuardMeta.__subclasscheck__cCsbt|}|jdk r*td|jddt|d|jdd}||j|jt|j |ddS)Nz {} cannot be further subscriptedrqz{} accepts only single type.T)rnrZ) rrrmrrtrrsr rrr/)rUrur"rrrrrv s  z_TypeGuardMeta.__getitem__cCs@t|j||}||jkr|St||j|jt|j|jddS)NT)rnrZ)rsrwrmrrrrrr/)rUrxryrzrrrrw s   z_TypeGuardMeta._eval_typecs.t}|jdk r*|dt|j7}|S)Nz[{}])r\r{rmrtrsr|)rUr})r`rrr{ s  z_TypeGuardMeta.__repr__cCstt|j|jfS)N)r~rrrrm)rUrrrr sz_TypeGuardMeta.__hash__cCs,t|dstS|jdk r$|j|jkS||kS)Nrm)rr0rm)rUrrrrr s    z_TypeGuardMeta.__eq__)NF) rrrrYr(rWrXrvrwr{rrrarr)r`rri s  ric@seZdZdZdZdS)rHa Special typing form used to annotate the return type of a user-defined type guard function. ``TypeGuard`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeGuard[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeGuard`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the type inside ``TypeGuard``. For example:: def is_str(val: Union[str, float]): # "isinstance" type guard if isinstance(val, str): # Type of ``val`` is narrowed to ``str`` ... else: # Else, type of ``val`` is narrowed to ``float``. ... Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower form of ``TypeA`` (it can even be a wider form) and this may lead to type-unsafe results. The main reason is to allow for things like narrowing ``List[object]`` to ``List[str]`` even though the latter is not a subtype of the former, since ``List`` is invariant. The responsibility of writing type-safe type guards is left to the user. ``TypeGuard`` also works with type variables. For more information, see PEP 647 (User-Defined Type Guards). N)rrrrYrmrrrrrH s*)NNF)rr contextlibrrscollections.abcrr5rrrrrZPEP_560rrrr rr r r ImportErrorr Z SUBS_TREErrrrr&rr'r+Z _geqv_defined_collections_abc_check_methodsr6rZHAVE_ANNOTATEDextendrZHAVE_PROTOCOLSrRrSrTr[r9rcrdrerfrhrirjr7rlr _SpecialFormrrrrArBrCrrrrrEr;rrrrrrrr>rMutableSequencer<rrrexecr?rMutableMappingr_aliasr=rrrDictrrrrDrFrrIrrrrrOrrrYrtrrrrQrPr@r)rr__text_signature__r(r$rrrrMrLr1r8r?r@rKrJrMrNrGrRrSrTrOrPrUr:rrbrcr8rdrerfrHrgrhrirrrrs                   5 3    4 3    / -                       &  &                      F' "     ,. )6 $b$           f      / *  P 3