Ë
    íÏj|€  ã            
      ó  — d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm	Z	 dd	lm
Z
 dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z  ddlm!Z! ddlm"Z" ddlm#Z# ddlm$Z$ dd l%m&Z& dd!l'm(Z( dd"l)m*Z* d#dlmZ+ d#d$lm,Z, d#d%lm-Z- d#d&lm)Z) d#d'l.m/Z/ d#d(l.m0Z0 d#d)l1m2Z2 d#d*l3m4Z4 d#d+l3m5Z5 d#d,l6m7Z7 d#d-l8m9Z9 d#d.l8m:Z: d#d/l8m;Z; d#d0l8m<Z< d#d1l8m=Z= d#d2l8m>Z> d#d3l8m?Z? erldd4lm@Z@ dd5lAmBZB dd6lAmCZC dd7lAmDZD dd8lAmEZE dd9lmFZF dd:lGmHZH dd;lImJZJ dd<lKmLZL dd=lMmNZN dd>lMmOZO d#d?lPmQZQ d#d@lRmSZS d#dAlRmTZT d#dBlUmVZV d#dCl8mWZW d#dDl8mXZX d#dEl8mYZY  edFe¬G«      ZZ edHe¬G«      Z[ edIdJ¬G«      Z\g dK¢Z]e-j¼                   G dL„ dMee!eZ   e$eZ   e e-j¾                  «      «       Z` G dN„ dOe`eZ   eeZ   «      Za G dP„ dQee e!eZ   eeZ   «      ZbyR)Sz|MapperProperty implementations.

This is a private module which defines the behavior of individual ORM-
mapped attributes.

é    )Úannotations)ÚAny)Úcast)ÚDict)Úget_args)ÚList)ÚOptional)ÚSequence)ÚSet)ÚTuple)ÚType)ÚTYPE_CHECKING)ÚTypeVar)ÚUnioné   )Ú
attributes)Úexc)Ú_DeclarativeMapped)Úclass_mapper)ÚCompositeProperty)ÚConcreteInheritedProperty)ÚSynonymProperty)Ú_AttributeOptions)Ú_DataclassDefaultsDontSet)Ú_DEFAULT_ATTRIBUTE_OPTIONS)Ú_IntrospectsAnnotations)Ú_MapsColumns)ÚMapperProperty)ÚPropComparator)ÚStrategizedProperty)Ú_COLUMN_TOKEN)ÚRelationshipProperty)Úde_stringify_annotationé   )Ú
ForeignKey)Úlog)Úutil)Ú	coercions)Úroles)Ú_NoArg)ÚColumn)ÚSchemaConst)Ú
TypeEngine)Úde_optionalize_union_types)Úincludes_none)Ú	is_a_type)Ú
is_fwd_ref)Ú	is_pep593)Ú	is_pep695)ÚSelf)Ú
ForwardRef)Ú_IdentityKeyType)Ú_InstanceDict)Ú_ORMColumnExprArgument)Ú_RegistryType)ÚMapped)Ú_DeclarativeMapperConfig)ÚMapper)ÚSession)Ú_InstallLoaderCallableProto)ÚInstanceState)Ú	_InfoType)ÚColumnElement)ÚNamedColumn)ÚOperatorType)Ú_AnnotationScanType)Ú_MatchedOnType)ÚRODescriptorReferenceÚ_T)ÚboundÚ_PTÚ_NCzNamedColumn[Any])ÚColumnPropertyr   r   r"   r   c                  ó  ‡ — e Zd ZU dZeZdZ	 dZded<   ded<   ded	<   d
ed<   dZ	dddddddddddddœ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d!ˆ fd„Z
	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d"d„Zed#d„«       Zed$d„«       Zd%d„Z ej"                  dd«      	 	 d&d„«       Z ej"                  dd«      	 	 d&d„«       Zd'd„Zed'd„«       Zd(d„Zd)ˆ fd„Zd*d„Z	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d+d„Z G d„ dej4                  ee   «      Zd,d „Zˆ xZS )-rK   z¬Describes an object attribute that corresponds to a table column
    or other column expression.

    Public constructor is the :func:`_orm.column_property` function.

    TFzList[NamedColumn[Any]]ÚcolumnsÚboolÚ_is_polymorphic_discriminatorúOptional[str]Ú_mapped_by_synonymzType[PropComparator[_T]]Úcomparator_factory)rM   ÚgroupÚdeferredÚ
instrumentrR   Úactive_historyÚexpire_on_flushÚ_default_scalar_valueÚ_creation_orderrO   rQ   Ú_deferred_column_loaderÚ_raise_column_loaderÚ_renders_in_subqueriesÚ	raiseloadN)Úattribute_optionsrS   rT   r]   rR   rV   Údefault_scalar_valuerW   ÚinfoÚdocÚ_instrumentÚ_assume_readonly_dc_attributesc               ó¼  •— t         ‰| �  ||¬«       |f|z   }|D �cg c]&  }t        j                  t        j
                  |«      ‘Œ( c}| _        || _        || _        || _	        || _
        |�|n| j                  j                  | _        || _        || _        |	| _        |
