a
    •˜ëj£“  ã                   @  s   U d Z ddlmZ ddlmZ ddlZddlZddlZddl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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)l1m3Z3 d d*l1m4Z4 ej�r*dd+l5m6Z6 dd,l5m7Z7 dd-lm8Z8 dd.lm9Z9 dd/lm:Z: dd0l;m<Z< dd1l=m>Z> dd2l?m@Z@ dd3lAmBZB dd4lAmCZC dd5lDmEZE d d6lFmGZG d d7lHmIZI d d8lJmKZK d d9lJmLZL d d:l/mMZM d d;l/mNZN d d<lOmPZP d d=lQmRZR d d>lSmTZT d d?l1mUZU d d@l1mVZV d dAl1mWZW d dBl1mXZX edCe	dD�ZYedEe	dD�ZZG dFdG„ dGe$eY ƒZ[ee\dHdIdJdKf Z]edLe	dD�Z^e _¡ Z`dMeadN< G dOdP„ dPe#e^ e"e[e^ ƒZbG dQdR„ dRebeY eeY ƒZcG dSdT„ dTe[eY ƒZdG dUdV„ dVe[eY ƒZeG dWdX„ dXeeeY eeY ƒZfdS )YzŸDescriptor properties are more "auxiliary" properties
that exist as configurational elements, but don't participate
as actively in the load/persist ORM loop.

é    )Úannotations)Úis_dataclassN)ÚAny)ÚCallable)ÚDict)ÚList)ÚNoReturn)ÚOptional)ÚSequence)ÚTuple)ÚType)ÚTYPE_CHECKING)ÚTypeVar)ÚUnioné   )Ú
attributes)Úutil)Ú_DeclarativeMapped)ÚLoaderCallableStatus)ÚMapped)ÚPassiveFlag)ÚSQLORMOperations)Ú_AttributeOptions)Ú_IntrospectsAnnotations)Ú_MapsColumns)ÚMapperProperty)ÚPropComparator)Ú	_none_set)Úde_stringify_annotationé   )Úevent)Úexc)Úschema)Úsql©Ú
expression)Ú	operators)ÚBindParameter)Úget_args)Ú
is_fwd_ref)Ú	is_pep593)Ú_InstanceDict)Ú_RegistryType)ÚHistory)ÚInstrumentedAttribute)ÚQueryableAttribute)ÚORMCompileState)Ú_ClassScanMapperConfig)ÚMapper)ÚColumnProperty©ÚMappedColumn)ÚInstanceState)Ú
Connection)ÚRow)Ú_DMLColumnArgument)Ú	_InfoType)Ú
ClauseList)ÚColumnElement)ÚOperatorType)ÚColumn)ÚSelect)Ú_AnnotationScanType)ÚCallableReference)ÚDescriptorReference)ÚRODescriptorReferenceÚ_T)ÚboundÚ_PTc                   @  sf   e Zd ZU dZdZded< dZdZded< dd	œd
d„Ze	j
fdddddœdd„Zdddœdd„ZdS )ÚDescriptorPropertyzO:class:`.MapperProperty` which proxies access to a
    user-defined descriptor.NúOptional[str]ÚdocFzDescriptorReference[Any]Ú
descriptorú!Sequence[QueryableAttribute[Any]]©Úreturnc                 C  s   t dƒ‚d S )Nz?This MapperProperty does not implement column loader strategies©ÚNotImplementedError©Úself© rR   ú^/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/sqlalchemy/orm/descriptor_props.pyÚ_column_strategy_attrsf   s    ÿz)DescriptorProperty._column_strategy_attrsúInstanceState[Any]r+   r   r-   ©ÚstateÚdict_ÚpassiverM   c                 C  s
   t ƒ ‚d S ©NrN   ©rQ   rW   rX   rY   rR   rR   rS   Úget_historyk   s    zDescriptorProperty.get_historyúMapper[Any]ÚNone©ÚmapperrM   c                   sð   ˆ‰G ‡fdd„dt jƒ}ˆjd u rHtˆ jˆjd ƒ}ˆ  ˆj|¡rH|ˆ_ˆjd u r ddddœ‡fdd„}dddœ‡fd	d
„}dddœ‡fdd„}t|||d�ˆ_t  ˆj¡ˆj	jˆjˆj‡ ‡fdd„ˆj
ˆd�}|ˆjƒ|_ˆ j ˆj|¡ d S )Nc                      sZ   e Zd ZdZdZdZeddœ‡ fdd„ƒZddœd	d
„Ze	j
fdddddœ‡ fdd„ZdS )z7DescriptorProperty.instrument_class.<locals>._ProxyImplFTÚboolrL   c                   s   ˆ j S rZ   )Úuses_objectsrP   ©ÚproprR   rS   rb   {   s    zDDescriptorProperty.instrument_class.<locals>._ProxyImpl.uses_objectsÚstr©Úkeyc                 S  s
   || _ d S rZ   rf   )rQ   rg   rR   rR   rS   Ú__init__   s    z@DescriptorProperty.instrument_class.<locals>._ProxyImpl.__init__rU   r+   r   r-   rV   c                   s   ˆ   |||¡S rZ   )r\   r[   rc   rR   rS   r\   ‚   s    zCDescriptorProperty.instrument_class.<locals>._ProxyImpl.get_historyN)Ú__name__Ú
__module__Ú__qualname__Zaccepts_scalar_loaderZload_on_unexpireZ
collectionÚpropertyrb   rh   r   ÚPASSIVE_OFFr\   rR   rc   rR   rS   Ú
_ProxyImplv   s   ürn   r   r^   )ÚobjÚvaluerM   c                   s   t | ˆ j|ƒ d S rZ   )ÚsetattrÚname)ro   rp   rP   rR   rS   Úfset‘   s    z1DescriptorProperty.instrument_class.<locals>.fset)ro   rM   c                   s   t | ˆ jƒ d S rZ   )Údelattrrr   ©ro   rP   rR   rS   Úfdel”   s    z1DescriptorProperty.instrument_class.<locals>.fdelc                   s   t | ˆ jƒS rZ   )Úgetattrrr   ru   rP   rR   rS   Úfget—   s    z1DescriptorProperty.instrument_class.<locals>.fget)rx   rs   rv   c                     s
   ˆ  ˆ ¡S rZ   )Ú_comparator_factoryrR   )r`   rQ   rR   rS   Ú<lambda>    ó    z5DescriptorProperty.instrument_class.<locals>.<lambda>)rI   Zoriginal_property)r   ZAttributeImplrJ   rw   Úclass_rg   Z_is_userland_descriptorrl   Zcreate_proxied_attributeÚparentrI   ÚimplÚclass_managerZinstrument_attribute)rQ   r`   rn   Údescrs   rv   rx   Ú
proxy_attrrR   )r`   rd   rQ   rS   Úinstrument_classs   s*    


