codekingpro/portable-devtools
115k
1�
2 ��j8o � �� � S r SSKJr SSKJr SSKrSSKrSSKJr SSKJr SSKJ r SSKJ3r4 SS KJ r SS5KJ r SS KJ
r
SS KJr SS
KJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSK J r SSK J r SSKJ r SSK J!r! SS K"J#r# \R ( aZ SS KJ$r$ SS KJ%r% SS KJ&r& SS K'J(r( SS!K)J*r* SS"K+J,r, SS#K-J.r. SS$K/J0r0 SS%K1J2r2 SS&KJ3r3 SS'K4J5r5 SS(K6J7r7 SS)K6J8r8 SS*K J9r9 SS+K:J;r; \" S,\S-9r<\" S.\S/S09r=\" S1\>S-9r? " S2 S3\5 r@\A" \@5 u rBrCrDrErF\FrG " S4 S5\ 5 rH\HR� R� 5 u rKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\S6r]S7r^ " S8 S9\5 r_\A" \_5 u r`rarbrc " S: S;\5 rd\A" \d5 u rerfrg " S< S=\5 rh " S> S?\h5 ri\j" \G/5 rk\j" S\G\B/5 rl\j" S/5 rm\R� " S@5 ro\R� " SA5 rp\R� " SB5 rq\" SC\SD\4 S-9rr\" SE5 rs SxSF jrt\( a1 SySG jru\
SzSH j5 rv\
S{SI j5 rv S{SJ jrvS|SK jrwS}SL jrxO*SM ruSN rv\R� " \^5 rw\R� " SO5 rxS~SP jrzSSQ jr{SSR jr|S�SS jr}S�ST jr~S�SU jrS�SV jr�\GR " \>5 S�SW j5 r� S�SX jr� S�SY jr�S�SZ jr�S�S[ jr�\ S�S\ j5 r�\( a S�S] jr�O\GR " S^5 r� S� S�S_ jjr�S�S` jr�S�S�Sa jjr� " Sb Sc5 r� " Sd Se\�5 r� " Sf Sg\ \= \!5 r� " Sh Si\6\= \!5 r� " Sj Sk\7\= \!5 r� " Sl Sm\�\= \ \= \!5 r� " Sn So\�\= \�\= \�\= \GR& 5 r� " Sp Sq\8\= \!5 r� " Sr Ss\�\= \�\= 5 r� " St Su\�\= 5 r� " Sv Sw\�\= 5 r�g)�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� )�9inspection)�util)�roles)�SQLColumnExpression)�SQLCoreOperations)� FastIntFlag)�10TypingOnly)�Literal)� _EntityType)�_ExternalEntityType)�_InternalEntityType)�InstrumentedAttribute)�
AppenderQuery)� ClassManager)�PropComparator)�Mapper)�
InstanceState)� AliasedClass)�WriteOnlyCollection)�_ColumnExpressionArgument)� _InfoType)�
ColumnElement)� OperatorType�_T)�bound�_T_coT)r- � covariant�_Oc �6 � \ rS rSrSr Sr Sr Sr Sr \r Sr11g) �LoaderCallableStatus�? r r r � � � N) �__name__�12__module__� __qualname__�__firstlineno__�PASSIVE_NO_RESULT�PASSIVE_CLASS_MISMATCH� ATTR_WAS_SET�13ATTR_EMPTY�NO_VALUE� NEVER_SET�__static_attributes__r6 � �YD:\code\apps\devtools\python\user_packages\Python313\site-packages\sqlalchemy/orm/base.pyr2 r2 ? sG � ����14 ��D� �L��15 �J�J��H��16 �I�rB r2 c � � \ rS rSrSrSr Sr Sr Sr Sr Sr17 S r S18r S r
S r S
r\\19- \ - \- \- r \\ - r \\- r \\- r \\- r \\20- r \\
- rSrg)� PassiveFlag�n z;Bitflag interface that passes options onto loader callablesr r r r5 � � � �@ � � i r6 N)r7 r8 r9 r: �__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_MERGErA r6 rB rC rE rE n s� � �E��I�� �L�� �F�L���� �G��21 ��C� ��� �L�4��H�:� ��F� #� � � -�-��7�,�F��O� � -� )�G� 3�� � 3�l� B��,�"�V�+��� *�->� >� �%� )�,=� =��%� �(�*�M�rB rE �_sa_class_manager�_sa_instance_statec �$ � \ rS rSrSrSrSrSrSrg)�EventConstants�� r r r4 r5 r6 N) r7 r8 r9 r: � EXT_CONTINUE�EXT_STOP�EXT_SKIP�NO_KEYrA r6 rB rC rc rc � s � ��L��H��H�
�F�rB rc c �( � \ rS rSrSrSr Sr SrSrg)�RelationshipDirection�� z�enumeration which indicates the 'direction' of a22:class:`_orm.RelationshipProperty`.23 24:class:`.RelationshipDirection` is accessible from the25:attr:`_orm.Relationship.direction` attribute of26:class:`_orm.RelationshipProperty`.27 28r r r4 r6 N) r7 r8 r9 r: rM � ONETOMANY� MANYTOONE�29MANYTOMANYrA r6 rB rC rj rj � s+ � �� �I�� �I�� �J�rB rj c � � \ rS rSrSrSrg)�InspectionAttrExtensionTypei zTSymbols indicating the type of extension that a30:class:`.InspectionAttr` is part of.r6 N)r7 r8 r9 r: rM rA r6 rB rC rp rp s � �,rB rp c � � \ rS rSrSrSrg)� NotExtensioni
�
not_extensionr6 N)r7 r8 r9 r: �
NOT_EXTENSIONrA r6 rB rC rr rr
s � �#�M�rB rr �SET_DEFERRED_EXPIRED�DEFER_FOR_STATE�RAISE_FOR_STATE�_F.�_Selfc �> ^ � [ R SU 4S jj5 nU$ )Nc �V >� T H nU" XR 5 M U " U/UQ70 UD6 U$ �N)r7 )�fn�self�args�kw� assertion�31assertionss �rC �generate� _assertions.<locals>.generate, s0 �� �#�I� �d�K�K� (� $�32�4� �$� �"� �� rB )33r} rx r~ ry r r r� r �returnry )r � decorator)r� r� s ` rC � _assertionsr� ) s" �� � 34�^�^�� �� �OrB c � � g r| r6 ��clss rC �manager_of_classr� 8 s � �SrB c � � g r| r6 r� s rC �opt_manager_of_classr� : s � �>ArB c � � g r| r6 r� s rC r� r� = s � � &)rB c � � g r| r6 r� s rC r� r� B s � �%(rB c � � g r| r6 ��instances rC �instance_stater� F � � �3rB c � � g r| r6 r� s rC �
instance_dictr� H r� rB c � � U R [ $ ! [ a n[ R " U SU 35 UeS nAff = f)Nz2Can't locate an instrumentation manager for class )�__dict__�DEFAULT_MANAGER_ATTR�KeyErrorr �UnmappedClassError)r� �kes rC r� r� N sJ � � ��<�<� 4�5� 5��� ��(�(��I�#��O���
�� �s � �35?�:�?c �@ � U R R [ 5 $ r| )r� �getr� r� s rC r� r� V s � ��|�|� � � 4�5�5rB r� c �* � [ [ U 5 5 $ )z'Return a string describing an instance.)� state_strr� r� s rC � instance_strr� ^ s � � �^�H�-� .�.rB c �n � U c gSU R R [ U R 5 5 4- $ )z=Return a string describing an instance via its InstanceState.�Nonez <%s at 0x%x>)�class_r7 �id�obj��states rC r� r� d s0 � �
�}�� �� � �!6�!6��5�9�9�;�� H�H�HrB c �@ � U c gSU R R < S3$ )zFReturn a string describing an instance's class via its36InstanceState.37r� �<�>)r� r7 r� s rC �state_class_strr� m s& � �38
�}�� � � � �.�.�0�0rB c �$ � [ U 5 S- U- $ �N�.)r� )r� � attributes rC �
attribute_strr� x s � � �� !�C� '�)� 3�3rB c �$ � [ U 5 S- U- $ r� )r� )r� r� s rC �state_attribute_strr� | s � � �U� �c� !�I� -�-rB c �, � [ U 5 R $ )a� Given an object, return the primary Mapper associated with the object39instance.40 41Raises :class:`sqlalchemy.orm.exc.UnmappedInstanceError`42if no mapping is configured.43 44This function is available via the inspection system as::45 46 inspect(instance).mapper47 48Using the inspection system will raise49:class:`sqlalchemy.exc.NoInspectionAvailable` if the instance is50not part of a mapping.51 52)� object_state�mapperr� s rC �
object_mapperr� � s � � �� !� (� (�(rB c �N � [ U 5 nUc [ R " U 5 eU$ )a� Given an object, return the :class:`.InstanceState`53associated with the object.54 55Raises :class:`sqlalchemy.orm.exc.UnmappedInstanceError`56if no mapping is configured.57 58Equivalent functionality is available via the :func:`_sa.inspect`59function as::60 61 inspect(instance)62 63Using the inspection system will raise64:class:`sqlalchemy.exc.NoInspectionAvailable` if the instance is65not part of a mapping.66 67)�_inspect_mapped_objectr �UnmappedInstanceError)r� r� s rC r� r� � s) � �"
#�8� ,�E� �}��'�'��1�1�� rB c �r � [ U 5 $ ! [ R 4[ R - a g f = fr| )r� r r� �NO_STATEr� s rC r� r� � s6 � �� �h�'�'�� � "� "� $�s�|�|� 3� ���s �68
�&6�6c � � [ R " U S5 nUb UR $ [ U [ 5 ( d e[69 R " U 5 e)NF)r �inspectr� �70isinstance�typer r� )�class_or_mapper�insps rC �_class_to_mapperr� � sJ � � � � �o�u� 5�D� ���{�{���/�4�0�0�0�0��$�$�_�5�5rB c �P � [ R " U S5 nUb UR $ g)zXReturn the :class:`_orm.Mapper` for the given class or None if the71class is not mapped.72FN)r r� r� ��entityr� s rC �_mapper_or_noner� � s) � � � � �f�e� ,�D� ���{�{��rB c � � [ R " U S5 nUSL=( a7 UR ( + =( a UR =( d UR $ )zdReturn True if the given object is a mapped class,73:class:`_orm.Mapper`, or :class:`.AliasedClass`.74FN)r r� �is_clause_element� is_mapper�is_aliased_classr� s rC �_is_mapped_classr� � sK � �75 � � �f�e� ,�D� �D�� 6��&�&� &� 6�
�^�^�
4�t� 4� 4�rB c �` � [ R " U S5 nUS L=( a
[ USS5 $ )NFr� )r r� �getattrr� s rC �_is_aliased_classr� � s. � � � � �f�e� ,�D� �t� � H���.@�%� H�HrB c � � [ R " U 5 nUR ( a U nUR n OKUR ( a UR76 n U nO+[
US5 ( a UR R =p0OU n [ X5 $ ! [ a% n[ R " SU< SU< S35 UeSnAff = f)z�Return a class attribute given an entity and string name.77 78May return :class:`.InstrumentedAttribute` or user-defined79attribute.80 81r� zEntity 'z' has no property '�'N)
r r� �
is_selectable�cr� r� �hasattrr� r� r� �AttributeError�sa_exc�InvalidRequestError)r� �keyr� � description�errs rC �_entity_descriptorr� � s� � � � � �f� %�D� ��� � �����
� � ����� � � ��x� � � #�{�{� 1� 1�1� �f� � ���v�#�#�� � ��(�(�2=�s� C�82�� ���s �83B �84B=� B8�8B=c � � g r| r6 r� s rC �
_state_mapperr� � s � �srB zmanager.mapperc �� � [ U 5 nUb UR ( d g UR nU( a UR 5 U$ ! [ R85 a g f = fr| )r� � is_mappedr� �_check_configurer r� )r� � configure�
class_managerr� s rC �_inspect_mapped_classr� s[ � �86�,�V�4�
� � �
�(?�(?�� �%�%�� � � #� #� %��
�� �<�<� ���s � A � A �A � A c � � [ R " U SS9n[ U5 ( a U$ [ R " SU < 35 e)NF)�raiseerrz%Mapper or mapped class expected, got )r r� r r� �
ArgumentError)�argr� s rC �_parse_mapper_argumentr� s= � � � � �c�E� 2�D��d���� �87�88 �89 �!F�s�g� N�90O�OrB c � � [ XS9nUcF [ U [ 5 ( d [ R " SU < S35 e[91 R " U 5 eU$ )a� Given a class, return the primary :class:`_orm.Mapper` associated92with the key.93 94Raises :exc:`.UnmappedClassError` if no mapping is configured95on the given class, or :exc:`.ArgumentError` if a non-class96object is passed.97 98Equivalent functionality is available via the :func:`_sa.inspect`99function as::100 101 inspect(some_mapped_class)102 103Using the inspection system will raise104:class:`sqlalchemy.exc.NoInspectionAvailable` if the class is not mapped.105 106)r� z Class object expected, got 'z'.)r� r� r� r� r� r r� )r� r� r� s rC � class_mapperr� sQ � �" #�6�
?�F�
�~��&�$�'�'��&�&�6<�>��
� �$�$�V�,�,��
rB c � � \ rS rSr% SrSrS\S' Sr Sr Sr Sr107 Sr Sr Sr
Sr Sr \R" rS\S' Srg )108�InspectionAttri8 a) A base class applied to all ORM objects and attributes that are109related to things that can be returned by the :func:`_sa.inspect` function.110 111The attributes defined here allow the usage of simple boolean112checks to test basic facts about the object returned.113 114While the boolean checks here are basically the same as using115the Python isinstance() function, the flags here can be used without116the need to import all of these classes, and also such that117the SQLAlchemy class system can change while leaving the flags118here intact for forwards-compatibility.119 120r6 zTuple[str, ...]� __slots__Frp �extension_typeN)r7 r8 r9 r: rM r� �__annotations__r� r� � is_instancer� � is_bundle� is_property� is_attribute�_is_internal_proxyr� rr rt r� rA r6 rB rC r� r� 8 s� � � � "$�I��#��M�(� ��G��K�H��I�E��I�A��K�I��L�
� ��� ��+� 3?�2L�2L�N�/�L� rB r� c �D � \ rS rSrSrSr\R SS j5 rSr g)�InspectionAttrInfoi� a Adds the ``.info`` attribute to :class:`.InspectionAttr`.121 122The rationale for :class:`.InspectionAttr` vs. :class:`.InspectionAttrInfo`123is that the former is compatible as a mixin for classes that specify124``__slots__``; this is essentially an implementation artifact.125 126r6 c � � 0 $ )a� Info dictionary associated with the object, allowing user-defined127data to be associated with this :class:`.InspectionAttr`.128 129The dictionary is generated when first accessed. Alternatively,130it can be specified as a constructor argument to the131:func:`.column_property`, :func:`_orm.relationship`, or132:func:`.composite`133functions.134 135.. seealso::136 137 :attr:`.QueryableAttribute.info`138 139 :attr:`.SchemaItem.info`140 141r6 )r~ s rC �info�InspectionAttrInfo.info� s � �$ � rB N)r� r) )142r7 r8 r9 r: rM r� r �ro_memoized_propertyr� rA r6 rB rC r� r� � s& � �� �I� � � �� �rB r� c � � \ rS rSrSr\R ( a/ SS jr S S jr S143 S S jjr S144 S S jjr145Sr gSr g) �SQLORMOperationsi� r6 c � � g r| r6 )r~ r� s rC �of_type�SQLORMOperations.of_type� s � �$'rB c � � g r| r6 )r~ �criterias rC �and_�SQLORMOperations.and_� s � �#&rB Nc � � g r| r6 �r~ � criterion�kwargss rC �any�SQLORMOperations.any� � � � #&rB c � � g r| r6 r s rC �has�SQLORMOperations.has� r146 rB )r� �_EntityType[Any]r� zPropComparator[_T_co])r z _ColumnExpressionArgument[bool]r� zPropComparator[bool]r| )r z)Optional[_ColumnExpressionArgument[bool]]r r r� zColumnElement[bool]) r7 r8 r9 r: r� �typingr r� r r r rA r6 rB rC r� r� � s� � ��I�
��� (�*� (�
"� (� '� <� '�
!� '� DH� &�@� &� � &� !� &� DH� &�@� &� � &� !� &� &�! rB r� c � � \ rS rSrSrSr\R ( a8 \ S S j5 r \ S147S j5 r \S S j5 r S S jr Sr148gSr149g)
�
ORMDescriptori� z\Represent any Python descriptor that provides a SQL expression150construct at the class level.r6 c � � g r| r6 �r~ r� �owners rC �__get__�ORMDescriptor.__get__� � � � $'rB c � � g r| r6 r s rC r r � s � � (+rB c � � g r| r6 r s rC r r � � � �BErB c � � g r| r6 r s rC r r � s � �KNrB N)r� r r �
Literal[None]r� zORMDescriptor[_T_co])r� r r r r� zSQLCoreOperations[_T_co]�r� �objectr r r� r. )r� r r r r� z<Union[ORMDescriptor[_T_co], SQLCoreOperations[_T_co], _T_co]) r7 r8 r9 r: rM r� r r r r rA r6 rB rC r r � s� � �%� �I�
��� � '� � '�(5� '�
!� '� 151� '� 152� +� )� +�25� +�
%� +� 153� +� 154�E� 155�E� O� "� O�+.� O�
I� O� rB r c � � \ rS rSrSrSrSrg)�_MappedAnnotationBasei� z�common class for Mapped and similar ORM container classes.156 157these are classes that can appear on the left side of an ORM declarative158mapping, containing a mapped class or in some cases a collection159surrounding a mapped class.160 161r6 N�r7 r8 r9 r: rM r� rA r6 rB rC r r � s � �� �IrB r c � � \ rS rSrSrSrSrg)�SQLORMExpressioni� a A type that may be used to indicate any ORM-level attribute or162object that acts in place of one, in the context of SQL expression163construction.164 165:class:`.SQLORMExpression` extends from the Core166:class:`.SQLColumnExpression` to add additional SQL methods that are ORM167specific, such as :meth:`.PropComparator.of_type`, and is part of the bases168for :class:`.InstrumentedAttribute`. It may be used in :pep:`484` typing to169indicate arguments or return values that should behave as ORM-level170attribute expressions.171 172.. versionadded:: 2.0.0b4173 174 175r6 Nr! r6 rB rC r# r# � s � �� �IrB r# c �� � \ rS rSrSrSr\R ( aB \ S S j5 r \S S j5 r S
S jr \176SS j5 r SS jr SS jr
Srg177Srg178)�Mappedi� a179 Represent an ORM mapped attribute on a mapped class.180 181This class represents the complete descriptor interface for any class182attribute that will have been :term:`instrumented` by the ORM183:class:`_orm.Mapper` class. Provides appropriate information to type184checkers such as pylance and mypy so that ORM-mapped attributes185are correctly typed.186 187The most prominent use of :class:`_orm.Mapped` is in188the :ref:`Declarative Mapping <orm_explicit_declarative_base>` form189of :class:`_orm.Mapper` configuration, where used explicitly it drives190the configuration of ORM attributes such as :func:`_orm.mapped_class`191and :func:`_orm.relationship`.192 193.. seealso::194 195 :ref:`orm_explicit_declarative_base`196 197 :ref:`orm_declarative_table`198 199.. tip::200 201 The :class:`_orm.Mapped` class represents attributes that are handled202 directly by the :class:`_orm.Mapper` class. It does not include other203 Python descriptor classes that are provided as extensions, including204 :ref:`hybrids_toplevel` and the :ref:`associationproxy_toplevel`.205 While these systems still make use of ORM-specific superclasses206 and structures, they are not :term:`instrumented` by the207 :class:`_orm.Mapper` and instead provide their own functionality208 when they are accessed on a class.209 210.. versionadded:: 1.4211 212 213r6 c � � g r| r6 r s rC r �Mapped.__get__( � � � ,/rB c � � g r| r6 r s rC r r' - r rB c � � g r| r6 r s rC r r' 0 s � �9<rB c � � g r| r6 )r� �arg1s rC �_empty_constructor�Mapped._empty_constructor4 s � �ADrB c � � g r| r6 �r~ r� �values rC �__set__�Mapped.__set__7 � � �rB c � � g r| r6 )r~ r� s rC �214__delete__�Mapped.__delete__; s � �SrB N�r� r� r r r� z InstrumentedAttribute[_T_co]r )r� �Optional[object]r r r� z*Union[InstrumentedAttribute[_T_co], _T_co])r, r r� z
Mapped[_T_co])r� r r1 z&Union[SQLCoreOperations[_T_co], _T_co]r� r� )r� r r� r� )r7 r8 r9 r: rM r� r r r r � classmethodr- r2 r6 rA r6 rB rC r% r% � s� � � "�H �I�
��� � /� � /�),� /�
)� /� 215� /� 216�E� 217�E� =� ,� =�58� =�
7� =� 218�D� 219�D� � � �(N� �
� � 9�+ rB r% c � � \ rS rSrSrSrSrg)�_MappedAttributei> zNMixin for attributes which should be replaced by mapper-assigned220attributes.221 222r6 Nr! r6 rB rC r< r< > s � ��223 �IrB r< c �D � \ rS rSrSrSrSS jr\r SS jrSr g)�_DeclarativeMappediG zzMixin for :class:`.MapperProperty` subclasses that allows them to224be compatible with ORM-annotated declarative mappings.225 226r6 c � � [ $ r| ��NotImplemented�r~ �op�otherr s rC �operate�_DeclarativeMapped.operateU s � � � rB c � � [ $ r| r@ rB s rC �reverse_operate�"_DeclarativeMapped.reverse_operateZ s227 � � � rB N)rC r+ rD r r r r� r )228r7 r8 r9 r: rM r� rE �__sa_operate__rH rA r6 rB rC r> r> G s? � ��229 �I� � �N� � � �'*� �69� � � rB r> c � � \ rS rSrSrSr\( a9 \ S S j5 r\ S230S j5 r S S jr S S jr Sr231gSr232g)
�
DynamicMappedi` a� Represent the ORM mapped attribute type for a "dynamic" relationship.233 234The :class:`_orm.DynamicMapped` type annotation may be used in an235:ref:`Annotated Declarative Table <orm_declarative_mapped_column>` mapping236to indicate that the ``lazy="dynamic"`` loader strategy should be used237for a particular :func:`_orm.relationship`.238 239.. legacy:: The "dynamic" lazy loader strategy is the legacy form of what240 is now the "write_only" strategy described in the section241 :ref:`write_only_relationship`.242 243E.g.::244 245 class User(Base):246 __tablename__ = "user"247 id: Mapped[int] = mapped_column(primary_key=True)248 addresses: DynamicMapped[Address] = relationship(249 cascade="all,delete-orphan"250 )251 252See the section :ref:`dynamic_relationship` for background.253 254.. versionadded:: 2.0255 256.. seealso::257 258 :ref:`dynamic_relationship` - complete background259 260 :class:`.WriteOnlyMapped` - fully 2.0 style version261 262r6 c � � g r| r6 r s rC r �DynamicMapped.__get__� r( rB c � � g r| r6 r s rC r rN � r rB c � � g r| r6 r s rC r rN � s � �HKrB c � � g r| r6 r0 s rC r2 �DynamicMapped.__set__� r4 rB Nr8 )r� r r r r� zAppenderQuery[_T_co])r� r9 r r r� z9Union[InstrumentedAttribute[_T_co], AppenderQuery[_T_co]]�r� r r1 ztyping.Collection[_T_co]r� r� � r7 r8 r9 r: rM r� r r r r2 rA r6 rB rC rL rL ` s� � � �@ �I�� � /� � /�),� /�
)� /� 263� /� 264� '� "� '�+.� '�
!� '� 265� '� L� ,� L�58� L�
F� L� � � �(@� �
� �! rB rL c � � \ rS rSrSrSr\( a9 \ S S j5 r\ S266S j5 r S S jr S S jr Sr267gSr268g)
�WriteOnlyMappedi� a Represent the ORM mapped attribute type for a "write only" relationship.269 270The :class:`_orm.WriteOnlyMapped` type annotation may be used in an271:ref:`Annotated Declarative Table <orm_declarative_mapped_column>` mapping272to indicate that the ``lazy="write_only"`` loader strategy should be used273for a particular :func:`_orm.relationship`.274 275E.g.::276 277 class User(Base):278 __tablename__ = "user"279 id: Mapped[int] = mapped_column(primary_key=True)280 addresses: WriteOnlyMapped[Address] = relationship(281 cascade="all,delete-orphan"282 )283 284See the section :ref:`write_only_relationship` for background.285 286.. versionadded:: 2.0287 288.. seealso::289 290 :ref:`write_only_relationship` - complete background291 292 :class:`.DynamicMapped` - includes legacy :class:`_orm.Query` support293 294r6 c � � g r| r6 r s rC r �WriteOnlyMapped.__get__� r( rB c � � g r| r6 r s rC r rX � s � � *-rB c � � g r| r6 r s rC r rX � s � � rB c � � g r| r6 r0 s rC r2 �WriteOnlyMapped.__set__� r4 rB Nr8 )r� r r r r� zWriteOnlyCollection[_T_co])r� r9 r r r� z?Union[InstrumentedAttribute[_T_co], WriteOnlyCollection[_T_co]]rS rT r6 rB rC rV rV � s� � ��8 �I�� � /� � /�),� /�
)� /� 295� /� 296� -� "� -�+.� -�
'� -� 297� -� � ,� �58� �298� � � � �(@� �
� �% rB rV )r� r r� zCallable[[_F], _F])r� �Type[_O]r� zClassManager[_O])r� zAliasedClass[Any]r� r� )r� z_ExternalEntityType[_O]r� zOptional[ClassManager[_O]])r� r0 r� �InstanceState[_O])r� r r� zDict[str, Any])r� r r� �str)r� �InstanceState[Any]r� r_ )r� r r� r_ r� r_ )r� r` r� r_ r� r_ )r� r, r� �299Mapper[_T])r� r, r� zInstanceState[_T])r� r, r� zOptional[InstanceState[_T]])r� zUnion[Mapper[_T], Type[_T]]r� ra )r� z(Union[Type[_T], _InternalEntityType[_T]]r� zOptional[Mapper[_T]])r� r r� �bool)r� r r� r_ r� r )r� r^ r� �300Mapper[_O])F)r� r] r� rb r� zOptional[Mapper[_O]])r� zUnion[Mapper[_O], Type[_O]]r� rc )T)r� r] r� rb r� rc )�rM �301__future__r �enumr �operatorr r r r r r r302 r r r
r r r � r �_typingr r� r r �sqlr � sql.elementsr r r �util.langhelpersr � util.typingr r r r �303attributesr �dynamicr! �instrumentationr" �304interfacesr# r� r$ r� r% r& � writeonlyr' � sql._typingr( r) r* �
sql.operatorsr+ r, r. r r0 r2 �tupler; r< r= r> r? r@ rE � __members__�valuesrN rO rP rQ rR rS rT rU rV rW rX rY rZ r[ r\ r] r^ r_ r� �DEFAULT_STATE_ATTRrc re rf rg rh rj rl rm rn rp rr � frozenset�305_never_set� _none_set�_none_only_set�symbol�_SET_DEFERRED_EXPIRED�_DEFER_FOR_STATE�_RAISE_FOR_STATErx ry r� r� r� r� r� �306attrgetterr� r� r� r� r� r� r� � _inspectsr� r� r� r� r� r� r� � dottedgetterr� r� r� r� r� r� r r r# �DDLConstraintColumnRoler% r< r> rL rV r6 rB rC �<module>r� s� �� B� "� � �
� � � � � � � � � � � � � � #� � � � � .� ,� � )� !� ���$�,�,�1�&�-�*� �$�"�.�7�'�,�,� �T�� ����s�d�3�� �T�� ��!�4� !�T 307�308 � �
����� �
� �H�+� H�| ���"�"�$�'�
��309�� ���� �� ����� ��� +� �)� �310�T� 311� ,1� �+@� (� �h��&� �D� �F $)�)>�#?� � �9�j�,�$� ,�312�.� � � �{�
#�313� �t�Y�(9�:� ;� ��D�6�"�� � � �$:�;� ��;�;� 0�1� ��;�;� 0�1� �
�T��#�s�(�+�,������314��315��316� �@�
�A� �A�
�)�
$�)� #�)� �)�)�
$�)� #�)� ?�>� �6� �(�(�);�<�N� �'�'�317�3�M�/� I�1�4�.�)�&�0 ���f� �� �� 6�0� 6�� 6� � 4� �� � 318�I�319 �� ��6 �B� �%�%�&6�7�M� ).�
� �
�!%�
��
� P��8I� I�X � � �@&�(��/�� &�4O�G�E�N�J� O�4 �G�E�N�J� ���U�� 0�� 7���,A9��U���%���%� � �!�!� A9�H�w�u�~�z� � ��� �(8��(?� �25�)�%�0� 5�p3�+�E�2� 3rB