�| j"                  j%                  |
«       |�|| _        n9t)        | j                  «      D ]  }t+        |dd «      }|€Œ|| _         n d | _        t-        j.                  | «       d| j                  fd| j                  ff| _        | j                  r| xj0                  dz  c_        y y c c}w )N)r^   rc   ra   rT   rU   ))r]   T)ÚsuperÚ__init__r(   Úexpectr)   ÚLabeledColumnExprRolerM   rS   rT   r]   rU   Ú	__class__Ú
ComparatorrR   rV   rX   rW   r`   Úupdatera   ÚreversedÚgetattrr'   Úset_creation_orderÚstrategy_key)ÚselfÚcolumnr^   rS   rT   r]   rR   rV   r_   rW   r`   ra   rb   rc   Úadditional_columnsrM   ÚcÚcolri   s                     €úV/var/www/html/gaurav-v2/venv/lib/python3.12/site-packages/sqlalchemy/orm/properties.pyrf   zColumnProperty.__init__”   si  ø€ ô" 	‰ÑØ/Ø+Ið 	ô 	
ð �)Ð0Ñ0ˆáFMó
ÙFMÀŒI×ÑœU×8Ñ8¸!Õ<Àgñ
ˆŒð ˆŒ
Ø ˆŒØ"ˆŒØ%ˆŒð "Ð-ñ à—‘×*Ñ*ð 	Ôð
 -ˆÔØ%9ˆÔ"Ø.ˆÔàÐØ�I‰I×Ñ˜TÔ"àˆ?ØˆD�Hä §¡Ö-�Ü˜c 5¨$Ó/�Ø‘?Ø"�D”HÙð	 .ð  �”ä×Ñ Ô%ð ˜Ÿ™Ð'Ø˜4Ÿ?™?Ð+ð
ˆÔð �>Š>Ø×ÒÐ!7Ñ7Öð ùòI
s   �+Ec
                óp   — | j                   d   }
|
j                  €||
_        |
j                  €||
_        y y ©Nr   )rM   ÚkeyÚname)rp   Ú	decl_scanÚregistryÚclsÚoriginating_modulerx   Úmapped_containerÚ
annotationÚextracted_mapped_annotationÚis_dataclass_fieldrq   s              ru   Údeclarative_scanzColumnProperty.declarative_scanÑ   s8   € ð —‘˜a‘ˆØ�:‰:ÐØˆFŒJØ�;‰;ÐØˆF�Kð ó    c                ó   — | S ©N© ©rp   s    ru   Úmapper_property_to_assignz(ColumnProperty.mapper_property_to_assignã   s   € àˆrƒ   c                ó|   — | j                   D �cg c]"  }t        |t        «      r|j                  €|df‘Œ$ c}S c c}w rw   )rM   Ú
isinstancer+   Útable)rp   rs   s     ru   Úcolumns_to_assignz ColumnProperty.columns_to_assignç   sC   € ð
 —\’\ó
á!�Ü˜!œVÔ$¨¯©¨ð �ŠFØ!ñ
ð 	
ùò 
s   �'9c                óš   — d| j                   v r| j                  j                  S d| j                   vxs | | j                  j                  vS )N)Úquery_expressionT)rT   T)ro   ÚstrategyÚ_have_default_expressionÚparentÚ_readonly_propsr‡   s    ru   Ú%_memoized_attr__renders_in_subqueriesz4ColumnProperty._memoized_attr__renders_in_subqueriesð   sJ   € Ø%¨×):Ñ):Ñ:Ø—=‘=×9Ñ9Ð9à!¨×):Ñ):Ð:ò 
Ø˜Ÿ™×3Ñ3Ð3ð	
rƒ   zsqlalchemy.orm.statezsqlalchemy.orm.strategiesc                ó  — t         j                  j                  }t         j                  j                  }|j                  j                  | j                  j                  |j                  | j                  «      | j                  «      S r…   ©
r'   Ú	preloadedÚ	orm_stateÚorm_strategiesr?   Ú"_instance_level_callable_processorr‘   Úclass_managerÚ_LoadDeferredColumnsrx   ©rp   ÚstateÚ
strategiess      ru   Ú&_memoized_attr__deferred_column_loaderz5ColumnProperty._memoized_attr__deferred_column_loaderø   sa   € ô —‘×(Ñ(ˆÜ—^‘^×2Ñ2ˆ
Ø×"Ñ"×EÑEØ�K‰K×%Ñ%Ø×+Ñ+¨D¯H©HÓ5Ø�H‰Hó
ð 	
rƒ   c                ó  — t         j                  j                  }t         j                  j                  }|j                  j                  | j                  j                  |j                  | j                  d«      | j                  «      S )NTr•   rœ   s      ru   Ú#_memoized_attr__raise_column_loaderz2ColumnProperty._memoized_attr__raise_column_loader  sc   € ô —‘×(Ñ(ˆÜ—^‘^×2Ñ2ˆ
Ø×"Ñ"×EÑEØ�K‰K×%Ñ%Ø×+Ñ+¨D¯H©H°dÓ;Ø�H‰Hó
ð 	
rƒ   c                ó   — | j                   S )zsAllow the ColumnProperty to work in expression before it is turned
        into an instrumented attribute.
        )Ú
expressionr‡   s    ru   Ú__clause_element__z!ColumnProperty.__clause_element__  s   € ð
 �‰Ðrƒ   c                ó    — | 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   )rM   r‡   s    ru   r£   zColumnProperty.expression  s   € ð( �|‰|˜A‰Ðrƒ   c                ó®   — | j                   sy t        j                  |j                  | j                  | j                  | |«      || j                  ¬«       y )N)Ú