úz#DescriptorProperty.instrument_class)ri   rj   rk   Ú__doc__rI   Ú__annotations__rb   Z_links_to_entityrT   r   rm   r\   r‚   rR   rR   rR   rS   rG   [   s   
	ürG   z
Column[_T]zMappedColumn[_T]zInstrumentedAttribute[_T]z
Mapped[_T]Ú_CCzFweakref.WeakKeyDictionary[Type[Any], Callable[[Any], Tuple[Any, ...]]]Ú_composite_gettersc                      s@  e Zd ZU dZded< ded< ded< ded	< dcd
ddd
d
d
dœddddddddddœ	‡ fdd„Zdddœ‡ fdd„Zdddœd d!„Zdd"œd#d$„Ze	ƒ Z
dd"œd%d&„Ze d'¡d(d)d*dd+d,d-d-ddd.œ
d/d0„ƒZdd"œd1d2„Ze d'¡e d3¡d(d)d*dd+dd4œd5d6„ƒƒZejd7d"œd8d9„ƒZeje d:¡d;d"œd<d=„ƒƒZd7d"œd>d?„Zeje d:¡d@d"œdAdB„ƒƒZedCd"œdDdE„ƒZedFd"œdGdH„ƒZe d:¡dd"œdIdJ„ƒZdd"œdKdL„ZejdMd"œdNdO„ƒZdPd"œdQdR„ZejfdSdTdUdVdWœdXdY„Z ddZdœd[d\„Z!G d]d^„ d^e"j#e$ ƒZ%G d_d`„ d`e&e' ƒZ(d+d"œdadb„Z)‡  Z*S )dÚCompositePropertyzöDefines a "composite" mapped attribute, representing a collection
    of columns as one attribute.

    :class:`.CompositeProperty` is constructed using the :func:`.composite`
    function.

    .. seealso::

        :ref:`mapper_composite`

    z$Union[Type[_CC], Callable[..., _CC]]Úcomposite_classz#Tuple[_CompositeAttrType[Any], ...]Úattrsz=CallableReference[Optional[Callable[[_CC], Tuple[Any, ...]]]]Ú_generated_composite_accessorzType[Comparator[_CC]]Úcomparator_factoryNF)Úattribute_optionsÚactive_historyÚdeferredÚgroupr‹   ÚinfozCUnion[None, Type[_CC], Callable[..., _CC], _CompositeAttrType[Any]]z_CompositeAttrType[Any]úOptional[_AttributeOptions]ra   rH   zOptional[Type[Comparator[_CC]]]úOptional[_InfoType]r   )	Ú_class_or_attrr‰   rŒ   r�   rŽ   r�   r‹   r�   Úkwargsc          
        s    t ƒ j|d� t|tttjfƒr4|f| | _d | _n|| _|| _|| _	|| _
