+h]-dZddlmZddlmZddlmZddlmZddlm Z e jZ Gdd e Z Gd d e ZGd d e ZGdde ZiZ ddZddZdZdZdZy)zThe :class:`.Annotated` class and related routines; creates hash-equivalent copies of SQL constructs which contain context-specific markers and associations. ) operators) HasCacheKey)anon_map)InternalTraversal)utilc:eZdZeZej dZdZy)SupportsAnnotationsc8t}|j|SN)r_gen_annotations_cache_key)self anon_map_s L/var/www/html/venv/lib/python3.12/site-packages/sqlalchemy/sql/annotation.py_annotations_cache_keyz*SupportsAnnotations._annotations_cache_keysJ ..y99c dtfdt|jDcgc]}||j|fc}DfScc}w)N _annotationsc3pK|]-\}}|t|tr|jgn|f/ywr ) isinstancer_gen_cache_key).0keyvaluers r zASupportsAnnotations._gen_annotations_cache_key..#sC C !%5((26  s36)tuplesortedr)rrrs ` rr z.SupportsAnnotations._gen_annotations_cache_key sZ    &d&7&78#$++C01#    #sA N) __name__ __module__ __qualname__EMPTY_ANNOTATIONSrrmemoized_propertyrr rrr r s$$L ::  rr c>eZdZdejfgZdZdZddZy)SupportsCloneAnnotationsrc|j}|jj||_|jj dd|jj dd|S)greturn a copy of this ClauseElement with annotations updated by the given dictionary. rN_generate_cache_key)_clonerunion__dict__poprvaluesnews r _annotatez"SupportsCloneAnnotations._annotate8sW kkm++11&9 148 .5 rc|j}tj||_|jj dd|jj dd|S)hreturn a copy of this ClauseElement with annotations replaced by the given dictionary. rNr()r)r immutabledictrr+r,r-s r_with_annotationsz*SupportsCloneAnnotations._with_annotationsCsQ kkm--f5 148 .5 rNc|s |jrG|j}tj|_|jj dd|S|S)return a copy of this :class:`_expression.ClauseElement` with annotations removed. :param values: optional tuple of individual values to remove. rN)rr)rr3r+r,)rr.cloner/s r _deannotatez$SupportsCloneAnnotations._deannotateNsL D%%++-C#113C  LL  5t <JKrNF) rrr rdp_annotations_key%_clone_annotations_traverse_internalsr0r4r8r#rrr%r%2s* *==>-)  rr%c eZdZdZdZddZy)SupportsWrappingAnnotationsct||S)r' Annotatedrr.s rr0z%SupportsWrappingAnnotations._annotatec v&&rct||S)r2r?rAs rr4z-SupportsWrappingAnnotations._with_annotationsjrBrNc.|r|j}|S|S)r6)r))rr.r7ss rr8z'SupportsWrappingAnnotations._deannotateqs  AHKrr9)rrr r0r4r8r#rrr=r=bs'' rr=creZdZdZdZdZdZdZdZddZ d Z e d Z d Z d Zd ZdZe dZy)r@aIclones a SupportsAnnotated and applies an 'annotations' dictionary. Unlike regular clones, this clone also mimics __hash__() and __cmp__() 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". Fc|stj|S|\}} t|j}tj|S#t$rt |j|}Y6wxYwr )object__new__annotated_classes __class__KeyError_new_annotation_type)clsargselementr.s rrIzAnnotated.__new__si>>#& &"OGV C'(9(9:>>#& & C*7+<+>> !))""+/*;*;*A*A*C&Cf,U  sA#c R|jjj||fi|Sr )rTrK_compiler_dispatch)rvisitorkws rr^zAnnotated._compiler_dispatchs&:t~~''::4OBOOrc.|jjSr )rT _constructorrs rrbzAnnotated._constructors~~***rc |jjdi|}||jur|S|jj|j|j ||j S)Nr#)rTr)r+updaterKr)rr`r7s rr)zAnnotated._clones[%%%++ DNN "K NN ! !$-- 0>>%):):; ;rcJ|j|j|jffSr )rKrTrrcs r __reduce__zAnnotated.__reduce__s ~~0A0ABBBrc|jSr )rVrcs r__hash__zAnnotated.__hash__s zzrc|jr&|jjj||St |t |k(Sr )_is_column_operatorsrTrK__eq__rU)rothers rrlzAnnotated.__eq__s;  $ $>>++224? ?;$t*, ,rc|d|jvr|jdjS|jjS)Nentity_namespace)rrorTrcs rrozAnnotated.entity_namespaces8 !2!2 2$$%78II I>>22 2r)NT)rrr __doc__rkrIrWr0r4r8r^propertyrbr)rgrirlror#rrr@r@sk&! '#/ P++ <C- 33rr@Nc>ifd||}d|S)zDeep copy the given ClauseElement, annotating each element with the given annotations dictionary. Elements within the exclude collection will be cloned but not annotated. c|d<t|}|vr|Sr.clones%9 !"h * c? " k*++G4!dkk444G D-- -#(:(:%$++8E8R8BB;O..5Ge,! 3rNr#)rPrrrtr7rs ```@@r_deep_annotaters/J0. E Nrc6ifd||}d|S)z2Deep copy the given element, removing annotations.cr t|}n|}|vr,|jd}|j||<|S|S)NT)r.r7rv)rwr8r{)r|r`rr~r7clonedr.s rr7z_deep_deannotate..clone'sZ T(CC f &&fD&AG  # #% # 0!F3KN#; rNr#)rPr.r7rs `@@r_deep_deannotater"s*F . E NrcH|j|}|j|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. )r0r{)rPrs r_shallow_annotater;s% ,G  Nrct|tr|S|tvr t|S|jD]}|tvs t|}nt d|j z||fixt|<}|t d|j z<d|jvr/t|jdtjfgz|_ nJ|jjddr.t|jdtjfgz|_ |jjddrd|_ t|tj|_|S)Nz Annotated%s_traverse_internalsr inherit_cacheFT) issubclassr@rJ__mro__typerglobalsr+listrrr:getrrColumnOperatorsrk)rNbase_clssuper_anno_clss rrMrMHsH#y! ! ! %%++ & &(0H  )- $xor)cX/7GImcll*+ ,'+C,C,C'D .AA BH ( $   /5 1'+C,C,C'D .AA BH ( $  ||/!%$.sI4M4M$NH! OrcPtj|D]}t||yr )rwalk_subclassesrM)target_hierarchyrrNs r_prepare_annotationsrns'##$45,S(+,rr9r )rprbaser traversalsrvisitorsrrr3r!rHr r%r=r@rJrrrrMrr#rrrs  '&D&&( & 6-2-`"5>i3i3b>C*Z2 #L,r