comparatorÚparententityra   )rU   r   Ú_register_descriptorÚclass_rx   rR   ra   )rp   Úmappers     ru   Úinstrument_classzColumnProperty.instrument_class-  sB   € Ø�ŠØä×'Ñ'Ø�M‰MØ�H‰HØ×.Ñ.¨t°VÓ<ØØ—‘ö	
rƒ   c                óf  •— t         ‰| �  «        t        | j                  «      dkD  rŠt	        | j
                  j                  «      j                  | j                  «      rQt        j                  d| j
                  ›d| j                  d   ›d| j                  d   ›d| j                  ›d�	«       y y y )Nr   z
On mapper z, primary key column 'z6' is being combined with distinct primary key column 'r   z' in attribute 'zM'. Use explicit properties to give each column its own mapped attribute name.)re   Údo_initÚlenrM   Úsetr‘   Úprimary_keyÚ
issupersetr'   Úwarnrx   )rp   ri   s    €ru   r®   zColumnProperty.do_init9  s€   ø€ Ü‰‰Ôäˆt�|‰|Ó˜qÒ ¤S¨¯©×)@Ñ)@Ó%A×%LÑ%LØ�L‰Lô&
ô �IŠIð —;“; §¡¨Q£°·±¸a³À$Ç(Ã(ðLõð&
Ð rƒ   c                ó‚   — t        | j                  | j                  | j                  | j                  | j
                  dœŽS )N)rT   rS   rV   r_   )rK   rM   rT   rS   rV   rX   r‡   s    ru   ÚcopyzColumnProperty.copyI  s6   € ÜØ�\‰\Ø—]‘]Ø—*‘*Ø×.Ñ.Ø!%×!;Ñ!;ò
ð 	
rƒ   c	                óR  — | j                   sy | j                  |v rQ|| j                     }	|s|	|| j                  <   y |j                  | j                  «      }
|
j                  |||	d «       y |j                  r/| j                  |vr |j                  || j                  gd¬«       y y y )NT)Ú	no_loader)rU   rx   Úget_implr°   Úhas_identityÚ_expire_attributes)rp   ÚsessionÚsource_stateÚsource_dictÚ
dest_stateÚ	dest_dictÚloadÚ
_recursiveÚ_resolve_conflict_mapÚvalueÚimpls              ru   ÚmergezColumnProperty.mergeR  sœ   € ð �ŠØØ�X‰X˜Ñ$Ø §¡Ñ)ˆEáØ&+�	˜$Ÿ(™(Ò#à!×*Ñ*¨4¯8©8Ó4�Ø—‘˜ Y°°tÕ<Ø×$Ò$¨¯©¸Ñ)BØ×)Ñ)Ø˜DŸH™H˜:°ð *õ ð *CÐ$rƒ   c                  ó˜   — e Zd ZU dZesdZded<   ded<   	 dd„Zerdd„Z	 	 dd	„Z	dd
„Z
dd„Zdd„Z	 	 	 	 	 	 	 	 dd„Z	 	 	 	 	 	 	 	 dd„Zy)úColumnProperty.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¤   r`   Úexpressionsz*RODescriptorReference[ColumnProperty[_PT]]ÚpropúSequence[NamedColumn[Any]]rÈ   c                ó  — | j                   }|||| j                  j                  dœ}|}| j                  j                  r,|}| j                  j                  j                  |«      }||d<   |j                  |«      j                  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.

            )Úentity_namespacer¨   ÚparentmapperÚ	proxy_keyÚadapt_columnÚorm)Úcompile_state_pluginÚplugin_subject)Ú_parententityrÉ   rx   Ú_parentmapperÚ_polymorphic_adapterÚtraverseÚ	_annotateÚ_set_propagate_attrs)rp   rq   Úper   rt   Úmapper_local_cols         ru   Ú_orm_annotate_columnz.ColumnProperty.Comparator._orm_annotate_columnŽ  s”   € ð ×#Ñ#ˆBà$&Ø "Ø "Ø!ŸY™YŸ]™]ñ	+ˆKð ˆCð ×!Ñ!×6Ò6Ø#&Ð Ø×(Ñ(×=Ñ=×FÑFÀsÓK�ð
 /?�˜NÑ+à—=‘= Ó-×BÑBØ).À"ÑEóð rƒ   c                 ó   — y r…   r†   r‡   s    ru   r¤   z,ColumnProperty.Comparator.__clause_element__¸  s   € ¸crƒ   c                óä   — | j                   r=| j                  | j                  j                  d   | j                  j                  «      S | j	                  | j                  j                  d   «      S rw   ©ÚadapterrÉ   rM   rx   rÛ   r‡   s    ru   Ú#_memoized_method___clause_element__z=ColumnProperty.Comparator._memoized_method___clause_element__º  sS   € ð �|Š|Ø—|‘| D§I¡I×$5Ñ$5°aÑ$8¸$¿)¹)¿-¹-ÓHÐHà×0Ñ0°·±×1BÑ1BÀ1Ñ1EÓFÐFrƒ   c                ó†   — | j                  «       }	 |j                  S # t        $ r | j                  j                  cY S w xY w)z(The .info dictionary for this attribute.)r¤   r`   ÚAttributeErrorrÉ   )rp   Úces     ru   Ú_memoized_attr_infoz-ColumnProperty.Comparator._memoized_attr_infoÂ  s=   € ð ×(Ñ(Ó*ˆBð&Ø—w‘w�øÜ!ò &Ø—y‘y—~‘~Ò%ð&ús   ’ žA ¿A c                ó$  — | j                   rH| j                  j                  D �cg c](  }| j                  || j                  j                  «      ‘Œ* c}S | j                  j                  D �cg c]  }| j	                  |«      ‘Œ c}S c c}w c c}w )z{The full sequence of columns referenced by this
            attribute, adjusted for any aliasing in progress.

            rÞ   )rp   rt   s     ru   Ú_memoized_attr_expressionsz4ColumnProperty.Comparator._memoized_attr_expressionsË  s‰   € ð
 �|Š|ð  $Ÿy™y×0Ò0óá0˜ð —L‘L  d§i¡i§m¡mÕ4Ø0ñð ð ?C¿i¹i×>OÒ>OóÙ>O°s�D×-Ñ-¨cÕ2Ð>Oñð ùòùò