|| _|d ur^|n| jj| _d | _|d ur‚| j |¡ t | ¡ |  ¡  |  ¡  d S ©N)rŒ   )Úsuperrh   Ú
isinstancer   re   r#   r<   r‰   rˆ   r�   rŽ   r�   Ú	__class__Ú
Comparatorr‹   rŠ   r�   Úupdater   Úset_creation_orderÚ_create_descriptorÚ_init_accessor)
rQ   r“   rŒ   r�   rŽ   r�   r‹   r�   r‰   r”   ©r˜   rR   rS   rh   Ñ   s&    ÿý
zCompositeProperty.__init__r]   r^   r_   c                   s   t ƒ  |¡ |  ¡  d S rZ   )r–   r‚   Ú_setup_event_handlers©rQ   r`   rž   rR   rS   r‚   ù   s    z"CompositeProperty.instrument_classr…   zTuple[Any, ...]©rp   rM   c              
   C  sb   | j r|   |¡S z
|j}W n< tyV } z$t d| jj› d�¡|‚W Y d }~nd }~0 0 |ƒ S d S )NzComposite class zX is not a dataclass and does not define a __composite_values__() method; can't get state)rŠ   Ú__composite_values__ÚAttributeErrorÚsa_excÚInvalidRequestErrorrˆ   ri   )rQ   rp   ÚaccessorZaerR   rR   rS   Ú_composite_values_from_instanceý   s    

ÿüz1CompositeProperty._composite_values_from_instancerL   c                 C  s   |   ¡  dS )zwInitialization which occurs after the :class:`.Composite`
        has been associated with its parent mapper.

        N)Ú_setup_arguments_on_columnsrP   rR   rR   rS   Údo_init  s    zCompositeProperty.do_initc                   sT   dddœ‡fdd„‰ ddddœ‡ ‡fdd„}dddœ‡ ‡fd	d
„}t ˆ ||ƒˆ_dS )ztCreate the Python descriptor that will serve as
        the access point on instances of the mapped class.

        r   )ÚinstancerM   c                   s†   t  ˆ ¡}t  ˆ ¡}ˆj|vrx‡ fdd„ˆjD ƒ}ˆj|vrx|jd usPt |¡sxˆj|Ž |ˆj< |jj	 
|ˆjˆjg¡ | ˆjd ¡S )Nc                   s   g | ]}t ˆ |ƒ‘qS rR   )rw   ©Ú.0rg   ©rª   rR   rS   Ú
<listcomp>#  s   zFCompositeProperty._create_descriptor.<locals>.fget.<locals>.<listcomp>)r   Úinstance_dictÚinstance_staterg   Ú_attribute_keysr   Ú
issupersetrˆ   ÚmanagerÚdispatchÚrefreshÚ_COMPOSITE_FGETÚget)rª   rX   rW   ÚvaluesrP   r­   rS   rx     s     



ÿ	
ÿÿÿz2CompositeProperty._create_descriptor.<locals>.fgetr^   )rª   rp   rM   c                   s¸   t  | ¡}t  | ¡}|jˆj }|jjr2ˆ | ƒ}n| ˆjtj	¡}|jj
D ]}|||||jƒ}qJ||ˆj< |d u rŒˆjD ]}t| |d ƒ qxn(tˆjˆ |¡ƒD ]\}}t| ||ƒ qžd S rZ   )r   r¯   r°   r³   rg   r´   Ú_active_historyr·   r   ÚNO_VALUEÚsetr~   r±   rq   Úzipr§   )rª   rp   rX   rW   ÚattrÚpreviousÚfnrg   ©rx   rQ   rR   rS   rs   6  s"    




þz2CompositeProperty._create_descriptor.<locals>.fsetc                   sŠ   t  | ¡}t  | ¡}|jˆj }|jjr@ˆ | ƒ}| ˆjd ¡ n| ˆjtj	¡}|jˆj }|j 
|||j¡ ˆjD ]}t| |d ƒ qtd S rZ   )r   r°   r¯   r³   rg   r´   r¹   Úpopr   rº   Úremover~   r±   rq   )rª   rW   rX   r½   r¾   rg   rÀ   rR   rS   rv   M  s    


z2CompositeProperty._create_descriptor.<locals>.fdelN)rl   rJ   )rQ   rs   rv   rR   rÀ   rS   rœ     s    z$CompositeProperty._create_descriptorúsqlalchemy.orm.propertiesr1   r,   z	Type[Any]re   zOptional[Type[Mapped[Any]]]zOptional[_AnnotationScanType])
Ú	decl_scanÚregistryÚclsÚoriginating_modulerg   Úmapped_containerÚ
annotationÚextracted_mapped_annotationÚis_dataclass_fieldrM   c
                 C  s  t jjj}
| jd u r(|d u r(|  ||¡ |}t|ƒr@t|ƒd }|r²| jd u r²t|t	ƒsdt
|dd�r¬|d u rœt|dƒr||jnt	|ƒ}t d|› d|› d�¡‚t|||dd�}|| _t| jƒrÐ|  |||||¡ n0| jD ](}t||
tjfƒrÖ|jd u rÖt d	¡‚qÖ|  ¡  d S )
Nr   T)Zcheck_genericÚ__forward_arg__zCan't use forward ref z9 for composite class argument; set up the type as Mapped[ú])Zinclude_genericzIComposite class column arguments must be named unless a dataclass is used)r   Ú	preloadedÚorm_propertiesr5   rˆ   Z_raise_for_requiredr*   r(   r—   re   r)   ÚhasattrrÌ   r¤   ÚArgumentErrorr   r   Ú_setup_for_dataclassr‰   r"   r>   rr   r�   )rQ   rÄ   rÅ   rÆ   rÇ   rg   rÈ   rÉ   rÊ   rË   r5   ÚargumentZstr_argr½   rR   rR   rS   Údeclarative_scan_  sP    
ÿþÿÿýÿÿÿ

ÿ
ÿþÿz"CompositeProperty.declarative_scanc                   s¶   t | jƒr`t| jdƒs`t | j¡}tjdd„ |j ¡ D ƒŽ ‰ t	|jƒdkrZ‡ fdd„| _
nˆ | _
| jd ur²t| jtƒr²| jtvr²| j
d ur˜| j
t| j< nt| jdƒr²dd„ t| j< d S )Nr¢   c                 S  s   g | ]
}|j ‘qS rR   )rr   )r¬   ÚprR   rR   rS   r®   ¡  r{   z4CompositeProperty._init_accessor.<locals>.<listcomp>r   c                   s
   ˆ | ƒfS rZ   rR   ru   ©ÚgetterrR   rS   rz   ¤  r{   z2CompositeProperty._init_accessor.<locals>.<lambda>c                 S  s   |   ¡ S rZ   ©r¢   ru   rR   rR   rS   rz   ³  r{   )r   rˆ   rÐ   ÚinspectÚ	signatureÚoperatorÚ
attrgetterÚ
parametersr¸   ÚlenrŠ   r—   Útyper†   )rQ   ÚinsprR   rÖ   rS   r�   ›  s,    ÿÿÿ
þý
ÿ
ÿz CompositeProperty._init_accessorzsqlalchemy.orm.decl_base)rÄ   rÅ   rÆ   rÇ   rg   rM   c              
   C  sÒ   t jjj}t jj}t | j¡}t 	|j
 ¡ | j¡D ]š\}	}
|	d u rnt dt| jƒ› d| jj› dt|j
ƒ› �¡‚|
d u rŒ|ƒ }
|  j|
f7  _t|
|ƒr²|
 ||||||	j|	j¡ q2t|
tjƒr2| |	j|
¡ q2d S )Nznumber of composite attributes z3 exceeds that of the number of attributes in class ú )r   rÎ   rÏ   r5   Zorm_decl_baserÙ   rÚ   rˆ   Ú	itertoolsÚzip_longestrÝ   r¸   r‰   r¤   rÑ   rÞ   ri   r—   Zdeclarative_scan_for_compositerr   rÉ   r"   r>   Z_undefer_column_name)rQ   rÄ   rÅ   rÆ   rÇ   rg   r5   Ú	decl_baserà   Úparamr½   rR   rR   rS   rÒ   ¶  s>    

ÿÿýýÿ
ù	z&CompositeProperty._setup_for_dataclassrK   c                   s   ‡ fdd„ˆ j D ƒS )Nc                   s   g | ]}t ˆ jj|jƒ‘qS rR   )rw   r}   r|   rg   ©r¬   rd   rP   rR   rS   r®   ã  r{   z:CompositeProperty._comparable_elements.<locals>.<listcomp>©ÚpropsrP   rR   rP   rS   Ú_comparable_elementsá  s    z&CompositeProperty._comparable_elementszorm.propertieszSequence[MapperProperty[Any]]c                 C  sª   g }t jjj}| jD ]�}t|tƒr4| jj|dd�}nLt|t	j
ƒrN| jj| }n2t||ƒrh| jj|j }nt|tjƒr||j}nd }t|tƒsšt d|›�¡‚| |¡ q|S )NF)Z_configure_mapperszYComposite expects Column objects or mapped attributes/attribute names as arguments, got: )r   rÎ   rÏ   r5   r‰   r—   re   r}   Zget_propertyr"   r>   Ú_columntopropertyÚcolumnr   r.   rl   r   r¤   rÑ   Úappend)rQ   rè   r5   r½   rd   rR   rR   rS   rè   å  s(    




ÿÿzCompositeProperty.propsc                 C  s   | j S rZ   )ré   rP   rR   rR   rS   rT      s    z(CompositeProperty._column_strategy_attrszSequence[Column[Any]]c                   s   t jjj‰ ‡ fdd„| jD ƒS )Nc                   s0   g | ](}t |tjˆ fƒrt |ˆ ƒr(|jn|‘qS rR   )r—   r"   r>   rë   )r¬   Úar4   rR   rS   r®     s   þz-CompositeProperty.columns.<locals>.<listcomp>)r   rÎ   rÏ   r5   r‰   rP   rR   r4   rS   Úcolumns  s    

þzCompositeProperty.columnszOptional[MapperProperty[_CC]]c                 C  s   | S rZ   rR   rP   rR   rR   rS   Úmapper_property_to_assign  s    z+CompositeProperty.mapper_property_to_assignz$List[Tuple[schema.Column[Any], int]]c                 C  s   dd„ | j D ƒS )Nc                 S  s   g | ]}|j d u r|df‘qS )Nr   )Útable)r¬   ÚcrR   rR   rS   r®     r{   z7CompositeProperty.columns_to_assign.<locals>.<listcomp>)rî   rP   rR   rR   rS   Úcolumns_to_assign  s    z#CompositeProperty.columns_to_assignc                 C  sP   t jjj}| jD ]:}t||ƒs"qn|}| j|_| jrB| j|_d|_| j	|_	qdS )zwPropagate configuration arguments made on this composite
        to the target columns, for those that apply.

        ))rŽ   T)Z
instrumentTN)
r   rÎ   rÏ   r3   rè   r—   r�   rŽ   Zstrategy_keyr�   )rQ   r3   rd   ZcproprR   rR   rS   r¨     s    


z-CompositeProperty._setup_arguments_on_columnsc                   s
  ddddœ‡ fdd„}dddddœ‡ ‡fd	d
„}ddddddœ‡fdd„‰ ddddœ‡fdd„}dddddœ‡fdd„}t jˆjd|dd� t jˆjd|dd� t jˆjd|ddd� t jˆjd|ddd� t jˆjd|ddd� ˆjjˆj }|j|j_ˆj|jj_dS ) z>Establish events that populate/expire the composite attribute.rU   r0   r^   )rW   ÚcontextrM   c                   s   ˆ | |d dd� d S )NF©Ú
is_refreshrR   )rW   ró   )Ú_load_refresh_handlerrR   rS   Úload_handler,  s    z=CompositeProperty._setup_event_handlers.<locals>.load_handlerzOptional[Sequence[str]])rW   ró   Úto_loadrM   c                   s.   |rˆj h ˆj¡ |¡r*ˆ | ||dd� d S )NTrô   )rg   Úunionr±   Úintersection)rW   ró   rø   ©rö   rQ   rR   rS   Úrefresh_handler1  s    ÿþz@CompositeProperty._setup_event_handlers.<locals>.refresh_handlerra   )rW   ró   rø   rõ   rM   c                   s`   ˆ j }|r|ˆju r"ˆj|v r"d S ˆjD ]}||vr( d S q(ˆj‡ fdd„ˆjD ƒŽ |ˆj< d S )Nc                   s   g | ]}ˆ j | ‘qS rR   )Údictr«   ©rW   rR   rS   r®   [  r{   zZCompositeProperty._setup_event_handlers.<locals>._load_refresh_handler.<locals>.<listcomp>)rý   r¶   rg   r±   rˆ   )rW   ró   rø   rõ   rX   ÚkrP   rþ   rS   rö   =  s    ÿÿþ
ÿzFCompositeProperty._setup_event_handlers.<locals>._load_refresh_handler)rW   ÚkeysrM   c                   s,   |d u st ˆ jƒ |¡r(| j ˆ jd ¡ d S rZ   )r»   r±   rú   rý   rÁ   rg   )rW   r   rP   rR   rS   Úexpire_handler^  s    z?CompositeProperty._setup_event_handlers.<locals>.expire_handlerr]   r7   )r`   Ú
connectionrW   rM   c                   s   |j  ˆ jd¡ dS )zêAfter an insert or update, some columns may be expired due
            to server side defaults, or re-populated due to client side
            defaults.  Pop out the composite value here so that it
            recreates.

            N)rý   rÁ   rg   )r`   r  rW   rP   rR   rS   Úinsert_update_handlerd  s    zFCompositeProperty._setup_event_handlers.<locals>.insert_update_handlerZafter_insertT)ÚrawZafter_updateÚload)r  Ú	propagaterµ   ZexpireN)	r    Úlistenr}   r   rg   r´   r~   r�   r¹   )rQ   r÷   rü   r  r  r�   rR   rû   rS   rŸ   )  s.    !
