rj7HUdZddlmZddlmZddlZddlmZddlmZddlmZddlm Z dd lm Z dd lm Z dd lm Z dd lm Z dd lmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZer ddlm Z ddlm!Z!e e"efZ#ejHZ%de&d<Gd d!eZ'edZ(Gd"d#e'Z)Gd$d%e)Z*Gd&d'e'Z+iZ,d(e&d)<ed*d!+Z-d6d,Z. d7d-d-dd. d8d/Z/e d7 d9d0Z0e d7 d:d1Z0 d7 d;d2Z0dd5Z3y)?a*The :class:`.Annotated` class and related routines; creates hash-equivalent copies of SQL constructs which contain context-specific markers and associations. Note that the :class:`.Annotated` concept as implemented in this module is not related in any way to the pep-593 concept of "Annotated". ) annotations) itemgetterN)Any)Callable)cast)Dict) FrozenSet)Literal)Mapping)Optional)overload)Sequence)Tuple)Type) TYPE_CHECKING)TypeVar) operators) HasCacheKey)anon_map)ExternallyTraversible)InternalTraversal)util)Self)_EntityNamespace)_TraverseInternalsTypeutil.immutabledict[str, Any]EMPTY_ANNOTATIONSceZdZUdZeZded<ded<ded<ddZe d dd Z e d dd Z d dd Z e jdd Z ddZ y )SupportsAnnotationsr _annotationsz*util.generic_fn_descriptor[FrozenSet[Any]] proxy_setbool _is_immutablectNNotImplementedErrorselfvaluess d/var/www/html/python-recuperauto-other/env/lib/python3.12/site-packages/sqlalchemy/sql/annotation.py _annotatezSupportsAnnotations._annotate?s !##cyr(r"r,r-clones r. _deannotatezSupportsAnnotations._deannotateB r0cyr(r"r2s r.r4zSupportsAnnotations._deannotateI "r0Nctr(r)r2s r.r4zSupportsAnnotations._deannotatePs "##r0c8t}|j|Sr()r_gen_annotations_cache_key)r, anon_map_s r._annotations_cache_keyz*SupportsAnnotations._annotations_cache_keyWsJ ..y99r0c~dtfdt|jjtDfS)Nr#c3pK|]-\}}|t|tr|jgn|f/ywr() isinstancer_gen_cache_key).0keyvaluers r. zASupportsAnnotations._gen_annotations_cache_key..bsE C&e[9,,Xr:"  s36)rB)tuplesortedr#items _get_item0)r,rs `r.r:z.SupportsAnnotations._gen_annotations_cache_key]sB   #)%%++-:#    r0r-_AnnotationDictreturnr..r- Literal[None]r3r%rKrr- Sequence[str]r3r%rKr!NFr-Optional[Sequence[str]]r3r%rKr!)rKTuple[Any, ...])rrrKrT)__name__ __module__ __qualname__ __slots__rr#__annotations__r/r r4rmemoized_propertyr<r:r"r0r.r!r!6sI1BL.B99$!$   !$"""  ""+/$'$$  $ ::     r0r!ceZdZUdZded<erejd dZd dZ d dZ e d ddZ e d ddZ d dd Z y )SupportsWrappingAnnotationsr"z*Callable[..., SupportsWrappingAnnotations] _constructorcyr(r"r,s r.entity_namespacez,SupportsWrappingAnnotations.entity_namespace|s8;r0c.tj||S)greturn a copy of this ClauseElement with annotations updated by the given dictionary.  Annotated_as_annotated_instancer+s r.r/z%SupportsWrappingAnnotations._annotate //f==r0c.tj||S)hreturn a copy of this ClauseElement with annotations replaced by the given dictionary. rcr+s r._with_annotationsz-SupportsWrappingAnnotations._with_annotationsrfr0cyr(r"r2s r.r4z'SupportsWrappingAnnotations._deannotater5r0cyr(r"r2s r.r4z'SupportsWrappingAnnotations._deannotater7r0Nc.|r|j}|S|S)return a copy of this :class:`_expression.ClauseElement` with annotations removed. :param values: optional tuple of individual values to remove. )_clone)r,r-r3ss r.r4z'SupportsWrappingAnnotations._deannotates  AHKr0rKrrIrLrMrOrQrR) rUrVrWrXrYrrro_non_memoized_propertyr`r/rir r4r"r0r.r\r\usI<< & &; ';>>!$   !$"""  ""+/'  r0r\ceZdZUejsdZdejfgZde d<d dZ d dZ e d d dZ e d ddZ d dd Z y )SupportsCloneAnnotationsr"r#r%_clone_annotations_traverse_internalsc|j}|jj||_|jj dd|jj dd|S)rbr<N_generate_cache_key)rnr#union__dict__popr,r-news r.r/z"SupportsCloneAnnotations._annotatesW kkm++11&9 148 .5 r0c|j}tj||_|jj dd|jj dd|S)rhr<Nrv)rnr immutabledictr#rxryrzs r.riz*SupportsCloneAnnotations._with_annotationssQ kkm--f5 148 .5 r0cyr(r"r2s r.r4z$SupportsCloneAnnotations._deannotater5r0cyr(r"r2s r.r4z$SupportsCloneAnnotations._deannotater7r0Nc|s |jrC|j}tj|_|jj dd|S|S)rmr<N)r#rnr EMPTY_DICTrxry)r,r-r3r{s r.r4z$SupportsCloneAnnotations._deannotatesG D%%++-C#C  LL  5t <JKr0rIrLrMrOrQrR)rUrVrWtypingrrXrdp_annotations_keyrtrYr/rir r4r"r0r.rsrss     *==>E)+A  !$   !$"""  ""+/'  r0rscLeZdZUdZdZe ddZded<ded<ded <dd Z dd Z dd Z dd Z e d ddZ e d ddZ d d!dZ ejs d"dZedZd#dZd$dZd%dZd&dZej0d'dZy)(rdaJclones a SupportsAnnotations and applies an 'annotations' dictionary. Unlike regular clones, this clone also mimics __hash__() and __eq__() of the original element so that it takes its place in hashed collections. A reference to the original element is maintained, for the important reason of keeping its hash value current. When GC'ed, the hash value may be reused, causing conflicts. .. note:: The rationale for Annotated producing a brand new class, rather than placing the functionality directly within ClauseElement, is **performance**. The __hash__() method is absent on plain ClauseElement which leads to significantly reduced function call overhead, as the use of sets and dictionaries against ClauseElement objects is prevalent, but most are not "annotated". Fr\c t|j}|||S#t$rt|j|}Y*wxYwr()annotated_classes __class__KeyError_new_annotation_type)clselementr-s r.rez Annotated._as_annotated_instancesI ?#G$5$56C7F## ?&w'8'8#>C ?sAArr#_Annotated__elementint_hashc,tj|Sr()object__new__)rargss r.rzAnnotated.__new__s~~c""r0c|jj|_|jjdd|jjdd||_t j ||_t||_yNr<rv) rxcopyryrrr}r#hashr)r,rr-s r.__init__zAnnotated.__init__!si ((--/  2D9 /6  ..v6'] r0c^|jj|}|j|}|Sr()r#rwri)r,r-_valuesr{s r.r/zAnnotated._annotate+s-##))&1$$W- r0c2|jj|j}|jj|_|jj dd|jj ddt j ||_|Sr)rrrxrryrr}r#r2s r.rizAnnotated._with_annotations0sp&&t~~6++- 3T: 0$7!//7 r0cyr(r"r2s r.r4zAnnotated._deannotate8r5r0cyr(r"r2s r.r4zAnnotated._deannotate?s r0Nc | |jS|jtj|jj Dcic] \}}||vr||c}}Scc}}wr()rrirr}r#rG)r,r-r3rBrCs r.r4zAnnotated._deannotateFsp >>> !))""+/*;*;*A*A*C&Cf,U  sA#c R|jjj||fi|Sr()rr_compiler_dispatch)r,visitorkws r.rzAnnotated._compiler_dispatchZs.>4>>++>>g!# r0c.|jjSr()rr]r_s r.r]zAnnotated._constructor_s>>.. .r0c |jjdi|}||jur|S|jj|j|j ||j S)Nr")rrnrxupdaterr#)r,rr3s r.rnzAnnotated._clonecs[%%%++ DNN "K NN ! !$-- 0>>%):):; ;r0cJ|j|j|jffSr()rrr#r_s r. __reduce__zAnnotated.__reduce__ns ~~0A0ABBBr0c|jSr()rr_s r.__hash__zAnnotated.__hash__qs zzr0c|jr&|jjj||St |t |k(Sr()_is_column_operatorsrr__eq__r)r,others r.rzAnnotated.__eq__ts;  $ $>>++224? ?;$t*, ,r0cd|jvr'tt|jdjS|jjS)Nr`)r#rr\r`rr_s r.r`zAnnotated.entity_namespacezsI !2!2 2+!!"45  >>22 2r0)rr\r-rJrKrd)rz Type[Self]rrrKr)rr\r-rJrIrLrM)r-rPr3r%rKrd)NTrR)rrrrrKr)rrrKr)rKz'Tuple[Type[Annotated], Tuple[Any, ...]])rKr)rrrKr%rp)rUrVrW__doc__r classmethodrerYrrr/rir r4rrrpropertyr]rnrrrrrqr`r"r0r.rdrds\&!$1$;J$ $$/.** J##2# r!|j r|jddi|}n|}r |}nt|}n|}|j d||<|S)Nrr$r3T)r3r_annotations_traversalr") idhasattrr$ intersectionrnr#r&r_copy_internals) elemrid_newelemrrrr3 cloned_idsrexcluders r.r3z_deep_annotate..clones&: !"h * c? " k*++G4!dkk444G D-- -#(:(:)dkk<<< "  +KE(kBG#9#'  " 3r0Nrr!rrrKr!rr)rrrrrrr3rs `````@@r._deep_annotaters7*24J))VsE'N+ E Nr0cyr(r"rr-s r._deep_deannotatersr0cyr(r"rs r.rrs r0cTidfd |tt|}d|S)z2Deep copy the given element, removing annotations.cr t|}n|}|vr-|jd}|jd||<|S|S)NT)r-r3)r3r)rr4r)rrrBrr3clonedr-s r.r3z_deep_deannotate..clones\ T(CC f &&fD&AG  # #% # M!F3KN#; r0Nrr)rr-r3rs `@@r.rrs1 .0F sE'N+ E Nr0cL|j|}|jd|S)a Annotate the given ClauseElement and copy its internals so that internal objects refer to the new annotated object. Basically used to apply a "don't traverse" annotation to a selectable, without digging throughout the whole structure wasting time. T)r)r/r)rrs r._shallow_annotater s* ,G 48 Nr0ct|tr|S|tvr t|S|jD]}|tvs t|}nt t tt d|jz||fixt|<}|td|jz<d|jvr/t|jdtjfgz|_ nJ|jjddr.t|jdtjfgz|_ |jjddrd|_n"d|jvr|jd|_t|t j"|_|S)z[Generates a new class that subclasses Annotated and proxies a given element type. z Annotated%s_traverse_internalsr# inherit_cacheFT) issubclassrdr__mro__rrtyperUglobalsrxlistrrrgetrrColumnOperatorsr)rbase_clssuper_anno_clss r.rrss#y! ! ! %%++ & &(0H  )- Y ]S\\ )Hc?B?)cX/7GImcll*+ ,'+C,C,C'D .AA BH ( $   /5 1'+C,C,C'D .AA BH ( $  ||/!% CLL (!$o!>$.sI4M4M$NH! Or0cPtj|D]}t||yr()rwalk_subclassesr)target_hierarchyrrs r._prepare_annotationsrIs)##$45,S(+,r0)rrrrJrKrr()rrrrJrz'Optional[Sequence[SupportsAnnotations]]rr%rr%rzOOptional[Callable[[SupportsAnnotations, _AnnotationDict], SupportsAnnotations]]rKr)rrNr-rSrKrN)rrr-rSrKr)r Optional[_SA]r-rSrKr)rrrrJrKr)r!Type[SupportsWrappingAnnotations]rType[Annotated]rKr)rrrrrKNone)4r __future__roperatorrrrrrrr r r r r rrrrrr cache_keyrvisitorsrrrr util.typingrbaserrstrrJrrrYr!rHr\rsrdrrrrrrrrr"r0r.rs#  "+'&0#s(#26///A9 /9 x] 7"57tH:HVH3#H3bKe01 &8<E "'#( E E E5E  E ! EE EP >B $;   48 1  ?C $;8 , *,6E,,^,7,, ,r0