s   ¥-BÁ-Bc                ó6   — t        | j                  «       |«      S )z‡proxy attribute access down to the mapped column.

            this allows user-defined comparison methods to be accessed.
            )rm   r¤   )rp   rx   s     ru   Ú_fallback_getattrz+ColumnProperty.Comparator._fallback_getattrÚ  s   € ô
 ˜4×2Ñ2Ó4°cÓ:Ð:rƒ   c                ó6   —  || j                  «       g|¢­i |¤ŽS r…   ©r¤   ©rp   ÚopÚotherÚkwargss       ru   Úoperatez!ColumnProperty.Comparator.operateá  s"   € ñ �d×-Ñ-Ó/ÐB°%ÒB¸6ÑBÐBrƒ   c                óV   — | j                  «       } ||j                  ||«      |fi |¤ŽS r…   ©r¤   Ú_bind_param©rp   rì   rí   rî   rt   s        ru   Úreverse_operatez)ColumnProperty.Comparator.reverse_operateæ  s/   € ð ×)Ñ)Ó+ˆCÙ�c—o‘o b¨%Ó0°#Ñ@¸Ñ@Ð@rƒ   N)rq   rJ   ÚreturnrJ   )rõ   zNamedColumn[_PT])rõ   r@   )rõ   rÊ   )rx   Ústrrõ   r   ©rì   rC   rí   r   rî   r   rõ   zColumnElement[Any])Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   Ú	__slots__Ú__annotations__rÛ   r¤   rà   rä   ræ   rè   rï   rô   r†   rƒ   ru   rj   rÇ   l  s¢   … ñ	ñ$ àCˆIà8Ó8à/Ó/ð	ó&	ñP ãAð	Gàó	Gó	&ó	ó	;ð	CØ"ð	CØ,/ð	CØ;>ð	Càó	Cð
	AØ"ð	AØ+.ð	AØ:=ð	Aàô	Arƒ   rj   c                óÎ   — | j                   r| j                  st        j                  | «      S t	        | j                   j
                  j                  «      dz   | j                  z   S )NÚ.)r‘   rx   ÚobjectÚ__repr__rö   rª   rø   r‡   s    ru   Ú__str__zColumnProperty.__str__ì  sG   € Ø�{Š{ $§(¢(Ü—?‘? 4Ó(Ð(Ü�4—;‘;×%Ñ%×.Ñ.Ó/°#Ñ5¸¿¹Ñ@Ð@rƒ   )rq   z_ORMColumnExprArgument[_T]rr   z_ORMColumnExprArgument[Any]r^   zOptional[_AttributeOptions]rS   rP   rT   rN   r]   rN   rR   z"Optional[Type[PropComparator[_T]]]rV   rN   r_   r   rW   rN   r`   zOptional[_InfoType]ra   rP   rb   rN   rc   rN   ©rz   r;   r{   r9   r|   ú	Type[Any]r}   rP   rx   rö   r~   zOptional[Type[Mapped[Any]]]r   úOptional[_AnnotationScanType]r€   r  r�   rN   rõ   ÚNone©rõ   zOptional[MapperProperty[_T]]©rõ   zList[Tuple[Column[Any], int]])rõ   rN   )rõ   z _InstallLoaderCallableProto[Any])rõ   zroles.ColumnsClauseRole)r«   zMapper[Any]rõ   r  )rõ   r  )rõ   zColumnProperty[_T])r»   r=   r¼   úInstanceState[Any]r½   r7   r¾   r	  r¿   r7   rÀ   rN   rÁ   zDict[Any, object]rÂ   z#Dict[_IdentityKeyType[Any], object]rõ   r  ©rõ   rö   ) rø   rù   rú   rû   r!   Ústrategy_wildcard_keyÚinherit_cacheÚ_links_to_entityrý   rü   rf   r‚   Úpropertyrˆ   rŒ   r“   r'   Úpreload_modulerŸ   r¡   r¤   r£   r¬   r®   rµ   rÅ   ÚMemoizedSlotsr   rI   rj   r  Ú__classcell__)ri   s   @ru   rK   rK   e   sŽ  ø… ñð *ÐØ€MØàÐà#Ó#à#'Ó'à%Ó%à0Ó0ð€Ið, :>Ø#ØØØAEØ$Ø$(Ø $Ø$(Ø!Ø Ø/4ñ;8à*ð;8ð 9ð;8ð 7ð	;8ð
 ð;8ð ð;8ð ð;8ð ?ð;8ð ð;8ð "ð;8ð ð;8ð "ð;8ð ð;8ð ð;8ð )-õ;8ðzà+ðð  ðð ð	ð
 *ðð ðð 6ðð 2ðð &Cðð !ðð 
óð$ òó ðð ò
ó ð
ó
ð €T×ÑÐ/Ð1LÓMð	
à	)ò	
ó Nð	
ð €T×ÑÐ/Ð1LÓMð	
à	)ò	
ó Nð	
óð òó ðó*

õó 
ðàðð )ðð #ð	ð
 'ðð !ðð ðð &ðð  Cðð 
óô4~A�T×'Ñ'¨¸Ñ)<ô ~A÷@Arƒ   rK   c                  ó   — e Zd ZdZdZy)Ú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ƒ   ru   r  r  ò  s   „ ñð €MØrƒ   r  c                  ó–  — e Zd ZU dZdZded<   ded<   ded<   d	ed
<   ded<   ded<   dd„Zdd„Zed d„«       Z	ed!d„«       Z
ed"d„«       Zd#d„Z	 	 	 	 	 	 	 	 d$d„Z	 	 	 	 	 	 	 	 d$d„Zd%d„Z	 	 	 	 	 	 	 	 d&d„Z	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d'd„Z ej&                  d«      	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d(d„«       Z	 	 	 	 	 	 	 	 	 	 	 	 	 	 d)d„Zy)*Ú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


    )rq   rY   Ú_sort_orderÚforeign_keysÚ_has_nullableÚ_has_insert_defaultrT   Údeferred_groupÚdeferred_raiseloadrV   rX   Ú_attribute_optionsÚ_has_dataclass_argumentsÚ_use_existing_columnzUnion[_NoArg, bool]rT   rN   r  rP   r  ú