ÿ
ÿÿÿÿ
z'CompositeProperty._setup_event_handlersúSequence[str]c                 C  s   dd„ | j D ƒS )Nc                 S  s   g | ]
}|j ‘qS rR   rf   ræ   rR   rR   rS   r®   Š  r{   z5CompositeProperty._attribute_keys.<locals>.<listcomp>rç   rP   rR   rR   rS   r±   ˆ  s    z!CompositeProperty._attribute_keysz Callable[[Dict[str, Any]], None]c                   sJ   ˆj rˆj ‰ndddœdd„‰dd„ ˆjD ƒ‰ dd	d
œ‡ ‡‡fdd„}|S )Nr   z
Tuple[Any])ÚvalrM   c                 S  s   |   ¡ S rZ   rØ   )r	  rR   rR   rS   Ú
get_values“  s    zOCompositeProperty._populate_composite_bulk_save_mappings_fn.<locals>.get_valuesc                 S  s   g | ]
}|j ‘qS rR   rf   ræ   rR   rR   rS   r®   –  r{   zOCompositeProperty._populate_composite_bulk_save_mappings_fn.<locals>.<listcomp>zDict[str, Any]r^   )Ú	dest_dictrM   c              	     s*   |   dd„ tˆ ˆ|  ˆj¡ƒƒD ƒ¡ d S )Nc                 S  s   i | ]\}}||“qS rR   rR   )r¬   rg   r	  rR   rR   rS   Ú
<dictcomp>š  s   ÿzaCompositeProperty._populate_composite_bulk_save_mappings_fn.<locals>.populate.<locals>.<dictcomp>)rš   r¼   rÁ   rg   )r  ©r‰   r
  rQ   rR   rS   Úpopulate˜  s    ÿþÿzMCompositeProperty._populate_composite_bulk_save_mappings_fn.<locals>.populate)rŠ   rè   )rQ   r  rR   r  rS   Ú)_populate_composite_bulk_save_mappings_fnŒ  s    
