관리-도구
편집 파일: annotation.cpython-38.pyc
U -?�fEG � @ s\ U d Z ddlmZ ddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd lm Z dd lm Z dd lm Z dd lm Z dd lm Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z e�r4ddl m Z dd lm Z e e ef Z!ej"Z#d e$d < G d d � d e�Z%G d!d"� d"e%�Z&G d#d$� d$e&�Z'G d%d&� d&e%�Z(i Z)d'e$d(< ed)d d*�Z*d)d+d)d,�d-d.�Z+dKd/d/dd0�d)d+d1d2d2d3d)d4�d5d6�Z,e dLd7d8d7d9�d:d;��Z-e dMd)d8d)d9�d<d;��Z-dNd=d8d=d9�d>d;�Z-d)d+d)d?�d@dA�Z.dBdCdCdD�dEdF�Z/dBdCdGdH�dIdJ�Z0dS )Oa* 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". � )� annotationsN)�Any)�Callable)�cast)�Dict)� FrozenSet)�Mapping)�Optional)�overload)�Sequence)�Tuple)�Type)� TYPE_CHECKING)�TypeVar� )� operators)� HasCacheKey��anon_map)�ExternallyTraversible)�InternalTraversal� )�util)�Literal)�Self)�_EntityNamespace)�_TraverseInternalsType� util.immutabledict[str, Any]�EMPTY_ANNOTATIONSc @ s� e Zd ZU dZeZded< ded< ded< dd d �d d �Zed ddd d�dd��Z ed!ddd d�dd��Z d"ddd d�dd�Z e j dd�dd��Z d dd �d d �Z dS )#�SupportsAnnotations� r � _annotationsz*util.generic_fn_descriptor[FrozenSet[Any]]� proxy_set�bool� _is_immutable�_AnnotationDictr ��values�returnc C s t � �d S �N��NotImplementedError��selfr' r r �I/opt/hc_python/lib64/python3.8/site-packages/sqlalchemy/sql/annotation.py� _annotate> s z SupportsAnnotations._annotate.� Literal[None]�r' �cloner( c C s d S r) r �r- r' r2 r r r. � _deannotateA s z SupportsAnnotations._deannotate� Sequence[str]c C s d S r) r r3 r r r. r4 H s NF�Optional[Sequence[str]]c C s t � �d S r) r* r3 r r r. r4 O s zTuple[Any, ...]�r( c C s t � }| �|�S r) )r �_gen_annotations_cache_key)r- Z anon_map_r r r. �_annotations_cache_keyV s z*SupportsAnnotations._annotations_cache_keyr )r r( c s. dt � fdd��fdd�t�j�D �D ��fS )Nr! c 3 s0 | ](\}}|t |t�r"|�� g �n|fV qd S r) )� isinstancer Z_gen_cache_key��.0�key�valuer r r. � <genexpr>a s ���zASupportsAnnotations._gen_annotations_cache_key.<locals>.<genexpr>c s g | ]}|� j | f�qS r )r! )r< r= �r- r r. � <listcomp>j s �zBSupportsAnnotations._gen_annotations_cache_key.<locals>.<listcomp>)�tuple�sortedr! )r- r r )r r- r. r8 \ s ���z.SupportsAnnotations._gen_annotations_cache_key)..)..)NF)�__name__� __module__� __qualname__� __slots__r r! �__annotations__r/ r r4 r Zmemoized_propertyr9 r8 r r r r. r 5 s& � � �r c @ s� e Zd ZU dZded< er.ejdd�dd��Zdd d �d d �Z dd d �d d�Z e d ddd d�dd��Z e d dddd�dd��Z d dddd�dd�Z dS ) �SupportsWrappingAnnotationsr z*Callable[..., SupportsWrappingAnnotations]� _constructorr r7 c C s d S r) r r@ r r r. �entity_namespacey s z,SupportsWrappingAnnotations.entity_namespacer% r r& c C s t �| |�S )�greturn a copy of this ClauseElement with annotations updated by the given dictionary. �� Annotated�_as_annotated_instancer, r r r. r/ | s z%SupportsWrappingAnnotations._annotatec C s t �| |�S )�hreturn a copy of this ClauseElement with annotations replaced by the given dictionary. rM r, r r r. �_with_annotations� s z-SupportsWrappingAnnotations._with_annotations.r0 r# r1 c C s d S r) r r3 r r r. r4 � s z'SupportsWrappingAnnotations._deannotater5 r c C s d S r) r r3 r r r. r4 � s NFr6 c C s |r| � � }|S | S dS )��return a copy of this :class:`_expression.ClauseElement` with annotations removed. :param values: optional tuple of individual values to remove. N)�_clone)r- r' r2 �sr r r. r4 � s )..)..)NF) rD rE rF rG rH r r �ro_non_memoized_propertyrK r/ rQ r r4 r r r r. rI r s$ � � �rI c @ s� e Zd ZU ejsdZdejfgZde d< ddd�dd �Z ddd�d d �Z e dd ddd�dd��Z e ddddd�dd��Z ddddd�dd�Z dS ) �SupportsCloneAnnotationsr r! r �%_clone_annotations_traverse_internalsr% r r& c C s6 | � � }|j�|�|_|j�dd� |j�dd� |S )rL r9 N�_generate_cache_key)rS r! �union�__dict__�pop�r- r' �newr r r. r/ � s z"SupportsCloneAnnotations._annotatec C s4 | � � }t�|�|_|j�dd� |j�dd� |S )rP r9 NrX )rS r � immutabledictr! rZ r[ r\ r r r. rQ � s z*SupportsCloneAnnotations._with_annotations.r0 r# r1 c C s d S r) r r3 r r r. r4 � s z$SupportsCloneAnnotations._deannotater5 r c C s d S r) r r3 r r r. r4 � s NFr6 c C s6 |s | j r.| �� }t�� |_ |j�dd� |S | S dS )rR r9 N)r! rS r r^ rZ r[ )r- r' r2 r] r r r. r4 � s )..)..)NF)rD rE rF �typingr rG r �dp_annotations_keyrW rH r/ rQ r r4 r r r r. rV � s" � � � �rV c @ s> e Zd ZU dZdZeddd d�dd��Zded < ded < d ed < d ddd�dd�Zddd�dd�Z ddd�dd�Z ddd�dd�Z e d<d d dd �d d ��Z e d=d!d d d �d"d ��Z d>d%d d&d �d'd �Z ejs�dddd(�d)d*�Zed+d,� �Zddd-�d.d/�Zd0d1�d2d3�Zd d1�d4d5�Zdd d6�d7d8�Zejd9d1�d:d;��Zd#S )?rN aJ clones 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". FrI r% ��elementr' r( c C s: zt |j } W n tk r. t|j| �} Y nX | ||�S r) )�annotated_classes� __class__�KeyError�_new_annotation_type)�clsrb r' r r r. rO s z Annotated._as_annotated_instancer r! �_Annotated__element�int�_hashz Type[Self]r r )rg �argsr( c G s t �| �S r) )�object�__new__)rg rk r r r. rm s zAnnotated.__new__�rb r' c C sH |j �� | _ | j �dd � | j �dd � || _t�|�| _t|�| _d S �Nr9 rX ) rZ �copyr[ rh r r^ r! �hashrj )r- rb r' r r r. �__init__ s zAnnotated.__init__r& c C s | j �|�}| �|�}|S r) )r! rY rQ )r- r' Z_valuesr] r r r. r/ ( s zAnnotated._annotatec C sF | j �| j �}| j�� |_|j�dd � |j�dd � t�|�|_|S ro )rd rm rZ rp r[ r r^ r! r3 r r r. rQ - s zAnnotated._with_annotations.r0 r# r1 c C s d S r) r r3 r r r. r4 5 s zAnnotated._deannotater5 c C s d S r) r r3 r r r. r4 < s NTr6 r c s6 � d kr| j S | �t�� fdd�| j�� D ���S d S )Nc s i | ]\}}|� kr||�qS r r r; �r' r r. � <dictcomp>M s � z)Annotated._deannotate.<locals>.<dictcomp>)rh rQ r r^ r! �itemsr3 r rs r. r4 C s ���)�visitor�kwr( c K s | j jj| |f|�S r) )rh rd �_compiler_dispatch)r- rv rw r r r. rx W s ��z Annotated._compiler_dispatchc C s | j jS r) )rh rJ r@ r r r. rJ \ s zAnnotated._constructor)rw r( c K s< | j jf |�}|| j kr | S |j�| j� | �|| j�S d S r) )rh rS rZ �updaterd r! )r- rw r2 r r r. rS ` s zAnnotated._clonez'Tuple[Type[Annotated], Tuple[Any, ...]]r7 c C s | j | j| jffS r) )rd rh r! r@ r r r. � __reduce__k s zAnnotated.__reduce__c C s | j S r) )rj r@ r r r. �__hash__n s zAnnotated.__hash__)�otherr( c C s* | j r| jj�| |�S t|�t| �kS d S r) )�_is_column_operatorsrh rd �__eq__rq )r- r| r r r. r~ q s zAnnotated.__eq__r c C s( d| j kr tt| j d �jS | jjS d S )NrK )r! r rI rK rh r@ r r r. rK w s �zAnnotated.entity_namespace)..)..)NT)rD rE rF �__doc__r} � classmethodrO rH rm rr r/ rQ r r4 r_ r rx �propertyrJ rS rz r{ r~ r rU rK r r r r. rN � s@ � � � rN z8Dict[Type[SupportsWrappingAnnotations], Type[Annotated]]rc �_SA)�boundr% )� to_annotater r( c C s0 z | j }W n tk r" | Y S X ||�S d S r) )r/ �AttributeError)r� r r/ r r r. �_safe_annotate� s r� F)�detect_subquery_cols�ind_cols_on_fromclause�annotate_callablez'Optional[Sequence[SupportsAnnotations]]r# zOOptional[Callable[[SupportsAnnotations, _AnnotationDict], SupportsAnnotations]])rb r �excluder� r� r� r( c sD i �dddd�� ������fdd� �| dk r<t t�| ��} d�| S )z�Deep copy the given ClauseElement, annotating each element with the given annotations dictionary. Elements within the exclude collection will be cloned but not annotated. r r ��elemrw r( c s� �|d< t | �}|�kr �| S �rPt| d�rP| j���rP| jf d�i|��}nN�| jkr��rz| jrz| jf d�i|��}n| }� r�� |��}q�t|��}n| }|j��d� |�|< |S )Nr� r" r2 )r2 r� ) �id�hasattrr" � intersectionrS r! r$ r� �_copy_internals)r� rw Zid_�newelemr� �r� r r2 Z cloned_idsr� r� r� r r. r2 � s2 �� � �z _deep_annotate.<locals>.cloneN�r r� )rb r r� r� r� r� r r� r. �_deep_annotate� s ")r� r0 r6 ra c C s d S r) r rn r r r. �_deep_deannotate� s r� c C s d S r) r rn r r r. r� � s z Optional[_SA]c s< i �dddd�� ��fdd� � | dk r4t t� | ��} d� | S )z2Deep copy the given element, removing annotations.r r r� c sL �rt | �}n| }|�kr@| j�dd�}|j� d� |�|< |S �| S d S )NT)r' r2 )r2 )r� r4 r� )r� rw r= r� �r2 Zclonedr' r r. r2 � s z _deep_deannotate.<locals>.cloneNr� rn r r� r. r� � s )rb r r( c C s | � |�} | �� | 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. )r/ r� )rb r r r r. �_shallow_annotate s r� z!Type[SupportsWrappingAnnotations]zType[Annotated])rg �base_clsr( c C s� t | t�r| S | tkr t| S | jD ]}|tkr$t| } q>q$ttt td| j || fi �� t| < }|t� d| j < d| j kr�t | j �dt j fg |_ n&| j �dd�r�t | j �dt j fg |_ | j �dd�r�d|_nd| j kr�| j d |_t | tj�|_|S )z[Generates a new class that subclasses Annotated and proxies a given element type. z Annotated%s�_traverse_internalsr! � inherit_cacheFT)� issubclassrN rc �__mro__r r �typerD �globalsrZ �listr� r r` �getr� r ZColumnOperatorsr} )rg r� Zsuper_Zanno_clsr r r. rf s6 � � � rf �None)�target_hierarchyr� r( c C s t �| �D ]}t||� q d S r) )r Zwalk_subclassesrf )r� r� rg r r r. �_prepare_annotationsD s r� )N)N)N)N)1r � __future__r r_ r r r r r r r r r r r r r � r � cache_keyr Zvisitorsr r r r Z util.typingr r �baser r �strr% � EMPTY_DICTr rH r rI rV rN rc r� r� r� r� r� rf r� r r r r. �<module> sl =:K � �� F � � � /