Column[_T]rq   zOptional[Set[ForeignKey]]r  r   r  c                óä  ‡— |j                  dt        «      x| _        Š|j                  dd«      | _        ‰d uxr2 ‰t        k7  xr' t	        ˆfd„t        ‰j                  «      D «       «      | _        |j                  dt        j                  «      }|t        j                  u| _        t        j                  | _        ‰j                  t        j                  ur‰j                  |d<   |j                  dd «      | _        |j                  dd «      | _        |j                  d	t        j                  «      | _        |j                  d
d«      | _        |j                  dt        j                  «      | _        t'        dt)        |i |¤Ž«      | _        | j*                  j,                  | _        d|v xr# |j                  d«      d t.        j0                  fv| _        t5        j6                  | «       y )Nr^   Úuse_existing_columnFc              3  óX   •K  — | ]!  \  }}|d k7  r‰|   t         j                  u–— Œ# y­w)Údataclasses_defaultN)r*   ÚNO_ARG)Ú.0ÚiÚattrÚ	attr_optss      €ru   Ú	<genexpr>z(MappedColumn.__init__.<locals>.<genexpr>;  s3   øè ø€ ð á;‘G�A�tØÐ0Ò0ð ˜!‘¤F§M¡MÔ1Ù;ùs   ƒ'*Úinsert_defaultÚdefaultr  r  rT   rV   Ú
sort_orderr  Únullable)Úpopr   r  r  ÚanyÚ	enumerateÚ_fieldsr  Úgetr*   r$  r  rX   r#  r  r  rT   rV   r  r   r+   rq   r  r,   ÚNULL_UNSPECIFIEDr  r'   rn   )rp   ÚargÚkwr*  r(  s       @ru   rf   zMappedColumn.__init__1  sª  ø€ Ø.0¯f©fØÔ!;ó/
ð 	
ˆÔ )ð %'§F¡FÐ+@À%Ó$HˆÔ!ð ˜TÐ!ò ØÔ7Ñ7òäó ä(¨×):Ñ):Ô;óó ð 	Ô%ð Ÿ™Ð 0´&·-±-Ó@ˆØ#1¼¿¹Ð#FˆÔ Ü%+§]¡]ˆÔ"à×(Ñ(´·±Ñ=Ø%×9Ñ9ˆBˆy‰Mà Ÿf™fÐ%5°tÓ<ˆÔØ"$§&¡&Ð)=¸tÓ"DˆÔØŸ™˜z¬6¯=©=Ó9ˆŒØ Ÿf™fÐ%5°uÓ=ˆÔàŸ6™6 ,´·±Ó>ˆÔô ˜<¬°Ð);¸Ñ);Ó<ˆŒà ŸK™K×4Ñ4ˆÔØ'¨2Ð-ò 
°"·&±&¸Ó2DØÜ×(Ñ(ðM
ð 3
ˆÔô 	×Ñ Õ%rƒ   c                óh  — | j                   j                  | j                   «      } | j                  j                  di |¤Ž|_        | j                  |_        | j
                  |_        | j                  |_        |j                  j                  |_        | j                  |_        | j                  |_	        | j                  |_
        | j                  |_        | j                  |_        | j                  |_        | j                  |_        | j                  |_        t!        j"                  |«       |S )Nr†   )ri   Ú__new__rq   Ú_copyrT   r  r  r  rV   r  r  r  r  r  r  rX   r'   rn   )rp   r5  Únews      ru   r8  zMappedColumn._copy]  sð   € Ø�n‰n×$Ñ$ T§^¡^Ó4ˆØ&�T—[‘[×&Ñ&Ñ,¨Ñ,ˆŒ