z;CompositeProperty._populate_composite_bulk_save_mappings_fnrU   r+   r   r-   rV   c                 C  sº   g }g }d}| j D ]j}|j}|j| j ||¡}	|	 ¡ r<d}|	 ¡ }
|
rT| |
¡ n
| d¡ |	j	rr| |	j	¡ q| d¡ q|r t
 | j|Ž gd| j|Ž g¡S t
 d| j|Ž gd¡S dS )z>Provided for userland code that uses attributes.get_history().FTNrR   )rè   rg   r³   r~   r\   Zhas_changesÚnon_deletedÚextendrì   Údeletedr   r-   rˆ   )rQ   rW   rX   rY   Úaddedr  Zhas_historyrd   rg   Úhistr  rR   rR   rS   r\   ¤  s,    



ýzCompositeProperty.get_historyzComposite.Comparator[_CC]c                 C  s   |   | |¡S rZ   )r‹   r    rR   rR   rS   ry   É  s    z%CompositeProperty._comparator_factoryc                      s8   e Zd Zdddœ‡ fdd„Zdddd	d
œdd„Z‡  ZS )z!CompositeProperty.CompositeBundlezComposite[_T]r;   )Ú	property_Úexprc                   s    || _ tƒ j|jg|¢R Ž  d S rZ   )rl   r–   rh   rg   )rQ   r  r  rž   rR   rS   rh   Ï  s    z*CompositeProperty.CompositeBundle.__init__zSelect[Any]z#Sequence[Callable[[Row[Any]], Any]]r  zCallable[[Row[Any]], Any])ÚqueryÚprocsÚlabelsrM   c                   s   dddœ‡ ‡fdd„}|S )NzRow[Any]r   )ÚrowrM   c                   s   ˆj j‡ fdd„ˆD ƒŽ S )Nc                   s   g | ]}|ˆ ƒ‘qS rR   rR   )r¬   Úproc©r  rR   rS   r®   ß  r{   zXCompositeProperty.CompositeBundle.create_row_processor.<locals>.proc.<locals>.<listcomp>)rl   rˆ   r  ©r  rQ   r  rS   r  Ý  s    ÿzDCompositeProperty.CompositeBundle.create_row_processor.<locals>.procrR   )rQ   r  r  r  r  rR   r  rS   Úcreate_row_processor×  s    z6CompositeProperty.CompositeBundle.create_row_processor)ri   rj   rk   rh   r  Ú__classcell__rR   rR   rž   rS   ÚCompositeBundleÎ  s   r   c                   @  sê   e Zd ZU dZdZded< ejddœdd„ƒZd	dœd
d„Z	ejd	dœdd„ƒZ
dddœdd„Zejddœdd„ƒZdddœdd„Zdddœdd„Zdddœdd„Zdddœdd„Zdddœd d!„Zdddœd"d#„Zd$ddd%œd&d'„ZdS )(zCompositeProperty.Comparatora·  Produce boolean, comparison, and other operators for
        :class:`.Composite` attributes.

        See the example in :ref:`composite_operations` for an overview
        of usage , as well as the documentation for :class:`.PropComparator`.

        .. seealso::

            :class:`.PropComparator`

            :class:`.ColumnOperators`

            :ref:`types_operators`

            :attr:`.TypeEngine.comparator_factory`

        Nz%RODescriptorReference[Composite[_PT]]rd   r;   rL   c                 C  s   t j| jddiŽS )Nr�   F)r%   r;   ré   rP   rR   rR   rS   Úclausesü  s
    ÿÿz$CompositeProperty.Comparator.clausesz&CompositeProperty.CompositeBundle[_PT]c                 C  s   | j S rZ   r$   rP   rR   rR   rS   Ú__clause_element__  s    z/CompositeProperty.Comparator.__clause_element__c                 C  s*   | j  | j| j| jjdœ¡}t | j|¡S )N)ZparententityZparentmapperÚ	proxy_key)r!  Z	_annotateZ_parententityrd   rg   r‡   r   )rQ   r!  rR   rR   rS   r%     s    ýÿz'CompositeProperty.Comparator.expressionr   z(Sequence[Tuple[_DMLColumnArgument, Any]]r¡   c                 C  sz   t |tƒr|j}|d u r,dd„ | jjD ƒ}n>t | jjtƒrVt || jjƒrV| j |¡}nt 	d| j|f ¡‚t
