관리-도구
편집 파일: properties.cpython-38.pyc
U -?�fzr � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd lm Z dd lm Z dd lm Z dd lm Z dd lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z dd lm Z dd lm!Z! dd l"m#Z# dd l$m%Z% dd l$m&Z& d!d"lm'Z( d!d#lm)Z) d!d$lm*Z* d!d%lm$Z$ d!d&l+m,Z, d!d'l+m-Z- d!d(l.m/Z/ d!d)l0m1Z1 d!d*l0m2Z2 d!d+l3m4Z4 d!d,l5m6Z6 d!d-l5m7Z7 d!d.l5m8Z8 d!d/l5m9Z9 d!d0l5m:Z: d!d1l5m;Z; d!d2l5m<Z< d!d3l5m=Z= e �r dd4l>m?Z? dd5l>m@Z@ dd6l>mAZA dd7l>mBZB dd8lmCZC dd9lDmEZE dd:lFmGZG dd;lHmIZI dd<lJmKZK dd=lJmLZL d!d>lMmNZN d!d?lOmPZP d!d@lOmQZQ d!dAlRmSZS d!dBl5mTZT d!dCl5mUZU edDedE�ZVedFedE�ZWedGdHdE�ZXdIdJdKdLdMgZYe*jZG dNdI� dIe eV e!eV e e*j[��Z\G dOdP� dPe\eV eeV �Z]G dQdR� dRe e eV eeV �Z^dSS )Tz|MapperProperty implementations. This is a private module which defines the behavior of individual ORM- mapped attributes. � )� annotations)�Any)�cast)�Dict)�List)�Optional)�Sequence)�Set)�Tuple)�Type)� TYPE_CHECKING)�TypeVar)�Union� )� attributes)�strategy_options)�_DeclarativeMapped)� class_mapper)�CompositeProperty)�ConcreteInheritedProperty)�SynonymProperty)�_AttributeOptions)�_DEFAULT_ATTRIBUTE_OPTIONS)�_IntrospectsAnnotations)� _MapsColumns)�MapperProperty)�PropComparator)�StrategizedProperty)�RelationshipProperty)�de_stringify_annotation)�de_stringify_union_elements� )�exc)� ForeignKey)�log)�util)� coercions)�roles)�_NoArg)�Column)� SchemaConst)� TypeEngine)�de_optionalize_union_types)� is_fwd_ref)�is_optional_union)� is_pep593)� is_pep695)�is_union)�Self)�typing_get_args)�_IdentityKeyType)� _InstanceDict)�_ORMColumnExprArgument)� _RegistryType)�Mapped)�_ClassScanMapperConfig)�Mapper)�Session)�_InstallLoaderCallableProto)� InstanceState)� _InfoType)� ColumnElement)� NamedColumn)� OperatorType)�_AnnotationScanType)�RODescriptorReference�_T)�bound�_PT�_NCzNamedColumn[Any]�ColumnPropertyr r r r c s� e Zd ZU dZejZdZdZde d< de d< de d < d e d < d Z d d ddd ddd d ddd� dddddddddddddd� � fdd�Z ddddddd d dd d � d d �Z e d!d"�d#d$��Ze d%d"�d&d'��Zdd"�d(d)�Ze�d*d+�d,d"�d-d.��Ze�d*d+�d,d"�d/d0��Zd1d"�d2d3�Ze d1d"�d4d5��Zd6d d7�d8d9�Zd d"�� fd:d;� Zd<d"�d=d>�Zd?d@dAd@dAddBdCd dD� dEdF�ZG dGdH� dHeje e �Z dd"�dIdJ�Z � Z S )KrH z�Describes an object attribute that corresponds to a table column or other column expression. Public constructor is the :func:`_orm.column_property` function. TFzList[NamedColumn[Any]]�columns�bool� _is_polymorphic_discriminator� Optional[str]�_mapped_by_synonymzType[PropComparator[_T]]�comparator_factory)rI �group�deferred� instrumentrN �active_history�expire_on_flush�_creation_orderrK rM Z_deferred_column_loaderZ_raise_column_loaderZ_renders_in_subqueries� raiseloadN) �attribute_optionsrO rP rU rN rR rS �info�doc� _instrument� _assume_readonly_dc_attributesz_ORMColumnExprArgument[_T]z_ORMColumnExprArgument[Any]zOptional[_AttributeOptions]z"Optional[Type[PropComparator[_T]]]zOptional[_InfoType]) �column�additional_columnsrV rO rP rU rN rR rS rW rX rY rZ c s� t � j|| d� |f| }dd� |D �| _|| _|| _|| _| | _|d k rN|n| jj| _ || _ || _ | d k rx| j � | � | d k r�| | _n4t| j�D ]"}t|dd �} | d k r�| | _ q�q�d | _t�| � d| jfd| jff| _| jr�| jd7 _d S )N)rV rZ c S s g | ]}t �tj|��qS � )r& �expectr' ZLabeledColumnExprRole��.0�cr] r] �I/opt/hc_python/lib64/python3.8/site-packages/sqlalchemy/orm/properties.py� <listcomp>� s z+ColumnProperty.__init__.<locals>.<listcomp>rX rP rQ ))rU T)�super�__init__rI rO rP rU rQ � __class__� ComparatorrN rR rS rW �updaterX �reversed�getattrr% �set_creation_order� strategy_key)�selfr[ rV rO rP rU rN rR rS rW rX rY rZ r\ rI �col�rf r] rb re � sD � ��� �zColumnProperty.__init__r9 r7 � Type[Any]�str�Optional[Type[Mapped[Any]]]� Optional[_AnnotationScanType]�None� � decl_scan�registry�cls�originating_module�key�mapped_container� annotation�extracted_mapped_annotation�is_dataclass_field�returnc C s. | j d } | jd kr|| _| jd kr*|| _d S �Nr )rI rz �name) rm rv rw rx ry rz r{ r| r} r~ r[ r] r] rb �declarative_scan� s z ColumnProperty.declarative_scan� Optional[MapperProperty[_T]]�r c C s | S �Nr] �rm r] r] rb �mapper_property_to_assign� s z(ColumnProperty.mapper_property_to_assign� List[Tuple[Column[Any], int]]c C s dd� | j D �S )Nc S s( g | ] }t |t�r|jd kr|df�qS r� )� isinstancer) �tabler_ r] r] rb rc � s �z4ColumnProperty.columns_to_assign.<locals>.<listcomp>�rI r� r] r] rb �columns_to_assign� s �z ColumnProperty.columns_to_assignc C s( d| j kr| jjS d| j kp&| | jjkS )N)Zquery_expressionT)rP T)rl ZstrategyZ_have_default_expression�parentZ_readonly_propsr� r] r] rb �%_memoized_attr__renders_in_subqueries� s �z4ColumnProperty._memoized_attr__renders_in_subquerieszsqlalchemy.orm.statezsqlalchemy.orm.strategiesz _InstallLoaderCallableProto[Any]c C s. t jj}t jj}|j�| jj|�| j �| j �S r� � r% � preloadedZ orm_stateZorm_strategiesr= Z"_instance_level_callable_processorr� Z class_managerZLoadDeferredColumnsrz �rm �stateZ strategiesr] r] rb �&_memoized_attr__deferred_column_loader� s �z5ColumnProperty._memoized_attr__deferred_column_loaderc C s0 t jj}t jj}|j�| jj|�| j d�| j �S )NTr� r� r] r] rb �#_memoized_attr__raise_column_loader� s �z2ColumnProperty._memoized_attr__raise_column_loaderzroles.ColumnsClauseRolec C s | j S )zsAllow the ColumnProperty to work in expression before it is turned into an instrumented attribute. )� expressionr� r] r] rb �__clause_element__ s z!ColumnProperty.__clause_element__c C s | j d S )a� Return the primary column or expression for this ColumnProperty. E.g.:: class File(Base): # ... name = Column(String(64)) extension = Column(String(8)) filename = column_property(name + '.' + extension) path = column_property('C:/' + filename.expression) .. seealso:: :ref:`mapper_column_property_sql_expressions_composed` r r� r� r] r] rb r� s zColumnProperty.expressionz Mapper[Any])�mapperr c C s0 | j s d S tj|j| j| �| |�|| jd� d S )N)Z comparator� parententityrX )rQ r Zregister_descriptor�class_rz rN rX )rm r� r] r] rb �instrument_class% s �z ColumnProperty.instrument_classc sV t � �� t| j�dkrRt| jj��| j�rRt� d| j| jd | jd | j f � d S )Nr z�On mapper %s, primary key column '%s' is being combined with distinct primary key column '%s' in attribute '%s'. Use explicit properties to give each column its own mapped attribute name.r ) rd �do_init�lenrI �setr� Z primary_key� issupersetr% �warnrz r� ro r] rb r� 1 s ���zColumnProperty.do_initzColumnProperty[_T]c C s t | j| j| j| jd��S )N)rP rO rR )rH rI rP rO rR r� r] r] rb �copyA s �zColumnProperty.copyr; zInstanceState[Any]r5 zDict[Any, object]z#Dict[_IdentityKeyType[Any], object]) �session� source_state� source_dict� dest_state� dest_dict�load� _recursive�_resolve_conflict_mapr c C st | j s d S | j|krL|| j } |s.| || j< qp|�| j�} | �||| d � n$|jrp| j|krp|j|| jgdd� d S )NT)Z no_loader)rQ rz Zget_implr� Z has_identityZ_expire_attributes) rm r� r� r� r� r� r� r� r� �value�implr] r] rb �mergeI s �zColumnProperty.mergec @ s� e Zd ZU dZesdZded< ded< ddd�d d �ZerHd d �d d�Zd d �dd�Z dd �dd�Z dd �dd�Z ddd�dd�Z dddd d �d d �Z dddd d �d d!�Zd"S )#zColumnProperty.Comparatora� Produce boolean, comparison, and other operators for :class:`.ColumnProperty` attributes. See the documentation for :class:`.PropComparator` for a brief overview. .. seealso:: :class:`.PropComparator` :class:`.ColumnOperators` :ref:`types_operators` :attr:`.TypeEngine.comparator_factory` )r� rW � expressionsz*RODescriptorReference[ColumnProperty[_PT]]�propzSequence[NamedColumn[Any]]r� rG )r[ r c C sT | j }|||| jjd�}|}| jjr>|}| jj�|�}||d< |�|��d|d��S )a� annotate and possibly adapt a column to be returned as the mapped-attribute exposed version of the column. The column in this context needs to act as much like the column in an ORM mapped context as possible, so includes annotations to give hints to various ORM functions as to the source entity of this column. It also adapts it to the mapper's with_polymorphic selectable if one is present. )Zentity_namespacer� Z parentmapper� proxy_keyZ adapt_columnZorm)Zcompile_state_pluginZplugin_subject)Z _parententityr� rz Z _parentmapperZ_polymorphic_adapter�traverseZ _annotateZ_set_propagate_attrs)rm r[ Zper rn Zmapper_local_colr] r] rb �_orm_annotate_column� s � �z.ColumnProperty.Comparator._orm_annotate_columnzNamedColumn[_PT]r� c C s d S r� r] r� r] r] rb r� � � z,ColumnProperty.Comparator.__clause_element__c C s4 | j r | � | jjd | jj�S | �| jjd �S d S r� )�adapterr� rI rz r� r� r] r] rb �#_memoized_method___clause_element__� s z=ColumnProperty.Comparator._memoized_method___clause_element__r> c C s2 | � � }z|jW S tk r, | jj Y S X dS )z(The .info dictionary for this attribute.N)r� rW �AttributeErrorr� )rm Zcer] r] rb �_memoized_attr_info� s z-ColumnProperty.Comparator._memoized_attr_infoc s6 � j r � fdd�� jjD �S � fdd�� jjD �S dS )z�The full sequence of columns referenced by this attribute, adjusted for any aliasing in progress. .. versionadded:: 1.3.17 c s g | ]}� � |� jj��qS r] )r� r� rz �r` rn r� r] rb rc � s �zHColumnProperty.Comparator._memoized_attr_expressions.<locals>.<listcomp>c s g | ]}� � |��qS r] )r� r� r� r] rb rc � s N)r� r� rI r� r] r� rb �_memoized_attr_expressions� s � �z4ColumnProperty.Comparator._memoized_attr_expressionsrq r )rz r c C s t | �� |�S )z�proxy attribute access down to the mapped column. this allows user-defined comparison methods to be accessed. )rj r� )rm rz r] r] rb �_fallback_getattr� s z+ColumnProperty.Comparator._fallback_getattrrA �ColumnElement[Any]��op�other�kwargsr c O s || � � f|�|�S r� �r� �rm r� r� r� r] r] rb �operate� s z!ColumnProperty.Comparator.operatec K s | � � }||�||�|f|�S r� �r� Z _bind_param�rm r� r� r� rn r] r] rb �reverse_operate� s z)ColumnProperty.Comparator.reverse_operateN)�__name__� __module__� __qualname__�__doc__r � __slots__�__annotations__r� r� r� r� r� r� r� r� r] r] r] rb rg c s ( rg c C s. | j r | jst�| �S t| j jj�d | j S )N�.)r� rz �object�__repr__rq r� r� r� r] r] rb �__str__� s zColumnProperty.__str__)!r� r� r� r� r Z _COLUMN_TOKENZstrategy_wildcard_key� inherit_cacheZ_links_to_entityr� r� re r� �propertyr� r� r� r% �preload_moduler� r� r� r� r� r� r� r� Z MemoizedSlotsr rF rg r� � __classcell__r] r] ro rb rH a sR �.; c @ s e Zd ZdZdZdS )�MappedSQLExpressionaN Declarative front-end for the :class:`.ColumnProperty` class. Public constructor is the :func:`_orm.column_property` function. .. versionchanged:: 2.0 Added :class:`_orm.MappedSQLExpression` as a Declarative compatible subclass for :class:`_orm.ColumnProperty`. .. seealso:: :class:`.MappedColumn` TN)r� r� r� r� r� r] r] r] rb r� � s r� c @ s: e Zd ZU dZdZded< ded< ded< d ed < d ed < d ed< ddd�dd�Zddd�dd�Zedd�dd��Z edd�d d ��Z ed d�d d ��Z d d�d!d"�Z d#ddd$d%�d&d'�Z d#ddd$d%�d(d)�Zdd�d*d+�Zd,d-d.ddd/d0d0dd1d2� d3d4�Ze�d5�d-d.dddd6d1d7�d8d9��Zd.d-d6dd1d:�d;d<�Zd=S )>� MappedColumna_ Maps a single :class:`_schema.Column` on a class. :class:`_orm.MappedColumn` is a specialization of the :class:`_orm.ColumnProperty` class and is oriented towards declarative configuration. To construct :class:`_orm.MappedColumn` objects, use the :func:`_orm.mapped_column` constructor function. .. versionadded:: 2.0 ) r[ rT � _sort_order� foreign_keys� _has_nullable�_has_insert_defaultrP �deferred_group�deferred_raiseloadrR �_attribute_options�_has_dataclass_arguments�_use_existing_columnzUnion[_NoArg, bool]rP rJ r� rL r� � Column[_T]r[ zOptional[Set[ForeignKey]]r� r r� r )�arg�kwc s" |� dt� | _� |� dd�| _� d k oJ� tkoJt� fdd�t� j�D ��| _|� dtj �}|tj k | _ | j rx||d< n� j tj k r�� j |d< |� dd �| _ |� d d �| _ |� d tj �| _|� d d�| _|� d tj �| _td t||��| _| jj| _d|k�o|�d�d tjfk| _t�| � d S )NrV Zuse_existing_columnFc 3 s( | ] \}}|d kr� | t jk V qdS )�dataclasses_defaultN)r( �NO_ARG)r` �i�attr�Z attr_optsr] rb � <genexpr>4 s �z(MappedColumn.__init__.<locals>.<genexpr>�insert_default�defaultr� r� rP rR Z sort_orderr� �nullable)�popr r� r� �any� enumerate�_fieldsr� r( r� r� r� r� r� rP rR r� r r) r[ r� �getr* ZNULL_UNSPECIFIEDr� r% rk )rm r� r� r� r] r� rb re * s< � � �� �zMappedColumn.__init__r2 )r� r c K s� | j �| j �}| jjf |�|_| j|_| j|_| j|_|jj|_| j|_| j |_ | j |_ | j |_ | j |_ | j |_ | j|_t�|� |S r� )rf �__new__r[ �_copyrP r� r� r� rR r� r� r� r� r� r� r% rk )rm r� �newr] r] rb r� Q s zMappedColumn._copyrq r� c C s | j jS r� )r[ r� r� r] r] rb r� b s zMappedColumn.namer� c C sP | j }|tjkr t| jp | j�}|s*| jrHt| j|| j| j| j | jd�S d S d S )N)rP rO rU rV rR ) rP r( r� rJ r� r� rR rH r[ r� )rm Zeffective_deferredr] r] rb r� f s � � z&MappedColumn.mapper_property_to_assignr� c C s | j | jtjk r| jndfgS r� )r[ r� r( r� r� r] r] rb r� z s ���z MappedColumn.columns_to_assignc C s | j S r� )r[ r� r] r] rb r� � s z MappedColumn.__clause_element__rA r� r� c O s || � � f|�|�S r� r� r� r] r] rb r� � s zMappedColumn.operatec K s | � � }||�||�|f|�S r� r� r� r] r] rb r� � s z MappedColumn.reverse_operatec C s t � S r� )r� r� r] r] rb �found_in_pep593_annotated� s z&MappedColumn.found_in_pep593_annotatedr9 r7 rp rr rs rt ru c C s� | j } | jr^|jr^|jr^|jr(t�d��t|jd�} | jd k rD| jn|} | j j � | | � } | _ | j d krn|| _ | jd kr~|| _| j } |d kr�| jr�| j js�| �||� nd S | �||||� d S )Nz3Can't use use_existing_column with deferred mappersF)r[ r� ZinheritsZsingleZ is_deferred�sa_exc� ArgumentErrorr r� Z local_tablera r� rz �type�_isnullr� Z_raise_for_required�_init_column_for_annotation)rm rv rw rx ry rz r{ r| r} r~ r[ Zsupercls_mapperZcolname�sqltyper] r] rb r� � s@ ���� � �z MappedColumn.declarative_scanzsqlalchemy.orm.decl_baserB )rw rx ry rz � param_name�param_annotationr c C s* t jj}|�|| j� | �||||� d S r� )r% r� Z orm_decl_baseZ_undefer_column_namer[ r� )rm rw rx ry rz r� r� � decl_baser] r] rb � declarative_scan_for_composite� s �z+MappedColumn.declarative_scan_for_composite)rx rw �argumentry r c C s | j j}t|t�s t|dd�r:|d k s*t�t|||dd�}t|�rZ|d k sNt�t|||�}t |�}| j sp|| j _ t |�}d }|} t |�r�|j}t|�r�d} t|�} | d } t | �r�t | �} d}| j s�|| j _ | dd � D ]} t| t�r�| } q�q�nd} d } |d k �r^| j�s"|j jd k �r"d | j _|j �| j � | j j}|jtjk �r\| jtjk�r\|j| _|jd k �r|| jd k�r||j| _|jd k �r�| jd k�r�|j| _|j�r�| j�s�d| _|j�r�|j| _|j d k �r�| j tjk�r�|j | _ |j j d k �s |j j d k �r t � dd� |j!�r^t"|j#j$�D ]<\}}|j#| tjk �r |�%d d �}t � d |� d �d� �q |j&�r| j j'�sd }| �r�| | g}n| g}|D ] }|�(|�}|d k �r� �q�q�t|t)��s�t|t��r�t*|t)��r�t+�,d | j j �d|� d���n t+�,d|� d| j j �d���| j �-|� d S )NT)Z check_generic)Zinclude_genericr r Fz_Can't use the 'key' or 'name' arguments in Annotated with mapped_column(); this will be ignoredz2.0.22Z dataclasses_� z Argument 'zp' is a dataclass argument and cannot be specified within a mapped_column() bundled inside of an Annotated objectz The type provided inside the z4 attribute Mapped annotation is the SQLAlchemy type z . Expected a Python type insteadz6Could not locate SQLAlchemy Core type for Python type z inside the z attribute Mapped annotation).r[ r� r� rq r- �AssertionErrorr r1 r r. r� r� r, r0 � __value__r/ r3 r� r� r� �_mergerP r( r� r� r� r� rR r� rz r� r% Zwarn_deprecatedr� r� r� r� �replacer� r� Z _resolve_typer+ � issubclassr� r� Z _set_type)rm rx rw r� ry r� r� Zour_typeZ use_args_fromZour_original_typeZour_type_is_pep593Zpep_593_componentsZraw_pep_593_type�elem�idxr� Z new_sqltypeZchecksZ check_typer] r] rb r� � s� � � � � � � �������� � � ��� �� � ����z(MappedColumn._init_column_for_annotationN)r� r� r� r� r� r� re r� r� r� r� r� r� r� r� r� r� r% r� r� r� r] r] r] rb r� � s0 ' 2 r� N)_r� � __future__r �typingr r r r r r r r r r r r r� r r �baser r Zdescriptor_propsr r r Z interfacesr r r r r r r Z relationshipsr r% r r r" r� r# r$ �sqlr& r' Zsql.baser( Z sql.schemar) r* Z sql.type_apir+ Z util.typingr, r- r. r/ r0 r1 r2 r3 Z_typingr4 r5 r6 r7 r8 r� r9 r� r: r� r; r� r< r= Z sql._typingr> Z sql.elementsr? r@ Z sql.operatorsrA rB rC rD rF rG �__all__Z class_loggerZ IdentifiedrH r� r� r] r] r] rb �<module> s� � � �