Ø—}‘}ˆŒØ!×0Ñ0ˆÔØ!%×!8Ñ!8ˆÔØŸ:™:×2Ñ2ˆÔØ!×0Ñ0ˆÔØ ×.Ñ.ˆÔØ!%×!8Ñ!8ˆÔØ"&×":Ñ":ˆÔØ'+×'DÑ'DˆÔ$Ø#'×#<Ñ#<ˆÔ Ø×*Ñ*ˆŒØ$(×$>Ñ$>ˆÔ!Ü×Ñ Ô$Øˆ
rƒ   c                ó.   — | j                   j                  S r…   )rq   ry   r‡   s    ru   ry   zMappedColumn.nameo  s   € à�{‰{×ÑÐrƒ   c           
     ó¼  — | j                   }|t        j                  u r#t        | j                  xs | j
                  «      }|s(| j                  s| j                  t        j                  urqt        | j                  || j                  | j
                  | j                  | j                  | j                  t        j                  ur| j                  ¬«      S d ¬«      S y )N)rT   rS   r]   r^   rV   r_   )rT   r*   r$  rN   r  r  rV   rX   rK   rq   r  )rp   Úeffective_deferreds     ru   rˆ   z&MappedColumn.mapper_property_to_assigns  sÅ   € à!Ÿ]™]ÐØ¤§¡Ñ.Ü!%Ø×#Ñ#Ò> t×'>Ñ'>ó"Ðñ
 Ø×"Ò"Ø×)Ñ)´·±Ñ>ä!Ø—‘Ø+Ø×)Ñ)Ø×1Ñ1Ø"&×"9Ñ"9Ø#×2Ñ2ð ×1Ñ1¼¿¹ÑFð ×.Ñ.ôð ð ôð ð rƒ   c                ót   — | j                   | j                  t        j                  ur| j                  fgS dfgS rw   )rq   r  r*   r$  r‡   s    ru   rŒ   zMappedColumn.columns_to_assign�  sM   € ð —‘ð ×'Ñ'¬v¯}©}Ñ<ð ×$Ñ$ðð	
ð 		
ð ðð	
ð 		
rƒ   c                ó   — | j                   S r…   )rq   r‡   s    ru   r¤   zMappedColumn.__clause_element__�  s   € Ø�{‰{Ðrƒ   c                ó6   —  || j                  «       g|¢­i |¤ŽS r…   rê   rë   s       ru   rï   zMappedColumn.operate   s"   € ñ �$×)Ñ)Ó+Ð>¨eÒ>°vÑ>Ð>rƒ   c                óV   — | j                  «       } ||j                  ||«      |fi |¤ŽS r…   rñ   ró   s        ru   rô   zMappedColumn.reverse_operate¥  s/   € ð ×%Ñ%Ó'ˆÙ�#—/‘/ " eÓ,¨cÑ<°VÑ<Ð<rƒ   c                ó   — t        «       S r…   )r  r‡   s    ru   Úfound_in_pep593_annotatedz&MappedColumn.found_in_pep593_annotated«  s   € ô ‹~Ðrƒ   c                ó<  — | j                   r�|j                  rƒ|j                  rw|j                  rt	        j
                  d«      ‚t        |j                  d«      }|j                  �|j                  n|}|j                  j                  j                  ||«      }|S )Nz3Can't use use_existing_column with deferred mappersF)r  ÚinheritsÚsingleÚis_deferredÚsa_excÚArgumentErrorr   ry   Úlocal_tablers   r2  )rp   rz   rx   Úgiven_columnÚsupercls_mapperÚcolnames         ru   Ú_adjust_for_existing_columnz(MappedColumn._adjust_for_existing_column°  sš   € ð ×%Ò%Ø×"Ò"Ø× Ò à×$Ò$Ü×*Ñ*ØIóð ô +¨9×+=Ñ+=¸uÓEˆOð &2×%6Ñ%6Ð%B�×!Ò!Èð ð +×6Ñ6×8Ñ8×<Ñ<Ø˜óˆLð Ðrƒ   c
                ód  — | j                   }
| j                  ||| j                   «      x}
| _         |
j                  €||
_        |
j                  €||
_        |
j                  }|€6|j
                  r)| j                   j                  s| j                  ||«       ny | j                  ||||||«       y r…   )	rq   rM  rx   ry   ÚtypeÚ_isnullr  Ú_raise_for_requiredÚ_init_column_for_annotation)rp   rz   r{   r|   r}   rx   r~   r   r€   r�   rq   Úsqltypes               ru   r‚   zMappedColumn.declarative_scanÉ  sª   € ð —‘ˆà#×?Ñ?Ø�s˜DŸK™Kó 