t| j|ƒƒS )Nc                 S  s   g | ]}d ‘qS rZ   rR   r«   rR   rR   rS   r®     r{   zDCompositeProperty.Comparator._bulk_update_tuples.<locals>.<listcomp>z)Can't UPDATE composite attribute %s to %r)r—   r'   rp   rd   r±   rˆ   rß   r§   r¤   rÑ   Úlistr¼   ré   )rQ   rp   r¸   rR   rR   rS   Ú_bulk_update_tuples  s     
ÿÿÿÿz0CompositeProperty.Comparator._bulk_update_tuplesrK   c                   s(   ˆ j r‡ fdd„ˆ jjD ƒS ˆ jjS d S )Nc                   s   g | ]}t ˆ jj|jƒ‘qS rR   )rw   Ú_adapt_to_entityÚentityrg   ræ   rP   rR   rS   r®   +  s   ÿzECompositeProperty.Comparator._comparable_elements.<locals>.<listcomp>)r&  rd   ré   rP   rR   rP   rS   ré   (  s
    
þz1CompositeProperty.Comparator._comparable_elementszColumnElement[bool])ÚotherrM   c                 C  s   |   tj|¡S rZ   )Ú_comparer&   Úeq©rQ   r(  rR   rR   rS   Ú__eq__2  s    z#CompositeProperty.Comparator.__eq__c                 C  s   |   tj|¡S rZ   )r)  r&   Úner+  rR   rR   rS   Ú__ne__5  s    z#CompositeProperty.Comparator.__ne__c                 C  s   |   tj|¡S rZ   )r)  r&   Últr+  rR   rR   rS   Ú__lt__8  s    z#CompositeProperty.Comparator.__lt__c                 C  s   |   tj|¡S rZ   )r)  r&   Úgtr+  rR   rR   rS   Ú__gt__;  s    z#CompositeProperty.Comparator.__gt__c                 C  s   |   tj|¡S rZ   )r)  r&   Úler+  rR   rR   rS   Ú__le__>  s    z#CompositeProperty.Comparator.__le__c                 C  s   |   tj|¡S rZ   )r)  r&   Úger+  rR   rR   rS   Ú__ge__A  s    z#CompositeProperty.Comparator.__ge__r=   )rÛ   r(  rM   c                   st   |d u rd gt ˆjjƒ }nˆj |¡}‡ fdd„tˆjj|ƒD ƒ}ˆjrjˆjd usXJ ‚‡fdd„|D ƒ}tj|Ž S )Nc                   s   g | ]\}}ˆ ||ƒ‘qS rR   rR   )r¬   rí   Úb)rÛ   rR   rS   r®   S  s   ÿz9CompositeProperty.Comparator._compare.<locals>.<listcomp>c                   s   g | ]}ˆ   |¡‘qS rR   )Úadapter)r¬   ÚxrP   rR   rS   r®   Y  r{   )	rÞ   rd   ré   r§   r¼   r&  r8  r#   Úand_)rQ   rÛ   r(  r¸   ZcomparisonsrR   )rÛ   rQ   rS   r)  K  s    
þz%CompositeProperty.Comparator._compare)ri   rj   rk   rƒ   Ú__hash__r„   r   Úmemoized_propertyr!  r"  r%   r%  ré   r,  r.  r0  r2  r4  r6  r)  rR   rR   rR   rS   r™   ä  s$   

	
r™   c                 C  s   t | jjjƒd | j S )NÚ.)re   r}   r|   ri   rg   rP   rR   rR   rS   Ú__str__\  s    zCompositeProperty.__str__)N)+ri   rj   rk   rƒ   r„   rh   r‚   r§   r©   Úobjectr¶   rœ   r   Úpreload_modulerÔ   r�   rÒ   r<  ré   rè   rT   Znon_memoized_propertyrî   rl   rï   rò   r¨   rŸ   r±   r  r   rm   r\   ry   Úorm_utilZBundlerD   r   r   rF   r™   r>  r  rR   rR   rž   rS   r‡   ¹   sd   
 üõ&(J";)_ü%xr‡   c                   @  s   e Zd ZdZdZdS )Ú	CompositeaS  Declarative-compatible front-end for the :class:`.CompositeProperty`
    class.

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

    .. versionchanged:: 2.0 Added :class:`_orm.Composite` as a Declarative
       compatible subclass of :class:`_orm.CompositeProperty`.

    .. seealso::

        :ref:`mapper_composite`

    TN©ri   rj   rk   rƒ   Zinherit_cacherR   rR   rR   rS   rB  `  s   rB  c                      s6   e Zd ZdZdddœdd„Zddœ‡ fd	d
„Z‡  ZS )ÚConcreteInheritedPropertya4  A 'do nothing' :class:`.MapperProperty` that disables
    an attribute on a concrete subclass that is only present
    on the inherited mapper, not the concrete classes' mapper.

    Cases where this occurs include:

    * When the superclass mapper is mapped against a
      "polymorphic union", which includes all attributes from
      all subclasses.
    * When a relationship() is configured on an inherited mapper,
      but not on the subclass mapper.  Concrete mappers require
      that relationship() is configured explicitly on each
      subclass.

    r]   zType[PropComparator[_T]]r_   c                 C  sP   d }| j  ¡ D ]*}|j| j }t|dd ƒd ur|j} q:q|d usFJ ‚|||ƒS )Nr‹   )r}   Ziterate_to_rootZ_propsrg   rw   r‹   )rQ   r`   Zcomparator_callableÚmrÕ   rR   rR   rS   ry   „  s    z-ConcreteInheritedProperty._comparator_factoryr^   rL   c                   s<   t ƒ  ¡  ddœ‡ fdd„‰G ‡ ‡fdd„dƒ}|ƒ ˆ _d S )Nr   rL   c                     s   t dˆ jˆ jˆ jf ƒ‚d S )NzgConcrete %s does not implement attribute %r at the instance level.  Add this property explicitly to %s.)r£   r}   rg   rR   rP   rR   rS   Úwarn”  s
    ýÿz0ConcreteInheritedProperty.__init__.<locals>.warnc                      sT   e Zd Zdddddœ‡fdd„Zddddœ‡fdd„Zddddd	œ‡ ‡fd
