1jE d d Z ddlmZ ddlmZ G d de Zi Zd
dZd
d Zd
Z d Z
d Z dS )zThe :class:`.Annotated` class and related routines; creates hash-equivalent
copies of SQL constructs which contain context-specific markers and
associations.
) operators )utilc f e Zd ZdZd Zd Zd Zd ZddZd Z e
d
Z d Z d Z
d
Zd ZdS ) AnnotatedaE clones a ClauseElement 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".
c |st | S |\ }} t |j } n%# t $ r t |j | } Y nw xY wt | S N)object__new__annotated_classes __class__KeyError_new_annotation_type)clsargselementvaluess P/opt/cloudlinux/venv/lib64/python3.11/site-packages/sqlalchemy/sql/annotation.pyr zAnnotated.__new__& s '>>#&& & "OGV
C'(9:
C
C
C*7+>#&& &s 6 AAc |j | _ || _ || _ t | | _ d S r )__dict__copy_Annotated__element _annotationshash_hash)selfr r s r __init__zAnnotated.__init__4 s8 (--//
"']]
c | j }| | | | S r )r r update_with_annotations)r r _valuess r _annotatezAnnotated._annotate: s< #((**v %%g...r c | j | j }| j |_ ||_ |S r )r
r r r r )r r clones r r! zAnnotated._with_annotations? s; &&t~66 ++-- # r NTc || j S | j }|D ]}| |d | | S r )r r r popr! )r r r% r" vs r _deannotatezAnnotated._deannotateE s] >> !',,..G
%
% At$$$$))'22 2r c 4 | j j j | |fi |S r )r r
_compiler_dispatch)r visitorkws r r+ z Annotated._compiler_dispatchN s$ :t~':4OOBOOOr c | j j S r )r _constructorr s r r/ zAnnotated._constructorQ s
~**r c | j }|| j u r| S |j | j | || j S r )r _cloner r r
r )r r% s r r2 zAnnotated._cloneU sX %%'' DN " "K
N ! !$- 0 0 0>>%):;; ;r c , | j | j | j ffS r )r
r r r0 s r
__reduce__zAnnotated.__reduce__` s ~0A BBBr c | j S r )r r0 s r __hash__zAnnotated.__hash__c s
zr c t | j t j r | j j | | S t
| t
| k S r )
isinstancer r ColumnOperatorsr
__eq__r )r others r r: zAnnotated.__eq__f sK dni&? @ @ ->+224?? ?;;$t**, ,r )NT)__name__
__module__ __qualname____doc__r r r# r! r) r+ propertyr/ r2 r4 r6 r: r r r r s & ' ' ' # # # / / /
3 3 3 3P P P + + X+ < < <C C C - - - - -r r Nc 8 fd| | } 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 r?t | d r/| j r| }n#| j k r| }n| }| |S )N proxy_setr% )hasattrrD intersectionr2 r r# _copy_internals)elemnewelem annotationsr% excludes r r% z _deep_annotate..clone{ s k** ++G44
kkmmGG
D -
-
-nn[11GGG e ,,,r NrA )r rK rL r% s ``@r _deep_annotaterM s sG %.. E Nr c ^ t j fd| | } d| S )z2Deep copy the given element, removing annotations.c s| vr6| d }| s|| < |S | S )NT)r r% rE )r) rH )rI rJ r% clonedr s r r% z _deep_deannotate..clone sf T''&&fD&AAG # #% # 0 0 0
' &t N$< r N)r column_dict)r r r% rP s `@@r _deep_deannotaterR sW
F %.. E Nr c X | | } | | 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 "dont traverse" annotation to a
selectable, without digging throughout the whole
structure wasting time.
)r# rH )r rK s r _shallow_annotaterT s. ,,G Nr c t | t r| S | t v r
t | S | j D ]}|t v rt | } nt d| j z || fi xt | < }|t
d| j z < |S )Nz Annotated%s)
issubclassr r __mro__typer< globals)r base_clssuper_anno_clss r r r s #y!! &
! ! ! %%+ & & &(0H E ' )- $xor) ) cX /7GIImcl*+ Or c | g}|rO| }| | t || |Md S d S r )r' extend__subclasses__r )target_hierarchyrZ stackr s r _prepare_annotationsrb sk
E
,iikk
S''))*** S(+++ , , , , ,r r ) r? r r r
r r rM rR rT r rb rA r r rd s X- X- X- X- X- X- X- X-| 8 6
*, , , , ,r