ð 	
ˆ�”ð �:‰:ÐØˆFŒJØ�;‰;ÐØˆFŒKà—+‘+ˆà&Ð.Ø�Š t§{¡{×'?Ò'?Ø×(Ñ(¨¨cÕ2àà×(Ñ(ØØØØØ'Øõ	
rƒ   zsqlalchemy.orm.decl_basec                óœ   — t         j                  j                  }|j                  || j                  «       | j                  ||||||«       y r…   )r'   r–   Úorm_decl_baseÚ_undefer_column_namerq   rR  )	rp   rz   r{   r|   r}   rx   Ú
param_nameÚparam_annotationÚ	decl_bases	            ru   Údeclarative_scan_for_compositez+MappedColumn.declarative_scan_for_compositeñ  sD   € ô —N‘N×0Ñ0ˆ	Ø×&Ñ& z°4·;±;Ô?Ø×(Ñ(Ø�˜C Ð+;Ð=Oõ	
rƒ   c           
     ór
  — | j                   j                  }t        |dd¬«      r|€J ‚t        |||d¬«      }n t        rt        |t        t        f«      rJ ‚|}t        |«      }	| j                  s|	| j                   _
        d}
d x}}d x}}t        |«      }t        |«      r+|}t        |j                  «      }t        |«      }|r||   }|}t        |«      r$t        |«      }|}|d   }|	rt        |«      }|dd  }
|
D ]  }t        |t         «      sŒ|} n d }|��g|j#                  ||| j                   «      | _         | j$                  s&| j&                  j(                  t*        j,                  urd}nd}|j                   j/                  | j                   |¬«       | j                   j                  }|j0                  t*        j,                  ur-| j0                  t*        j,                  u r|j0                  | _        |j2                  �| j2                  €|j2                  | _        |j4                  �| j4                  €|j4                  | _        |j6                  r| j6                  sd| _        |j8                  r|j8                  | _        |j:                  �-| j:                  t*        j,                  u r|j:                  | _        |j                   j<                  €|j                   j>                  �tA        jB                  d	d
«       |jD                  rstG        |j&                  jH                  «      D ]Q  \  }}|j&                  |   t*        j,                  usŒ&|jK                  dd«      }tA        jB                  d|› d�d
«       ŒS |jL                  �r©| j                   jN                  �s‘|jQ                  ||||||||¬«      }|�€Yg }|r|jS                  |«       |jS                  |«       |r|jS                  |«       t        |tT        «      s t        |t        «      r@tW        |tT        «      r0tY        jZ                  d| j                   j<                  ›d|› d�«      ‚t]        |d   «      r‚t_        |«      dk(  rd}n<t_        |«      dk(  rd|d   › d|d   › d�}nddja                  d„ |D «       «      z   dz   }tY        jZ                  d|d   › d| j                   j<                  ›d|› �«      ‚tY        jZ                  d| j                   j<                  ›d |›d!�«      ‚| j                   jc                  |«       y y y )"NT)Úcheck_genericÚcheck_for_plain_string)Úinclude_genericr†   r   r   F)Úomit_defaultsz_Can't use the 'key' or 'name' arguments in Annotated with mapped_column(); this will be ignoredz2.0.22Údataclasses_Ú z
Argument 'zp' is a dataclass argument and cannot be specified within a mapped_column() bundled inside of an Annotated object)Úraw_pep_593_typeÚpep_593_resolved_argumentÚraw_pep_695_typeÚpep_695_resolved_valuezThe type provided inside the z4 attribute Mapped annotation is the SQLAlchemy type z . Expected a Python type insteadz1the type object is not resolvable by the registryr$   z	neither 'z' nor 'z ' are resolvable by the registryznone of z, c              3  ó(   K  — | ]
  }d |› d �–— Œ y­w)Ú'Nr†   )r%  Úts     ru   r)  z;MappedColumn._init_column_for_annotation.<locals>.<genexpr>º  s   è ø€ Ð'A¹&°Q¨!¨A¨3¨a¬¹&ùs   ‚z are resolvable by the registryzSCould not locate SQLAlchemy Core type when resolving for Python type indicated by 'z)' inside the Mapped[] annotation for the z attribute; zThe object provided inside the zC attribute Mapped annotation is not a Python type, it's the object z. Expected a Python type.)2rq   rO  r1   r#   r   rŠ   rö   r5   r/   r  r-  r.   r3   Ú	__value__r   r2   r  rM  r  r  r#  r*   r$  Ú_mergerT   r  r  r  rV   r  rx   ry   r'   Úwarn_deprecatedr  r0  r1  ÚreplacerP  r  Ú_resolve_type_with_eventsÚappendr-   Ú
issubclassÚorm_excÚMappedAnnotationErrorr0   r¯   ÚjoinÚ	_set_type)rp   r|   rz   rx   r{   Úargumentr}   rS  Úde_stringified_argumentr-  Úfind_mapped_inrb  Úresolved_pep_593_typerd  Úresolved_pep_695_typeÚour_typeÚour_argsÚpep_593_componentsÚelemÚuse_args_fromr_  Úidxr4  Únew_sqltypeÚchecksÚdetails                             ru   rR  z(MappedColumn._init_column_for_annotation  sl  € ð —+‘+×"Ñ"ˆô Ø DÀõ
ð &Ð1Ð1Ð1Ü&=Ø�XÐ1À4ô'Ñ#õ Ü% h´´jÐ0AÔBÐBÐBØ&.Ð#ä Ð!8Ó9ˆà×!Ò!Ø#+ˆD�K‰KÔ à*,ˆØ37Ð7ÐÐ0Ø37Ð7ÐÐ0ä2Ð3JÓKˆä�XÔØ'ÐÜ1Ð2B×2LÑ2LÓMˆHÜÐ 0Ó1ˆHÙØ# HÑ-�à$,Ð!ä�XÔÜ!)¨(Ó!3ÐØ'ÐØ$6°qÑ$9Ð!ÙÜ(BØ)ó)Ð%ð 0°°Ð3ˆNó #ˆDÜ˜$¤Õ-Ø $�Ùð #ð
 !ˆMàÑ$à'×CÑCØ˜3 §¡óˆDŒKð
 ×(Ò(Ø×*Ñ*×>Ñ>Ü—}‘}ñ%ð !%‘à %�à× Ñ ×'Ñ'Ø—‘¨=ð (ô ð —k‘k×&Ñ&ˆGð ×&Ñ&¬f¯m©mÑ;Ø—M‘M¤V§]¡]Ñ2à -× 6Ñ 6�”ð ×,Ñ,Ð8Ø×'Ñ'Ð/à&3×&BÑ&B�Ô#ð ×0Ñ0Ð<Ø×+Ñ+Ð3à*7×*JÑ*J�Ô'ð ×2Ò2Ø×1Ò1à,0�Ô)à×+Ò+Ø&3×&BÑ&B�Ô#ð ×)Ñ)Ð5Ø×$Ñ$¬¯©Ñ5à#0×#<Ñ#<�Ô ð ×$Ñ$×(Ñ(Ð4Ø ×'Ñ'×,Ñ,Ð8ä×$Ñ$ðKàôð ×5Ò5Ü )Ø!×4Ñ4×<Ñ<ö!‘H�C˜ð &×8Ñ8¸Ñ=Ü%Ÿ}™}ò-ð "Ÿk™k¨.¸"Ó=˜Ü×,Ñ,Ø(¨¨ð .Dð Dð %õ	ð!ð �?‹? 4§;¡;×#;Ó#;à"×<Ñ<ØØØ'ØØ!1Ø*?Ø!1Ø'<ð =ó 	ˆKð Ñ"Ø�Ù#Ø—M‘MÐ"2Ô3Ø—‘˜hÔ'Ù(Ø—M‘MÐ"7Ô8Ü˜h¬