d„ZdS )zDConcreteInheritedProperty.__init__.<locals>.NoninheritedConcretePropr   r   )Úsro   rp   rM   c                   s
   ˆ ƒ  d S rZ   rR   )rG  ro   rp   ©rF  rR   rS   Ú__set__�  s    zLConcreteInheritedProperty.__init__.<locals>.NoninheritedConcreteProp.__set__)rG  ro   rM   c                   s
   ˆ ƒ  d S rZ   rR   )rG  ro   rH  rR   rS   Ú
__delete__   s    zOConcreteInheritedProperty.__init__.<locals>.NoninheritedConcreteProp.__delete__)rG  ro   ÚownerrM   c                   s   |d u rˆ j S ˆƒ  d S rZ   )rJ   )rG  ro   rK  ©rQ   rF  rR   rS   Ú__get__£  s    zLConcreteInheritedProperty.__init__.<locals>.NoninheritedConcreteProp.__get__N)ri   rj   rk   rI  rJ  rM  rR   rL  rR   rS   ÚNoninheritedConcretePropœ  s   rN  )r–   rh   rJ   )rQ   rN  rž   rL  rS   rh   ‘  s    
z"ConcreteInheritedProperty.__init__)ri   rj   rk   rƒ   ry   rh   r  rR   rR   rž   rS   rD  s  s   rD  c                	      s¼   e Zd ZU dZded< d)dddddd	d
dœ‡ fdd„ZesLeddœdd„ƒZe	j
ddœdd„ƒZddœdd„Zdddœdd„Zejfdddd d!œd"d#„Ze	 d$¡ddd%d&œd'd(„ƒZ‡  ZS )*ÚSynonymPropertya8  Denote an attribute name as a synonym to a mapped property,
    in that the attribute will mirror the value and expression behavior
    of another attribute.

    :class:`.Synonym` is constructed using the :func:`_orm.synonym`
    function.

    .. seealso::

        :ref:`synonyms` - Overview of synonyms

    z"Optional[Type[PropComparator[_T]]]r‹   Nre   zOptional[bool]zOptional[Any]r‘   r’   rH   )rr   Ú
