)fAddlmZddlZddlmZddlZddlZddlZddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZ ddlmZddlmZddlm Z ddlm!Z!ddlm"Z"ddlm#Z#ddlm$Z$ddlm%Z%dd lm&Z&dd!lm'Z'dd"lm(Z(dd#lm)Z)dd$lm*Z*dd%lm+Z+dd&lm,Z,dd'lm-Z-dd(lm.Z.ed)e *Z/ed+Z0ed,d-Z1ed.d/Z2ed0Z3ed1d-Z4ejjrdd2l6m7Z7ne8dZ7e d3Z9e#Z:e$Z;eee eGd7d8e(e/Z?Gd9d:e(e0e4fZ@e%d;ZAddZB dkd?ZCddd@ dldAZDddB dmdCZEdndDZFddE dodFZGdpdGZHdqdHZIdrdIZJdsdJZKdtdKZLdudLZMdvdMZN dw dxdNZOedydOZPedzdPZPe d{dQZP d{dRZP d|dSZQd}dTZR d~ ddUZSddVZTddWZUddXZV ddYZWddZ dd[ZXdd\ZYGd]d^e(ZZed_eZ*Z[Gd`daee[Z\edbeZdcZ]Gdddeee]Z^edfee dge f*Z_Gdhdiee_Z`y)) annotationsN)Any)Callable)cast)Dict) ForwardRef)Generic)Iterable)Mapping)NewType)NoReturn)Optional)overload)Set)Tuple)Type) TYPE_CHECKING)TypeVar)Union)compatT) Annotated) Concatenate)dataclass_transform)Final)final)get_args) get_origin)Literal) NotRequired) ParamSpec)Protocol) SupportsIndex) TypeAlias) TypedDict) TypeGuard)Self) TypeAliasType_T)bound_KT_KT_co) covariant _KT_contra) contravariant_VT_VT_co)NoneTypeNonezGenericProtocol[Any]ceZdZUdZded<y)ArgsTypeProcotolz_protocol for types that have ``__args__`` there's no public interface for this AFAIK Tuple[_AnnotationScanType, ...]__args__N__name__ __module__ __qualname____doc____annotations__S/var/www/html/flask-app/venv/lib/python3.12/site-packages/sqlalchemy/util/typing.pyr5r5Ts .-r?r5c&eZdZUdZded<ded<y)GenericProtocolzXprotocol for generic types. this since Python.typing _GenericAlias is private r6r7Type[_T] __origin__Nr8r>r?r@rBrB^s .-r?rBceZdZddZddZy)SupportsKeysAndGetItemcyNr>)selfs r@keyszSupportsKeysAndGetItem.keyssr?cyrHr>)rI_SupportsKeysAndGetItem__ks r@ __getitem__z"SupportsKeysAndGetItem.__getitem__urKr?N)returnz Iterable[_KT])rMr+rOr1)r9r:r;rJrNr>r?r@rFrFrs(2r?rF*Fstr_cleanup_fninclude_generic _already_seencl|}t|r |j}t|trr |}t |}rht |r]t |sR t|vr|Sj|tfd|jD}t||S|S)a;Resolve annotations that may be string based into real objects. This is particularly important if a module defines "from __future__ import annotations", as everything inside of __annotations__ is a string. We want to at least have generic containers like ``Mapped``, ``Union``, ``List``, etc. locals_in_classc 3BK|]}t|yw)rQN)de_stringify_annotation).0elemrTclsrSrWoriginating_modulerRs r@ z*de_stringify_annotation..s:   $"- /+    s) is_fwd_ref__forward_arg__ isinstancestreval_expression is_generic is_literalsetaddtupler7_copy_generic_annotation_with) r] annotationr^rWrRrSrToriginal_annotationelementss ` ````` r@rZrZ|s.%*// *c" ' 4FGJ$ *Gc  z ":&  EM  & ' &   j )   #++   -ZBB r?cZt|dr|j|S|j|S)N copy_with)hasattrrorD)rkrms r@rjrjs2z;'##H--$$X..r?rVc tj|j} |Qt |j}|j |j||j|t|||}|St|||} |S#t$r}t d|d||d}~wwxYw#t$r}t d||d}~wwxYw)NModule z9 isn't present in sys.modules; can't evaluate expression z"Could not de-stringify annotation ) sysmodules__dict__KeyError NameErrordict setdefaultr9updateeval Exception) expression module_namerWrX base_globalske cls_namespacerkerrs r@rdrds'*{{;'?'H'H    !2!23M  $ $X%6%6 A   .j-AJ j,@J 1 k]###-, 0  & 0 ?  s5BAB&3 B& B# BB#& C/B>>CrWcJd|vrt|||S tj|j} ||S#t$r}t d|d||d}~wwxYw#t$r?} t j|cYd}~S#t$rYnwxYwt d|d||d}~wwxYw)N.rrrz2 isn't present in sys.modules; can't resolve name zCould not locate name z in module )rdrsrtrurvrwbuiltins)namer~rWrrs r@eval_name_onlyrs  d{t['BB'*{{;'?'H'H  D!! k]# 6 #     $$T* *   $TF+k] C   sJ7A AAA B"$A<6B"< BBBBB"cX t||}t|d|S#t$r|cYSwxYw)Nr9)rgetattrrw)rr~objs r@resolve_name_to_real_class_namers:.T;/sJ--  s  ))rRc ht|jDcgc]}t|||i|c}Scc}w)Nr)make_union_typer7rZ)r]rkr^rWrRannos r@de_stringify_union_elementsrsJ #++  $"-      s/c0|duxrt|tuSrH)typing_get_originrtype_s r@ is_pep593r2s   F!25!9Y!FFr?cht|tjxrt|ttf SrH)rbcollections_abcr rcbytes)rs r@is_non_string_iterabler6s1 c?33 4 Z c5\>:r?c$t|tuSrH)rrrs r@rfrf<s e  ''r?ct|dS)N __supertype__rprs r@ is_newtyper@s 5/ **r?c6t|dxr t|dS)Nr7rDrrs r@rereHs 5* % F'%*FFr?c"t|tSrH)rbr(rs r@ is_pep695rLs e] ++r?cd|j}t|r|j}t|r|SrH)rr)r super_types r@flatten_newtyperPs0$$J Z --  Z r?cxt|try|r't|rtd|jDSy)NTc34K|]}t|dyw)TN)r`)r[args r@r_zis_fwd_ref..]sCS:c4(CsF)rbrreanyr7)r check_generics r@r`r`Ws3%$ :e,CENNCCCr?cyrHr>rs r@de_optionalize_union_typesrbs36r?cyrHr>rs r@rrfs?Br?cyrHr>rs r@rrjsr?ct|r t|St|rGt|j}|j t |j tt|S|S)zmGiven a type, filter out ``Union`` types that include ``NoneType`` to not include the ``NoneType``. ) r`"de_optionalize_fwd_ref_union_types is_optionalrgr7discardr2NoneFwdr)rtyps r@rrpsW%1%88 U %..! H G$$ r?c|j}tjd|}|r|jddk(rt |jdS|jddk(rJtj d|jd}t |Dcgc]}|dk7s t |c}S|Stj d|}d|vr!t d jd |DS|Scc}w) zreturn the non-optional type for Optional[], Union[None, ...], x|None, etc. without de-stringifying forward refs. unfortunately this seems to require lots of hardcoded heuristics z^(.+?)\[(.+)\]$rrrz,\s*r3z\s*\|\s*|c3,K|] }|dk7s |yw)r3Nr>)r[ps r@r_z5de_optionalize_fwd_ref_union_types..s"IQ&[1"Is )rarematchgrouprsplitrjoin)rrkmmrmr\ pipe_tokenss r@rrs&&J $j 1B 88A;* $bhhqk* * XXa[G #xx!5H"/7Jt46>*T"J L((; 3K #(("Ik"IIJJ LKs  C0 C0cHtttj|S)zMake a Union type. This is needed by :func:`.de_optionalize_union_types` which removes ``NoneType`` from a ``Union``. )rrrrN)typess r@rrs U  ' ' ..r?ct|rHt|j}|r|jt|r|ft |zSt |S|fS)zPReturn a type as a tuple of individual types, expanding for ``Union`` types.)is_unionrgr7rr2ri)r include_union discard_noners r@ expand_unionsrsM %..!  KK ! 8eCj( (: xr?ct|dddS)Nrr UnionType is_origin_ofrs r@rrs    r?c>t|xrtt|vSrH)rr2typing_get_argsrs r@is_optional_unionrs u  D(oe.D"DDr?ct|dS)Nrrrs r@rrs w ''r?cZt|}|yt|txr t||S)z[return True if the given type has an __origin__ that shares a base with the given classF)rrbtype issubclass)r class_objorigins r@is_origin_of_clsrs/ u %F ~ fd # E 69(EEr?)modulec~t|}|yt||vxr!|duxs|jj|S)z\return True if the given type has an __origin__ with the given name and optional module.NF)r_get_type_namer: startswith)rrnamesrs r@rrsJ u %F ~ & !U * $>&++66v>r?cvtjr |jSt|dd}| t|dd}|S)Nr9_name)rpy310r9r)rtyp_names r@rrs: ||~~5*d3  ugt4Hr?c$eZdZddZddZddZy)DescriptorProtocyrHr>rIinstanceowners r@__get__zDescriptorProto.__get__rKr?cyrHr>rIrvalues r@__set__zDescriptorProto.__set__rKr?cyrHr>rIrs r@ __delete__zDescriptorProto.__delete__rKr?N)robjectrrrOr)rrrrrOr3rrrOr3)r9r:r;rrrr>r?r@rrs ?=4r?r_DESCc.eZdZdZer ddZddZddZyy) DescriptorReferenceaa descriptor that refers to a descriptor. used for cases where we need to have an instance variable referring to an object that is itself a descriptor, which typically confuses typing tools as they don't know when they should use ``__get__`` or not when referring to the descriptor assignment as an instance variable. See sqlalchemy.orm.interfaces.PropComparator.prop cyrHr>rs r@rzDescriptorReference.__get__rKr?cyrHr>rs r@rzDescriptorReference.__set__rKr?cyrHr>rs r@rzDescriptorReference.__delete__rKr?N)rrrrrOr)rrrrrOr3rr9r:r;r<rrrrr>r?r@rrsEC8 r?r_DESC_co)r*r-c.eZdZdZer ddZddZddZyy) RODescriptorReferenceza descriptor that refers to a descriptor. same as :class:`.DescriptorReference` but is read-only, so that subclasses can define a subtype as the generically contained element cyrHr>rs r@rzRODescriptorReference.__get__(rKr?cyrHr>rs r@rzRODescriptorReference.__set__*rKr?cyrHr>rs r@rz RODescriptorReference.__delete__,rKr?N)rrrrrOr)rrrrrOr )rrrOr rr>r?r@rrsHE< r?r_FN.c.eZdZdZer ddZddZddZyy) CallableReferenceza descriptor that refers to a callable. works around mypy's limitation of not allowing callables assigned as instance variables cyrHr>rs r@rzCallableReference.__get__=rKr?cyrHr>rs r@rzCallableReference.__set__?rKr?cyrHr>rs r@rzCallableReference.__delete__ArKr?N)rrrrrOr)rrrrrOr3rrr>r?r@rr2sCA8 r?r)r] Type[Any]rk_AnnotationScanTyper^rcrWMapping[str, Any]rR#Optional[Callable[[str, str], str]]rSboolrTzOptional[Set[Any]]rOr)rkzGenericProtocol[_T]rmr6rOrC) r}rcr~rcrWOptional[Mapping[str, Any]]rXzOptional[Type[Any]]rOr)rrcr~rcrWrrOr)rrcr~rcrOrc) r]rrkr5r^rcrWrrRrrOr)rOptional[_AnnotationScanType]rOr)rrrOzTypeGuard[Iterable[Any]])rrrOr)rrrOzTypeGuard[NewType])rrrOzTypeGuard[GenericProtocol[Any]])rrrOzTypeGuard[TypeAliasType])rr rOr)F)rrrrrOzTypeGuard[ForwardRef])rrcrOrc)rrrOr)rrrOr)rrrOr)rrrOr)FF)rrrrrrrOzTuple[Type[Any], ...])rrrOzTypeGuard[ArgsTypeProcotol])rrrOr)rrrz'Union[Tuple[Type[Any], ...], Type[Any]]rOr)rrrrcrz Optional[str]rOr)rrrOrc)a __future__rrcollections.abcabcrrrstypingrrrrrr r r r r rrrrrrrrrtyping_extensionsrrrrrrrrr r!r"r#r$r%r&r'r(r)r+r,r.r0r1rrr2rrrrrcrr5rBrF _LiteralStarrZrjrdrrrrrrfrrerrr`rrrrrrrrrrrrrrrrrr>r?r@rsJ#)  8<106:4<86@888.@ T en T * \ 6  en T * <<+DzH V IsJ8NN .x.hrl(3Xc6k23s| ;?!(,C C#CC C 8 CC&CCL/#//N/ /,0$( !!!) ! " !  !P,0  )   D.;?     8 ,G (+G,7< /3 6 6 B B     . >/IN %)AE(E( F  FB F  F6:    %2   5h5 /9'%.9( :_ E=GH-="e8HS#X$6789 9r?