Ô3Ü˜x¬Ô.Ü" 8¬ZÔ8ä!×7Ñ7Ø7¸¿¹¿¹Ð7Jð KNà#˜*Ð$DðFóð ô
 ˜v a™yÔ)Ü˜6“{ aÒ'àOñ ô ˜V›¨Ò)à'¨¨q©	 {°'¸&À¹)¸ð E=ð =ñ ð 'Ø"Ÿi™iÑ'A¹&Ó'AÓAñBà?ñ@ð ô
 "×7Ñ7ð9Ø9?À¹¸ð D7à7;·{±{·±Ð6Ið J&Ø&, Xð	/óð ô "×7Ñ7Ø9¸$¿+¹+¿/¹/Ð9Lð M+à+BÐ*Eð F2ð2óð ð �K‰K×!Ñ! +Õ.ðy $<ˆ?rƒ   N)r4  r   r5  r   )r5  r   rõ   r4   r
  r  r  )rõ   r  r÷   )rõ   r   )rz   r;   rx   rö   rJ  r  rõ   r  r  )rz   r;   r{   r9   r|   r  r}   rP   rx   rö   rW  rö   rX  rD   rõ   r  )r|   r  rz   r;   rx   rö   r{   r9   rt  rD   r}   rP   rõ   r  )rø   rù   rú   rû   rü   rý   rf   r8  r  ry   rˆ   rŒ   r¤   rï   rô   rB  rM  r‚   r'   r  rZ  rR  r†   rƒ   ru   r  r    s$  … ñð€Ið" "Ó!ØÓØ!Ó!àÓØ+Ó+Ø)Ó)ó*&óXð$ ò ó ð ð òó ðð8 ò

ó ð

óð?Øð?Ø(+ð?Ø7:ð?à	ó?ð
=Øð=Ø'*ð=Ø69ð=à	ó=óð
à+ðð ðð !ð	ð
 
óð2&
à+ð&
ð  ð&
ð ð	&
ð
 *ð&
ð ð&
ð 6ð&
ð 2ð&
ð &Cð&
ð !ð&
ð 
ó&
ðP €T×ÑÐ3Ó4ð
à+ð
ð  ð
ð ð	
ð
 *ð
ð ð
ð ð
ð .ð
ð 
ò
ó 5ð
ð J/àðJ/ð ,ðJ/ð ð	J/ð
  ðJ/ð &ðJ/ð *ðJ/ð 
ôJ/rƒ   r  N)crû   Ú
__future__r   Útypingr   r   r   r   r   r	   r
   r   r   r   r   r   r   ra  r   r   rp  Úbaser   r   Údescriptor_propsr   r   r   Ú
interfacesr   r   r   r   r   r   r   r    Úpath_registryr!   Úrelationshipsr"   r'   r#   rG  r%   r&   Úsqlr(   r)   Úsql.baser*   Ú
sql.schemar+   r,   Úsql.type_apir-   Úutil.typingr.   r/   r0   r1   r2   r3   r4   r5   Ú_typingr6   r7   r8   r9   r:   rY  r;   r«   r<   r»   r=   r�   r>   r?   Úsql._typingr@   Úsql.elementsrA   rB   Úsql.operatorsrC   rD   rE   rF   rG   rI   rJ   Ú__all__Úclass_loggerÚ
IdentifiedrK   r  r  r†   rƒ   ru   Ú<module>r•     s‚  ðñõ #å Ý Ý Ý Ý Ý Ý Ý Ý Ý Ý  Ý Ý å Ý Ý $Ý Ý /Ý 7Ý -Ý )Ý 1Ý 2Ý /Ý $Ý &Ý &Ý +Ý (Ý /Ý )Ý Ý Ý Ý Ý Ý Ý Ý Ý $Ý %Ý 4Ý 'Ý #Ý $Ý #Ý #Ý áÝ!å)Ý&Ý/Ý&ÝÝ3ÝÝ Ý2Ý$Ý'Ý,Ý*Ý,Ý1Ý,Ý3áˆT˜Ô€Ùˆe˜3Ô€ÙˆeÐ-Ô.€ò€ð ×ÑôIAØØ�ÑØ˜ÑØØ‡N�NóIAó ðIAôX˜.¨Ñ,Ð.@ÀÑ.Dô ô$H/ØØØ�ÑØ�rÑõ	H/rƒ   