map_columnrJ   r‹   rŒ   r�   rI   c                   sj   t ƒ j|d� || _|| _|| _|| _|r2|| _n|rF|jrF|j| _nd | _|r\| j 	|¡ t
 | ¡ d S r•   )r–   rh   rr   rP  rJ   r‹   rI   rƒ   r�   rš   r   r›   )rQ   rr   rP  rJ   r‹   rŒ   r�   rI   rž   rR   rS   rh   »  s    


zSynonymProperty.__init__ra   rL   c                 C  s   t | jj| jƒjjS rZ   )rw   r}   r|   rr   r~   rb   rP   rR   rR   rS   rb   Ø  s    zSynonymProperty.uses_objectsz/Union[MapperProperty[_T], SQLORMOperations[_T]]c                 C  sh   t | jj| jƒ}t|dƒr&t|jtƒsbt|tj	ƒr8|j
S t|tƒrF|S t d| jjj| j|f ¡‚|jS )Nrl   zGsynonym() attribute "%s.%s" only supports ORM mapped attributes, got %r)rw   r}   r|   rr   rÐ   r—   rl   r   r   r/   Z
comparatorr   r¤   r¥   ri   )rQ   r½   rR   rR   rS   Ú_proxied_objectß  s    ÿ
þÿzSynonymProperty._proxied_objectrK   c                 C  s   t | jj| jƒfS rZ   )rw   r}   r|   rr   rP   rR   rR   rS   rT   ö  s    z&SynonymProperty._column_strategy_attrsr]   zSQLORMOperations[_T]r_   c                 C  s<   | j }t|tƒr4| jr$|  ||¡}n| ||¡}|S |S d S rZ   )rQ  r—   r   r‹   )rQ   r`   rd   ÚcomprR   rR   rS   ry   ù  s    
z#SynonymProperty._comparator_factoryrU   r+   r   r-   rV   c                 C  s"   t | jj| jƒ}|jj|||d�S )N)rY   )rw   r}   r|   rr   r~   r\   )rQ   rW   rX   rY   r½   rR   rR   rS   r\     s    zSynonymProperty.get_historyrÃ   r^   )r}   ÚinitrM   c                 C  sÂ   t jj}| jr¸| j|jjvr:t d| j	|jj
| jf ¡‚nN|jj| j |jv rˆ|j|jj| j  j| j	krˆt d| j| j	| j	| jf ¡‚| |jj| j ¡}|j| j	||dd� | j|_|| _d S )Nz>Can't compile synonym '%s': no column on table '%s' named '%s'zpCan't call map_column=True for synonym %r=%r, a ColumnProperty already exists keyed to the name %r for column %rT)rS  Z	setparent)r   rÎ   rÏ   rP  rg   Zpersist_selectablerñ   r¤   rÑ   rr   Údescriptionrê   r3   Z_configure_propertyZ_mapped_by_synonymr}   )rQ   r}   rS  Ú
propertiesrÕ   rR   rR   rS   Ú
set_parent  s@    ýþÿ
ÿÿÿýýýÿÿzSynonymProperty.set_parent)NNNNNN)ri   rj   rk   rƒ   r„   rh   r   rl   rb   r   r<  rQ  rT   ry   r   rm   r\   r@  rV  r  rR   rR   rž   rS   rO  «  s(   
      ø ü	rO  c                   @  s   e Zd ZdZdZdS )ÚSynonymaK  Declarative front-end for the :class:`.SynonymProperty` class.

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

    .. versionchanged:: 2.0 Added :class:`_orm.Synonym` as a Declarative
       compatible subclass for :class:`_orm.SynonymProperty`

    .. seealso::

        :ref:`synonyms` - Overview of synonyms

    TNrC  rR   rR   rR   rS   rW  5  s   rW  )grƒ   Ú
__future__r   Zdataclassesr   rÙ   râ   rÛ   Útypingr   r   r   r   r   r	   r
   r   r   r   r   r   ÚweakrefÚ r   r   rA  Úbaser   r   r   r   r   Z
interfacesr   r   r   r   r   r   r   r    r!   r¤   r"   r#   r%   r&   Zsql.elementsr'   Zutil.typingr(   r)   r*   Ú_typingr+   r,   r-   r.   r/   ró   r0   rä   r1   r`   r2   rU  r3   r5   rW   r6   Zengine.baser7   Z
engine.rowr8   Zsql._typingr9   r:   r;   r<   Zsql.operatorsr=   Z
sql.schemar>   Zsql.selectabler?   r@   rA   rB   rC   rD   rF   rG   re   Z_CompositeAttrTyper…   ÚWeakKeyDictionaryr†   r„   r‡   rB  rD  rO  rW  rR   rR   rR   rS   Ú<module>   sÀ   Müÿ	þ

ÿ     ,8 