관리-도구
편집 파일: base.cpython-38.pyc
U -?�fJk � @ s d Z ddlmZ ddlmZ ddlZddlZddlmZ ddlmZ ddlm Z ddlm Z dd lm Z dd lm Z dd lm Z dd lmZ dd lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m Z ddl m Z ddlm Z ddl m!Z! dd l"m#Z# ej�r�dd lm$Z$ dd lm%Z% dd lm&Z& dd l'm(Z( dd!l)m*Z* dd"l+m,Z, dd#l-m.Z. dd$l/m0Z0 dd%l1m2Z2 dd&lm3Z3 dd'l4m5Z5 dd(l6m7Z7 dd)l6m8Z8 dd*l m9Z9 dd+l:m;Z; ed,ed-�Z<ed.ed/d0�Z=ed1e>d-�Z?G d2d3� d3e�Z@eAe@�\ZBZCZDZEZFeFZGG d4d5� d5e �ZHeHjI�J� \ZKZLZMZNZOZPZQZRZSZTZUZVZWZXZYZZZ[Z\d6Z]d7Z^G d8d9� d9e�Z_eAe_�\Z`ZaZbZcG d:d;� d;e�ZdeAed�\ZeZfZgG d<d=� d=e�ZhG d>d?� d?eh�ZiejeGg�ZkejdeGeBg�Zle�md@�Zne�mdA�Zoe�mdB�ZpedCedDef d-�ZqedE�ZrdFdGdH�dIdJ�Zse�r�dKdLdM�dNdO�Zte dPdQdM�dRdS��Zue dTdUdM�dVdS��ZudTdUdM�dWdS�Zud1dXdY�dZd[�Zvd\d]dY�d^d_�Zwn$d`dO� ZtdadS� Zue�xe^�Zve�xdb�Zwd\dcdY�ddde�Zydfdcdg�dhdi�Zzdfdcdg�djdk�Z{d\dcdcdl�dmdn�Z|dfdcdcdo�dpdq�Z}d,drdY�dsdt�Z~d,dudY�dvdw�Ze��e>�d,dxdY�dydz��Z�d{drd|�d}d~�Z�dd�d��d�d��Z�dFd�d��d�d��Z�dFd�d��d�d��Z�e d�dcdFd��d�d���Z�e�r�dXd�dg�d�d��Z�n e��d��Z�d�dKd�d�d��d�d��Z�d�d�d��d�d��Z�d�dKd�d�d��d�d��Z�G d�d�� d��Z�G d�d�� d�e��Z�G d�d�� d�e e= e!�Z�G d�d�� d�e e= e!�Z�G d�d�� d�e e= e!�Z�G d�d�� d�e�e= e e= e!�Z�G d�d�� d�e�e= e�e= e�e= ej��Z�G d�d�� d�e e= e!�Z�G d�d�� d�e�e= e�e= �Z�G d�d�� d�e�e= �Z�G d�d�� d�e�e= �Z�dS )�z=Constants and rudimental functions used throughout the ORM. � )� annotations)�EnumN)�Any)�Callable)�Dict)�Generic)� no_type_check)�Optional)�overload)�Tuple)�Type)� TYPE_CHECKING)�TypeVar)�Union� )�exc)�insp_is_mapper� )� inspection)�util)�roles)�SQLColumnExpression)�SQLCoreOperations)� FastIntFlag)� TypingOnly)�Literal)� _EntityType)�_ExternalEntityType)�_InternalEntityType)�InstrumentedAttribute)� AppenderQuery)� ClassManager)�PropComparator)�Mapper)� InstanceState)� AliasedClass)�WriteOnlyCollection)�_ColumnExpressionArgument)� _InfoType)� ColumnElement)� OperatorType�_T)�bound�_T_coT)r, � covariant�_Oc @ s$ e Zd ZdZdZdZdZdZeZdS )�LoaderCallableStatusr r r � � N) �__name__� __module__� __qualname__�PASSIVE_NO_RESULT�PASSIVE_CLASS_MISMATCH� ATTR_WAS_SET� ATTR_EMPTY�NO_VALUE� NEVER_SET� r< r< �C/opt/hc_python/lib64/python3.8/site-packages/sqlalchemy/orm/base.pyr0 A s r0 c @ s� e Zd ZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zee B eB eB eB ZeeA ZeeA ZeeA ZeeA Zee A Zee B Zd S )� PassiveFlagz;Bitflag interface that passes options onto loader callablesr r r r2 � � � �@ � � i N)r3 r4 r5 �__doc__� NO_CHANGE� CALLABLES_OK�SQL_OK�RELATED_OBJECT_OK�INIT_OK�NON_PERSISTENT_OK�LOAD_AGAINST_COMMITTED� NO_AUTOFLUSH�NO_RAISE�DEFERRED_HISTORY_LOAD�INCLUDE_PENDING_MUTATIONS� PASSIVE_OFF�PASSIVE_RETURN_NO_VALUE�PASSIVE_NO_INITIALIZE�PASSIVE_NO_FETCH�PASSIVE_NO_FETCH_RELATED�PASSIVE_ONLY_PERSISTENT� PASSIVE_MERGEr< r< r< r= r> p s* �r> Z_sa_class_managerZ_sa_instance_statec @ s e Zd ZdZdZdZdZdS )�EventConstantsr r r1 r2 N)r3 r4 r5 � EXT_CONTINUE�EXT_STOP�EXT_SKIP�NO_KEYr< r< r< r= rX � s rX c @ s e Zd ZdZdZdZdZdS )�RelationshipDirectionz�enumeration which indicates the 'direction' of a :class:`_orm.RelationshipProperty`. :class:`.RelationshipDirection` is accessible from the :attr:`_orm.Relationship.direction` attribute of :class:`_orm.RelationshipProperty`. r r r1 N)r3 r4 r5 rE � ONETOMANY� MANYTOONE� MANYTOMANYr< r< r< r= r] � s r] c @ s e Zd ZdZdS )�InspectionAttrExtensionTypezXSymbols indicating the type of extension that a :class:`.InspectionAttr` is part of.N)r3 r4 r5 rE r< r< r< r= ra s ra c @ s e Zd ZdZdS )� NotExtensionZ not_extensionN)r3 r4 r5 � NOT_EXTENSIONr< r< r< r= rb s rb ZSET_DEFERRED_EXPIREDZDEFER_FOR_STATEZRAISE_FOR_STATE�_F.�_Selfr zCallable[[_F], _F])� assertions�returnc s$ t jdddddd�� fdd� �}|S )Nrd re r )�fn�self�args�kwrg c s* � D ]}||| j � q| |f|�|� |S �N)r3 )rh ri rj rk Z assertion�rf r< r= �generate, s z _assertions.<locals>.generate)r � decorator)rf rn r< rm r= � _assertions) s rp zType[_O]zClassManager[_O])�clsrg c C s d S rl r< �rq r< r< r= �manager_of_class8 � rs zAliasedClass[Any]�Nonec C s d S rl r< rr r< r< r= �opt_manager_of_class: s rv z_ExternalEntityType[_O]zOptional[ClassManager[_O]]c C s d S rl r< rr r< r< r= rv = s c C s d S rl r< rr r< r< r= rv B s zInstanceState[_O]��instancerg c C s d S rl r< �rx r< r< r= �instance_stateF rt rz �objectzDict[str, Any]c C s d S rl r< ry r< r< r= � instance_dictH rt r| c C sH z | j t W S tk rB } zt�| d| � ��|�W 5 d }~X Y nX d S )Nz2Can't locate an instrumentation manager for class )�__dict__�DEFAULT_MANAGER_ATTR�KeyErrorr �UnmappedClassError)rq Zker< r< r= rs N s ��c C s | j �t�S rl )r} �getr~ rr r< r< r= rv V s r} �strc C s t t| ��S )z'Return a string describing an instance.)� state_strrz ry r< r< r= � instance_str^ s r� zInstanceState[Any])�staterg c C s( | dkr dS d| j jt| �� �f S dS )z=Return a string describing an instance via its InstanceState.Nru z <%s at 0x%x>)�class_r3 �id�obj�r� r< r< r= r� d s r� c C s | dkr dS d| j jf S dS )zNReturn a string describing an instance's class via its InstanceState. Nru z<%s>)r� r3 r� r< r< r= �state_class_strm s r� )rx � attributerg c C s t | �d | S �N�.)r� )rx r� r< r< r= � attribute_strx s r� )r� r� rg c C s t | �d | S r� )r� )r� r� r< r< r= �state_attribute_str| s r� z Mapper[_T]c C s t | �jS )a� Given an object, return the primary Mapper associated with the object instance. Raises :class:`sqlalchemy.orm.exc.UnmappedInstanceError` if no mapping is configured. This function is available via the inspection system as:: inspect(instance).mapper Using the inspection system will raise :class:`sqlalchemy.exc.NoInspectionAvailable` if the instance is not part of a mapping. )� object_state�mapperry r< r< r= � object_mapper� s r� zInstanceState[_T]c C s$ t | �}|dkr t�| ��n|S dS )a� Given an object, return the :class:`.InstanceState` associated with the object. Raises :class:`sqlalchemy.orm.exc.UnmappedInstanceError` if no mapping is configured. Equivalent functionality is available via the :func:`_sa.inspect` function as:: inspect(instance) Using the inspection system will raise :class:`sqlalchemy.exc.NoInspectionAvailable` if the instance is not part of a mapping. N)�_inspect_mapped_objectr ZUnmappedInstanceError)rx r� r< r< r= r� � s r� zOptional[InstanceState[_T]]c C s0 z t | �W S tjftj k r* Y d S X d S rl )rz r r� �NO_STATEry r< r< r= r� � s r� zUnion[Mapper[_T], Type[_T]])�class_or_mapperrg c C s6 t �| d�}|d k r|jS t| t�s(t�t�| ��d S )NF)r �inspectr� � isinstance�type�AssertionErrorr r� )r� �inspr< r< r= �_class_to_mapper� s r� z(Union[Type[_T], _InternalEntityType[_T]]zOptional[Mapper[_T]])�entityrg c C s" t �| d�}|dk r|jS dS dS )z`Return the :class:`_orm.Mapper` for the given class or None if the class is not mapped. FN)r r� r� �r� r� r< r< r= �_mapper_or_none� s r� �boolc C s( t �| d�}|dk o&|j o&|jp&|jS )zlReturn True if the given object is a mapped class, :class:`_orm.Mapper`, or :class:`.AliasedClass`. FN)r r� �is_clause_element� is_mapper�is_aliased_classr� r< r< r= �_is_mapped_class� s � �r� c C s t �| d�}|d k o t|dd�S )NFr� )r r� �getattrr� r< r< r= �_is_aliased_class� s r� �_EntityType[Any])r� �keyrg c C s� t �| �}|jr | }|j} n.|jr.|j} | }n t|d�rF|jj }} n| }z t | |�W S t k r� } zt � d||f �|�W 5 d}~X Y nX dS )z�Return a class attribute given an entity and string name. May return :class:`.InstrumentedAttribute` or user-defined attribute. r� z Entity '%s' has no property '%s'N) r r� � is_selectable�cr� r� �hasattrr� r� r� �AttributeError�sa_excZInvalidRequestError)r� r� r� � description�errr< r< r= �_entity_descriptor� s$ ��r� z Mapper[_O]c C s d S rl r< r� r< r< r= � _state_mapper� rt r� zmanager.mapperFzOptional[Mapper[_O]])r� � configurerg c C sT z&t | �}|d ks|js W d S |j}W n tjk r> Y d S X |rL|�� |S d S rl )rv Z is_mappedr� r r� Z_check_configure)r� r� Z class_managerr� r< r< r= �_inspect_mapped_class s r� zUnion[Mapper[_O], Type[_O]])�argrg c C s. t j| dd�}t|�r|S t�d| ����d S )NF)Zraiseerrz%Mapper or mapped class expected, got )r r� r r� � ArgumentError)r� r� r< r< r= �_parse_mapper_argument s r� c C sB t | |d�}|dkr:t| t�s.t�d| f ��t�| ��n|S dS )a� Given a class, return the primary :class:`_orm.Mapper` associated with the key. Raises :exc:`.UnmappedClassError` if no mapping is configured on the given class, or :exc:`.ArgumentError` if a non-class object is passed. Equivalent functionality is available via the :func:`_sa.inspect` function as:: inspect(some_mapped_class) Using the inspection system will raise :class:`sqlalchemy.exc.NoInspectionAvailable` if the class is not mapped. )r� Nz Class object expected, got '%r'.)r� r� r� r� r� r r� )r� r� r� r< r< r= � class_mapper s � r� c @ sP e Zd ZU dZdZded< dZdZdZdZ dZ dZ dZ dZ dZejZded< dS ) �InspectionAttraM A base class applied to all ORM objects and attributes that are related to things that can be returned by the :func:`_sa.inspect` function. The attributes defined here allow the usage of simple boolean checks to test basic facts about the object returned. While the boolean checks here are basically the same as using the Python isinstance() function, the flags here can be used without the need to import all of these classes, and also such that the SQLAlchemy class system can change while leaving the flags here intact for forwards-compatibility. r< zTuple[str, ...]� __slots__Fra �extension_typeN)r3 r4 r5 rE r� �__annotations__r� r� Z is_instancer� Z is_bundleZ is_propertyZ is_attributeZ_is_internal_proxyr� rb rc r� r< r< r< r= r� 8 s r� c @ s( e Zd ZdZdZejdd�dd��ZdS )�InspectionAttrInfoa Adds the ``.info`` attribute to :class:`.InspectionAttr`. The rationale for :class:`.InspectionAttr` vs. :class:`.InspectionAttrInfo` is that the former is compatible as a mixin for classes that specify ``__slots__``; this is essentially an implementation artifact. r< r( )rg c C s i S )a� Info dictionary associated with the object, allowing user-defined data to be associated with this :class:`.InspectionAttr`. The dictionary is generated when first accessed. Alternatively, it can be specified as a constructor argument to the :func:`.column_property`, :func:`_orm.relationship`, or :func:`.composite` functions. .. seealso:: :attr:`.QueryableAttribute.info` :attr:`.SchemaItem.info` r< )ri r< r< r= �info� s zInspectionAttrInfo.infoN)r3 r4 r5 rE r� r Zro_memoized_propertyr� r< r< r< r= r� � s r� c @ s^ e Zd ZdZejrZddd�dd�Zddd �d d �Zdd ddd�dd�Zdd ddd�dd�Z d S )�SQLORMOperationsr< r� zPropComparator[_T_co])r� rg c C s d S rl r< )ri r� r< r< r= �of_type� s zSQLORMOperations.of_typez _ColumnExpressionArgument[bool]zPropComparator[bool])�criteriarg c G s d S rl r< )ri r� r< r< r= �and_� s zSQLORMOperations.and_Nz)Optional[_ColumnExpressionArgument[bool]]r zColumnElement[bool])� criterion�kwargsrg c K s d S rl r< �ri r� r� r< r< r= �any� s zSQLORMOperations.anyc K s d S rl r< r� r< r< r= �has� s zSQLORMOperations.has)N)N) r3 r4 r5 r� �typingr r� r� r� r� r< r< r< r= r� � s � �r� c @ sn e Zd ZdZdZejrjedddd�dd��Zeddd d�d d��Zed dd d�d d��Zd ddd�dd�ZdS )� ORMDescriptorz`Represent any Python descriptor that provides a SQL expression construct at the class level.r< r z Literal[None]zORMDescriptor[_T_co]�rx �ownerrg c C s d S rl r< �ri rx r� r< r< r= �__get__� s zORMDescriptor.__get__zSQLCoreOperations[_T_co]c C s d S rl r< r� r< r< r= r� � s r{ r- c C s d S rl r< r� r< r< r= r� � s z<Union[ORMDescriptor[_T_co], SQLCoreOperations[_T_co], _T_co]c C s d S rl r< r� r< r< r= r� � s N) r3 r4 r5 rE r� r� r r r� r< r< r< r= r� � s r� c @ s e Zd ZdZdZdS )�_MappedAnnotationBasez�common class for Mapped and similar ORM container classes. these are classes that can appear on the left side of an ORM declarative mapping, containing a mapped class or in some cases a collection surrounding a mapped class. r< N�r3 r4 r5 rE r� r< r< r< r= r� � s r� c @ s e Zd ZdZdZdS )�SQLORMExpressionaC A type that may be used to indicate any ORM-level attribute or object that acts in place of one, in the context of SQL expression construction. :class:`.SQLORMExpression` extends from the Core :class:`.SQLColumnExpression` to add additional SQL methods that are ORM specific, such as :meth:`.PropComparator.of_type`, and is part of the bases for :class:`.InstrumentedAttribute`. It may be used in :pep:`484` typing to indicate arguments or return values that should behave as ORM-level attribute expressions. .. versionadded:: 2.0.0b4 r< Nr� r< r< r< r= r� � s r� c @ s� e Zd ZdZdZejr�edddd�dd��Zed dd d�d d��Zd dd d�dd�Ze ddd�dd��Z dddd�dd�Z ddd�dd�Z dS )�Mappedaj Represent an ORM mapped attribute on a mapped class. This class represents the complete descriptor interface for any class attribute that will have been :term:`instrumented` by the ORM :class:`_orm.Mapper` class. Provides appropriate information to type checkers such as pylance and mypy so that ORM-mapped attributes are correctly typed. The most prominent use of :class:`_orm.Mapped` is in the :ref:`Declarative Mapping <orm_explicit_declarative_base>` form of :class:`_orm.Mapper` configuration, where used explicitly it drives the configuration of ORM attributes such as :func:`_orm.mapped_class` and :func:`_orm.relationship`. .. seealso:: :ref:`orm_explicit_declarative_base` :ref:`orm_declarative_table` .. tip:: The :class:`_orm.Mapped` class represents attributes that are handled directly by the :class:`_orm.Mapper` class. It does not include other Python descriptor classes that are provided as extensions, including :ref:`hybrids_toplevel` and the :ref:`associationproxy_toplevel`. While these systems still make use of ORM-specific superclasses and structures, they are not :term:`instrumented` by the :class:`_orm.Mapper` and instead provide their own functionality when they are accessed on a class. .. versionadded:: 1.4 r< ru r � InstrumentedAttribute[_T_co]r� c C s d S rl r< r� r< r< r= r� ( s zMapped.__get__r{ r- c C s d S rl r< r� r< r< r= r� - s �Optional[object]z*Union[InstrumentedAttribute[_T_co], _T_co]c C s d S rl r< r� r< r< r= r� 0 s z Mapped[_T_co])�arg1rg c C s d S rl r< )rq r� r< r< r= �_empty_constructor4 s zMapped._empty_constructorz&Union[SQLCoreOperations[_T_co], _T_co]�rx �valuerg c C s d S rl r< �ri rx r� r< r< r= �__set__7 s zMapped.__set__rw c C s d S rl r< )ri rx r< r< r= � __delete__; rt zMapped.__delete__N) r3 r4 r5 rE r� r� r r r� � classmethodr� r� r� r< r< r< r= r� � s $r� c @ s e Zd ZdZdZdS )�_MappedAttributezVMixin for attributes which should be replaced by mapper-assigned attributes. r< Nr� r< r< r< r= r� > s r� c @ s@ e Zd ZdZdZddddd�dd�ZeZddddd�dd �Zd S ) �_DeclarativeMappedz�Mixin for :class:`.MapperProperty` subclasses that allows them to be compatible with ORM-annotated declarative mappings. r< r* r )�op�otherr� rg c O s t S rl ��NotImplemented�ri r� r� r� r< r< r= �operateU s z_DeclarativeMapped.operatec K s t S rl r� r� r< r< r= �reverse_operateZ s z"_DeclarativeMapped.reverse_operateN)r3 r4 r5 rE r� r� Z__sa_operate__r� r< r< r< r= r� G s r� c @ sh e Zd ZdZdZerdedddd�dd��Zed dd d�d d��Zd dd d�dd�Zdddd�dd�ZdS )� DynamicMappeda� Represent the ORM mapped attribute type for a "dynamic" relationship. The :class:`_orm.DynamicMapped` type annotation may be used in an :ref:`Annotated Declarative Table <orm_declarative_mapped_column>` mapping to indicate that the ``lazy="dynamic"`` loader strategy should be used for a particular :func:`_orm.relationship`. .. legacy:: The "dynamic" lazy loader strategy is the legacy form of what is now the "write_only" strategy described in the section :ref:`write_only_relationship`. E.g.:: class User(Base): __tablename__ = "user" id: Mapped[int] = mapped_column(primary_key=True) addresses: DynamicMapped[Address] = relationship( cascade="all,delete-orphan" ) See the section :ref:`dynamic_relationship` for background. .. versionadded:: 2.0 .. seealso:: :ref:`dynamic_relationship` - complete background :class:`.WriteOnlyMapped` - fully 2.0 style version r< ru r r� r� c C s d S rl r< r� r< r< r= r� � s zDynamicMapped.__get__r{ zAppenderQuery[_T_co]c C s d S rl r< r� r< r< r= r� � s r� z9Union[InstrumentedAttribute[_T_co], AppenderQuery[_T_co]]c C s d S rl r< r� r< r< r= r� � s �typing.Collection[_T_co]r� c C s d S rl r< r� r< r< r= r� � s zDynamicMapped.__set__N� r3 r4 r5 rE r� r r r� r� r< r< r< r= r� ` s r� c @ sh e Zd ZdZdZerdedddd�dd��Zed dd d�d d��Zd dd d�dd�Zdddd�dd�ZdS )�WriteOnlyMappedad Represent the ORM mapped attribute type for a "write only" relationship. The :class:`_orm.WriteOnlyMapped` type annotation may be used in an :ref:`Annotated Declarative Table <orm_declarative_mapped_column>` mapping to indicate that the ``lazy="write_only"`` loader strategy should be used for a particular :func:`_orm.relationship`. E.g.:: class User(Base): __tablename__ = "user" id: Mapped[int] = mapped_column(primary_key=True) addresses: WriteOnlyMapped[Address] = relationship( cascade="all,delete-orphan" ) See the section :ref:`write_only_relationship` for background. .. versionadded:: 2.0 .. seealso:: :ref:`write_only_relationship` - complete background :class:`.DynamicMapped` - includes legacy :class:`_orm.Query` support r< ru r r� r� c C s d S rl r< r� r< r< r= r� � s zWriteOnlyMapped.__get__r{ zWriteOnlyCollection[_T_co]c C s d S rl r< r� r< r< r= r� � s r� z?Union[InstrumentedAttribute[_T_co], WriteOnlyCollection[_T_co]]c C s d S rl r< r� r< r< r= r� � s r� r� c C s d S rl r< r� r< r< r= r� � s zWriteOnlyMapped.__set__Nr� r< r< r< r= r� � s r� )F)T)�rE � __future__r �enumr �operatorr� r r r r r r r r r r r r � r Z_typingr r� r r �sqlr Z sql.elementsr r r Zutil.langhelpersr Z util.typingr r r r � attributesr Zdynamicr Zinstrumentationr! Z interfacesr" r� r# r� r$ r% Z writeonlyr& Z sql._typingr' r( r) Z sql.operatorsr* r+ r- r{ r/ r0 �tupler6 r7 r8 r9 r: r; r> � __members__�valuesrF rG rH rI rJ rK rL rM rN rO rP rQ rR rS rT rU rV rW r~ ZDEFAULT_STATE_ATTRrX rY rZ r[ r\ r] r^ r_ r` ra rb � frozensetZ _never_setZ _none_set�symbolZ_SET_DEFERRED_EXPIREDZ_DEFER_FOR_STATEZ_RAISE_FOR_STATErd re rp rs rv rz r| � attrgetterr� r� r� r� r� r� r� Z _inspectsr� r� r� r� r� r� r� Z dottedgetterr� r� r� r� r� r� r� r� r� ZDDLConstraintColumnRoler� r� r� r� r� r< r< r< r= �<module> s& *�^� # � L � �D 8