U
|
¸ý°d¨ ã @ s8 d Z ddlmZ ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd lm
|
Z
|
dd
|
lm Z dd lm Z dd lm Z dd lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd lm 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 d0l3m6Z6 d d1l3m7Z7 d d2l3m8Z8 ej9rd d3l*m:Z: d d4l*m;Z; d d5l<m=Z= d d6l>m?Z? d d7l>m@Z@ ed8ed9ZAed:ed;d<ZBed=ed;d>ZCed?ed9ZDed@ed9ZEedAed9ZFddddddBe2jGe2jGe2jGe2jGe2jGe2jGdC dDdDdEdFdGdHdIdJdKdKdLdMdKdKdNdOdPdQZHG dRdS dSe%ZIG dTdU dUe5eB ZJG dVdW dWe5ZKG dXdY dYeKe5eC ZLG dZd[ d[eKe5eC ZMG d\d] d]e5ZNG d^d_ d_eNe5eC ZOG d`da daeNe5eC ZPG dbdc dce5eA ZQG ddde dee5ZRG dfdg dge5ZSG dhdi die5ZTG djdk dke5eA ZUG dldm dme&jVe'eA e,eUeA ZWedndod9ZXG dpdq dqe)eA ZYG drds dseYeA ZZG dtdu dueYeA Z[G dvdw dweYeA Z\G dxdy dyeQeA Z]edzd{d9Z^G d|d} d}e e^ Z_G d~d de_eA Z`G dd de`eA eeA ZaG dd de_eF eeEeFf ZbG dd
d
e`eA eeA ZcdS )zõContain the ``AssociationProxy`` class.
|
|
The ``AssociationProxy`` is a Python property object which provides
|
transparent proxied access to the endpoint of an association object.
|
|
See the example ``examples/association/proxied_association.py``.
|
|
é )Ú annotationsN)Ú AbstractSet)ÚAny)ÚCallable)Úcast)Ú
|
Collection)ÚDict)ÚGeneric©Ú ItemsView)ÚIterable)ÚIterator)ÚKeysView)ÚList)ÚMapping)ÚMutableMapping)ÚMutableSequence)Ú
|
MutableSet)ÚNoReturn)ÚOptional)Úoverload)ÚSet)ÚTuple)ÚType)ÚTypeVar)ÚUnion©Ú
|
ValuesViewé )Ú ColumnElement)Úexc)Úinspect)Úorm)Úutil)Ú collections)ÚInspectionAttrExtensionType)Ú
|
interfaces)Ú ORMDescriptor)ÚSQLORMOperations)Ú_AttributeOptions)Ú_DCAttributeOptions)Ú_DEFAULT_ATTRIBUTE_OPTIONS)Ú operators)Úor_)Ú_NoArg)ÚLiteral)ÚProtocol)ÚSelf)Ú SupportsIndex)ÚSupportsKeysAndGetItem)ÚMapperProperty)ÚPropComparator)ÚMapper)Ú_ColumnExpressionArgument)Ú _InfoTypeÚ_T)ÚboundÚ_T_coT)r: Ú covariantÚ_T_con)r: Ú contravariantÚ_SÚ_KTÚ_VTF) ÚcreatorÚgetset_factoryÚ proxy_factoryÚproxy_bulk_setÚinfoÚcascade_scalar_deletesÚinitÚreprÚdefaultÚdefault_factoryÚcompareÚkw_onlyÚstrúOptional[_CreatorProtocol]ú Optional[_GetSetFactoryProtocol]ú Optional[_ProxyFactoryProtocol]ú Optional[_ProxyBulkSetProtocol]úOptional[_InfoType]ÚboolzUnion[_NoArg, bool]ú Optional[Any]z Union[_NoArg, Callable[[], _T]]zAssociationProxy[Any])Útarget_collectionÚattrrB rC rD rE rF rG rH rI rJ rK rL rM Úreturnc C s( t | |||||||t|| |
|
| | | d S )a¾ Return a Python property implementing a view of a target
|
attribute which references an attribute on members of the
|
target.
|
|
The returned value is an instance of :class:`.AssociationProxy`.
|
|
Implements a Python property representing a relationship as a collection
|
of simpler values, or a scalar value. The proxied property will mimic
|
the collection type of the target (list, dict or set), or, in the case of
|
a one to one relationship, a simple scalar value.
|
|
:param target_collection: Name of the attribute that is the immediate
|
target. This attribute is typically mapped by
|
:func:`~sqlalchemy.orm.relationship` to link to a target collection, but
|
can also be a many-to-one or non-scalar relationship.
|
|
:param attr: Attribute on the associated instance or instances that
|
are available on instances of the target object.
|
|
:param creator: optional.
|
|
Defines custom behavior when new items are added to the proxied
|
collection.
|
|
By default, adding new items to the collection will trigger a
|
construction of an instance of the target object, passing the given
|
item as a positional argument to the target constructor. For cases
|
where this isn't sufficient, :paramref:`.association_proxy.creator`
|
can supply a callable that will construct the object in the
|
appropriate way, given the item that was passed.
|
|
For list- and set- oriented collections, a single argument is
|
passed to the callable. For dictionary oriented collections, two
|
arguments are passed, corresponding to the key and value.
|
|
The :paramref:`.association_proxy.creator` callable is also invoked
|
for scalar (i.e. many-to-one, one-to-one) relationships. If the
|
current value of the target relationship attribute is ``None``, the
|
callable is used to construct a new object. If an object value already
|
exists, the given attribute value is populated onto that object.
|
|
.. seealso::
|
|
:ref:`associationproxy_creator`
|
|
:param cascade_scalar_deletes: when True, indicates that setting
|
the proxied value to ``None``, or deleting it via ``del``, should
|
also remove the source object. Only applies to scalar attributes.
|
Normally, removing the proxied target will not remove the proxy
|
source, as this object may have other state that is still to be
|
kept.
|
|
.. versionadded:: 1.3
|
|
.. seealso::
|
|
:ref:`cascade_scalar_deletes` - complete usage example
|
|
:param init: Specific to :ref:`orm_declarative_native_dataclasses`,
|
specifies if the mapped attribute should be part of the ``__init__()``
|
method as generated by the dataclass process.
|
|
.. versionadded:: 2.0.0b4
|
|
:param repr: Specific to :ref:`orm_declarative_native_dataclasses`,
|
specifies if the attribute established by this :class:`.AssociationProxy`
|
should be part of the ``__repr__()`` method as generated by the dataclass
|
process.
|
|
.. versionadded:: 2.0.0b4
|
|
:param default_factory: Specific to
|
:ref:`orm_declarative_native_dataclasses`, specifies a default-value
|
generation function that will take place as part of the ``__init__()``
|
method as generated by the dataclass process.
|
|
.. versionadded:: 2.0.0b4
|
|
:param compare: Specific to
|
:ref:`orm_declarative_native_dataclasses`, indicates if this field
|
should be included in comparison operations when generating the
|
``__eq__()`` and ``__ne__()`` methods for the mapped class.
|
|
.. versionadded:: 2.0.0b4
|
|
:param kw_only: Specific to :ref:`orm_declarative_native_dataclasses`,
|
indicates if this field should be marked as keyword-only when generating
|
the ``__init__()`` method as generated by the dataclass process.
|
|
.. versionadded:: 2.0.0b4
|
|
:param info: optional, will be assigned to
|
:attr:`.AssociationProxy.info` if present.
|
|
|
The following additional parameters involve injection of custom behaviors
|
within the :class:`.AssociationProxy` object and are for advanced use
|
only:
|
|
:param getset_factory: Optional. Proxied attribute access is
|
automatically handled by routines that get and set values based on
|
the `attr` argument for this proxy.
|
|
If you would like to customize this behavior, you may supply a
|
`getset_factory` callable that produces a tuple of `getter` and
|
`setter` functions. The factory is called with two arguments, the
|
abstract type of the underlying collection and this proxy instance.
|
|
:param proxy_factory: Optional. The type of collection to emulate is
|
determined by sniffing the target collection. If your collection
|
type can't be determined by duck typing or you'd like to use a
|
different collection implementation, you may supply a factory
|
function to produce those collections. Only applicable to
|
non-scalar relationships.
|
|
:param proxy_bulk_set: Optional, use with proxy_factory.
|
|
|
©rB rC rD rE rF rG Úattribute_options)ÚAssociationProxyr) )rV rW rB rC rD rE rF rG rH rI rJ rK rL rM © r\ úVd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\sqlalchemy/ext/associationproxy.pyÚassociation_proxyT s& ÿ÷r^ c @ s e Zd ZdZdS )Ú AssociationProxyExtensionTypeÚASSOCIATION_PROXYN)Ú__name__Ú
|
__module__Ú __qualname__r` r\ r\ r\ r] r_ ë s r_ c @ s e Zd ZdddddZdS )Ú_GetterProtocolr r; ©ÚinstancerX c C s d S ©Nr\ )Úselfrf r\ r\ r] Ú__call__÷ s z_GetterProtocol.__call__N©ra rb rc ri r\ r\ r\ r] rd ö s rd c @ s e Zd ZdS )Ú_SetterProtocolN©ra rb rc r\ r\ r\ r] rk ü s rk c @ s e Zd ZddddddZdS )Ú_PlainSetterProtocolr r= ÚNone)rf ÚvaluerX c C s d S rg r\ )rh rf ro r\ r\ r] ri s z _PlainSetterProtocol.__call__Nrj r\ r\ r\ r] rm s rm c @ s e Zd ZdddddddZdS )Ú_DictSetterProtocolr r= rn )rf Úkeyro rX c C s d S rg r\ )rh rf rq ro r\ r\ r] ri s z _DictSetterProtocol.__call__Nrj r\ r\ r\ r] rp s rp c @ s e Zd ZdS )Ú_CreatorProtocolNrl r\ r\ r\ r] rr s rr c @ s e Zd ZdddddZdS )Ú_PlainCreatorProtocolr= r ©ro rX c C s d S rg r\ ©rh ro r\ r\ r] ri s z _PlainCreatorProtocol.__call__Nrj r\ r\ r\ r] rs s rs c @ s e Zd ZddddddZdS )Ú_KeyCreatorProtocolr zOptional[_T_con]©rq ro rX c C s d S rg r\ ©rh rq ro r\ r\ r] ri s z _KeyCreatorProtocol.__call__Nrj r\ r\ r\ r] rv s rv c @ s e Zd ZddddZdS )Ú_LazyCollectionProtocolúCUnion[MutableSet[_T], MutableMapping[Any, _T], MutableSequence[_T]]©rX c C s d S rg r\ ©rh r\ r\ r] ri s z _LazyCollectionProtocol.__call__Nrj r\ r\ r\ r] ry s ry c @ s e Zd ZddddddZdS )Ú_GetSetFactoryProtocolúOptional[Type[Any]]ú AssociationProxyInstance[Any]ú,Tuple[_GetterProtocol[Any], _SetterProtocol])Úcollection_classÚassoc_instancerX c C s d S rg r\ )rh r r r\ r\ r] ri ! s z _GetSetFactoryProtocol.__call__Nrj r\ r\ r\ r] r} s r} c @ s" e Zd ZddddddddZd S )
|
Ú_ProxyFactoryProtocolz _LazyCollectionProtocol[Any]rr rN r r )Úlazy_collectionrB Ú
|
value_attrÚparentrX c C s d S rg r\ )rh r rB r
r r\ r\ r] ri * s z _ProxyFactoryProtocol.__call__Nrj r\ r\ r\ r] r ) s r c @ s e Zd ZddddddZdS )Ú_ProxyBulkSetProtocolú_AssociationCollection[Any]ú Iterable[Any]rn )ÚproxyÚ
|
collectionrX c C s d S rg r\ )rh r r r\ r\ r] ri 5 s z _ProxyBulkSetProtocol.__call__Nrj r\ r\ r\ r] r 4 s r c @ s e Zd ZU dZded< ded< ded< ded< ded < d
|
ed < d ed < ejddddZd ddddddZdddd d Z dS ) Ú_AssociationProxyProtocolzpdescribes the interface of :class:`.AssociationProxy`
|
without including descriptor methods in the interface.rO rB rN rq rV r
rP rC rQ rD rR rE r8 r{ c C s d S rg r\ r| r\ r\ r] rF G s z _AssociationProxyProtocol.infoNú Type[Any]úOptional[object]ú AssociationProxyInstance[_T]©Úclass_ÚobjrX c C s d S rg r\ ©rh r r r\ r\ r] Ú for_classK s z#_AssociationProxyProtocol.for_classr r ©r rX c C s d S rg r\ )rh r r\ r\ r] Ú_default_getsetP s z)_AssociationProxyProtocol._default_getset)N)
|
ra rb rc Ú__doc__Ú__annotations__r# Zro_memoized_propertyrF r r r\ r\ r\ r] r ; s
|
ÿr c @ s e Zd ZdZdZejZddddddddddddd d
|
d d d d ddZe ddddddZ
|
e ddddddZ
|
e ddddddZ
|
ddd dd dZ
|
ddd d d d!Z dd d"d#d$Z d6d%d&dd'd(d)Z dddd'd*d+Zddd,d-d.Zdd/d0d1d2Zdd3d4d5ZdS )7r[ zDA descriptor that presents a read/write view of an object attribute.TNFrY rN rO rP rQ rR rS rT zOptional[_AttributeOptions]) rV rW rB rC rD rE rF rG rZ c
|
C sx || _ || _|| _|| _|| _|| _|| _dt| j|t | f | _
|
|rN|| _ | rh| t krhd| _ | | _n d| _ t | _dS )a( Construct a new :class:`.AssociationProxy`.
|
|
The :class:`.AssociationProxy` object is typically constructed using
|
the :func:`.association_proxy` constructor function. See the
|
description of :func:`.association_proxy` for a description of all
|
parameters.
|
|
|
z _%s_%s_%sTFN)rV r
rB rC rD rE rG Útypera Úidrq rF r+ Z_has_dataclass_argumentsZ_attribute_options)
|
rh rV rW rB rC rD rE rF rG rZ r\ r\ r] Ú__init__a s, ýÿþzAssociationProxy.__init__r ú Literal[None]r1 )rf ÚownerrX c C s d S rg r\ ©rh rf r r\ r\ r] Ú__get__ s zAssociationProxy.__get__r c C s d S rg r\ r r\ r\ r] r s Úobjectr9 c C s d S rg r\ r r\ r\ r] r s z=Union[AssociationProxyInstance[_T], _T, AssociationProxy[_T]]c C s6 |d kr | S | ||¡}|r&| |¡S |d ks2t| S rg )Ú _as_instanceÚgetÚAssertionError)rh rf r Úinstr\ r\ r] r s
|
rn )rf ÚvaluesrX c C s t |}| ||¡ ||¡ d S rg )r r¡ Úset)rh rf r¥ r r\ r\ r] Ú__set__¬ s zAssociationProxy.__set__re c C s t |}| ||¡ |¡ d S rg )r r¡ Údelete)rh rf r r\ r\ r] Ú
|
__delete__° s zAssociationProxy.__delete__r r r c C s | ||¡S )aé Return the internal state local to a specific mapped class.
|
|
E.g., given a class ``User``::
|
|
class User(Base):
|
# ...
|
|
keywords = association_proxy('kws', 'keyword')
|
|
If we access this :class:`.AssociationProxy` from
|
:attr:`_orm.Mapper.all_orm_descriptors`, and we want to view the
|
target class for this proxy as mapped by ``User``::
|
|
inspect(User).all_orm_descriptors["keywords"].for_class(User).target_class
|
|
This returns an instance of :class:`.AssociationProxyInstance` that
|
is specific to the ``User`` class. The :class:`.AssociationProxy`
|
object remains agnostic of its parent class.
|
|
:param class\_: the class that we are returning state for.
|
|
:param obj: optional, an instance of the class that is required
|
if the attribute refers to a polymorphic target, e.g. where we have
|
to look at the type of the actual destination object to get the
|
complete path.
|
|
.. versionadded:: 1.3 - :class:`.AssociationProxy` no longer stores
|
any state specific to a particular parent class; the state is now
|
stored in per-class :class:`.AssociationProxyInstance` objects.
|
|
|
)r¡ r r\ r\ r] r ´ s #zAssociationProxy.for_classc C s z|j | jd }W n tk
|
r, d }Y nX |d krn| |¡}|d k rjt | ||¡}t|| jd | nd }|d k r|js| |¡S |S d S )NÚ_inst) Ú__dict__rq ÚKeyErrorÚ _calc_ownerÚAssociationProxyInstanceÚ for_proxyÚsetattrÚ _is_canonicalÚ _non_canonical_get_for_object)rh r r r¤ r r\ r\ r] r¡ Ù s
|
|
|
z AssociationProxy._as_instance)Ú
|
target_clsrX c C s4 z t |}W n tjk
|
r$ Y d S X |jjjS d S rg )r! r ÚNoInspectionAvailableÚmapperZ class_managerr )rh r³ Úinspr\ r\ r] r ô s
|
z AssociationProxy._calc_ownerr r c sn | j t ¡ ddd fdd }|tkrLdddddfdd }||fS dddd
|
fd d }||fS d S ) Nr rU re c s | d k r | S d S rg r\ ©rf ©Ú_getterr\ r] Úgetter s z0AssociationProxy._default_getset.<locals>.getterrn ©rf Úkro rX c s t | | d S rg ©r° ©rf r¼ ro ©rW r\ r] Ú dict_setter s z5AssociationProxy._default_getset.<locals>.dict_setter©ÚoÚvrX c s t | | d S rg r½ ©r rà r¿ r\ r] Ú plain_setter s z6AssociationProxy._default_getset.<locals>.plain_setter©r
ÚoperatorÚ
|
attrgetterÚdict©rh r rº rÀ rÅ r\ ©r¹ rW r] r s
|
z AssociationProxy._default_getsetr{ c C s d| j | jf S )NzAssociationProxy(%r, %r))rV r
r| r\ r\ r] Ú__repr__ s þzAssociationProxy.__repr__)N)ra rb rc r Z is_attributer_ r` Zextension_typer r r r§ r© r r¡ r r rÌ r\ r\ r\ r] r[ V s4 õ"0 ÿ%r[ Ú_Selfr c @ sT e Zd ZU dZded< ded< dddddd d
|
Zded < ed dd ddddZedddddddddZddddZ e
|
dddd Z d dd d Z ed ddd d!d"Z ejddd#d$Ze
|
d%dd&d'Ze
|
d(dd)d*Ze
|
d+dd,d-Zejd.dd/d0Zejd.dd1d2Ze
|
d.dd3d4Zd5ed6< d7ed8< d9dd:d;Zd d<d=d>d?Zejd@ddAdBZedCdDdCdEdFdGZ ed dHdIdJdGZ d dKdIdLdGZ d dHd9dMdNdOZ d d9dIdPdQZ dRdSdTdUdVZ dWdXd9dYdZd[Z dWd9d\d]d^Z!dkd`d dadbdcddZ"dld`d dadbdedfZ#dmd`d dadbdgdhZ$dddidjZ%d_S )nr® aâ A per-class object that serves class- and object-specific results.
|
|
This is used by :class:`.AssociationProxy` when it is invoked
|
in terms of a specific class or instance of a class, i.e. when it is
|
used as a regular Python descriptor.
|
|
When referring to the :class:`.AssociationProxy` as a normal Python
|
descriptor, the :class:`.AssociationProxyInstance` is the object that
|
actually serves the information. Under normal circumstances, its presence
|
is transparent::
|
|
>>> User.keywords.scalar
|
False
|
|
In the special case that the :class:`.AssociationProxy` object is being
|
accessed directly, in order to get an explicit handle to the
|
:class:`.AssociationProxyInstance`, use the
|
:meth:`.AssociationProxy.for_class` method::
|
|
proxy_state = inspect(User).all_orm_descriptors["keywords"].for_class(User)
|
|
# view if proxy object is scalar or not
|
>>> proxy_state.scalar
|
False
|
|
.. versionadded:: 1.3
|
|
r~ r z _AssociationProxyProtocol[_T]r r rN )r Ú owning_classÚ target_classr
c C s2 || _ |j| _|| _|j| _d | _|| _|| _d S rg )r rq rÎ rV r rÏ r
)rh r rÎ rÏ r
r\ r\ r] r H s z!AssociationProxyInstance.__init__rÏ zAssociationProxy[_T]r r )r rÎ Úparent_instancerX c
|
C sÚ |j }|j}tdt |¡ |¡}t|tjs8tdd |j j
|
}ztd| ||¡}W nl t k
|
rx t |||| Y S tk
|
r } z.t d|j d|j d|j d| ¡| W 5 d } ~ X Y nX | |||||¡S d S )Nz orm.RelationshipProperty[_T]zEassociation proxy to a non-relationship intermediary is not supportedr zRAssociation proxy received an unexpected error when trying to retreive attribute "Ú.z" from class "z": )rV r
r r" Ú class_mapperÚ get_propertyÚ
|
isinstanceZRelationshipPropertyÚNotImplementedErrorrµ r Ú _cls_unwrap_target_assoc_proxyÚAttributeErrorÚ!AmbiguousAssociationProxyInstanceÚ Exceptionr ÚInvalidRequestErrorra Ú_construct_for_assoc)
|
Úclsr rÎ rÐ rV r
ÚproprÏ Ú target_assocÚerrr\ r\ r] r¯ ` sL þ ÿý
|
þ ÿ ÿû ÿz"AssociationProxyInstance.for_proxyz&Optional[AssociationProxyInstance[_T]])rÞ r rÎ rÏ r
rX c C sb |d k rt ||||S t||}t|ds8t||||S |j}|rPt ||||S t||||S d S )NZ_is_internal_proxy)Ú ObjectAssociationProxyInstanceÚgetattrÚhasattrrØ Z_impl_uses_objectsÚ ColumnAssociationProxyInstance)rÜ rÞ r rÎ rÏ r
rW Z is_objectr\ r\ r] rÛ s: ÿ
|
|
ÿ ÿ ÿz-AssociationProxyInstance._construct_for_assoczMapperProperty[Any]r{ c C s t | j¡ | j¡S rg )r" rÒ rÎ rÓ rV r| r\ r\ r] Ú _get_property¬ s ÿz&AssociationProxyInstance._get_propertyzPropComparator[Any]c C s t | j| jjS rg )rá rÎ rV Ú
|
comparatorr| r\ r\ r] Ú _comparator± s ÿz$AssociationProxyInstance._comparatorr c C s t dd S )NzqThe association proxy can't be used as a plain column expression; it only works inside of a comparison expression©rÕ r| r\ r\ r] Ú__clause_element__· s ÿz+AssociationProxyInstance.__clause_element__)rÏ r
rX c C s* t ||}t|trtt|tr&|S d S rg )rá rÔ r[ r£ r® )rÜ rÏ r
rW r\ r\ r] rÖ ½ s
|
|
|
z7AssociationProxyInstance._cls_unwrap_target_assoc_proxyc C s | | j| j¡S rg )rÖ rÏ r
r| r\ r\ r] Ú_unwrap_target_assoc_proxyÇ s ÿz3AssociationProxyInstance._unwrap_target_assoc_proxyúSQLORMOperations[_T]c C s t dt| j| jS )zéThe 'remote' class attribute referenced by this
|
:class:`.AssociationProxyInstance`.
|
|
.. seealso::
|
|
:attr:`.AssociationProxyInstance.attr`
|
|
:attr:`.AssociationProxyInstance.local_attr`
|
|
rê )r rá rÏ r
r| r\ r\ r] Ú remote_attrÏ s ÿz$AssociationProxyInstance.remote_attrúSQLORMOperations[Any]c C s t dt| j| jS )zéThe 'local' class attribute referenced by this
|
:class:`.AssociationProxyInstance`.
|
|
.. seealso::
|
|
:attr:`.AssociationProxyInstance.attr`
|
|
:attr:`.AssociationProxyInstance.remote_attr`
|
|
rì )r rá rÎ rV r| r\ r\ r] Ú
|
local_attrß s þz#AssociationProxyInstance.local_attrz2Tuple[SQLORMOperations[Any], SQLORMOperations[_T]]c C s | j | jfS )aÔ Return a tuple of ``(local_attr, remote_attr)``.
|
|
This attribute was originally intended to facilitate using the
|
:meth:`_query.Query.join` method to join across the two relationships
|
at once, however this makes use of a deprecated calling style.
|
|
To use :meth:`_sql.select.join` or :meth:`_orm.Query.join` with
|
an association proxy, the current method is to make use of the
|
:attr:`.AssociationProxyInstance.local_attr` and
|
:attr:`.AssociationProxyInstance.remote_attr` attributes separately::
|
|
stmt = (
|
select(Parent).
|
join(Parent.proxied.local_attr).
|
join(Parent.proxied.remote_attr)
|
)
|
|
A future release may seek to provide a more succinct join pattern
|
for association proxy attributes.
|
|
.. seealso::
|
|
:attr:`.AssociationProxyInstance.local_attr`
|
|
:attr:`.AssociationProxyInstance.remote_attr`
|
|
)rí rë r| r\ r\ r] rW ð s z AssociationProxyInstance.attrrT c C s | ¡ j }|r| ¡ |S )zsReturn ``True`` if this :class:`.AssociationProxyInstance`
|
proxies a scalar relationship on the local side.)rä ÚuselistÚ _initialize_scalar_accessors)rh Úscalarr\ r\ r] rð s z AssociationProxyInstance.scalarc C s | ¡ j | j¡j S rg )rä rµ rÓ r
rî r| r\ r\ r] Ú_value_is_scalar s
|
ÿÿz)AssociationProxyInstance._value_is_scalarc C s
|
t d S rg rç r| r\ r\ r] Ú_target_is_object! s z*AssociationProxyInstance._target_is_objectz_GetterProtocol[_T]Ú _scalar_getú_PlainSetterProtocol[_T]Ú _scalar_setrn c C sD | j jr | j d | ¡\}}n| j d ¡\}}|td| | _| _d S )Nrô )r rC r r ró rõ )rh r¢ Úset_r\ r\ r] rï ( s ÿz5AssociationProxyInstance._initialize_scalar_accessorsr r c sn | j t ¡ ddd fdd }|tkrLdddddfd d
|
}||fS dddd fd d }||fS d S )Nr z Optional[_T]re c s | d k r | S d S rg r\ r· r¸ r\ r] rº 7 s z8AssociationProxyInstance._default_getset.<locals>.getterr9 rn r» c s t | | d S rg r½ r¾ r¿ r\ r] rÀ < s z=AssociationProxyInstance._default_getset.<locals>.dict_setterrÁ c s t | | d S rg r½ rÄ r¿ r\ r] rÅ B s z>AssociationProxyInstance._default_getset.<locals>.plain_setterrÆ rÊ r\ rË r] r 1 s
|
z(AssociationProxyInstance._default_getsetr8 c C s | j jS rg )r rF r| r\ r\ r] rF G s z AssociationProxyInstance.inforÍ r )rh r rX c C s d S rg r\ ©rh r r\ r\ r] r¢ K s z AssociationProxyInstance.getr9 ©r rX c C s d S rg r\ r÷ r\ r\ r] r¢ O s z1Union[Optional[_T], AssociationProxyInstance[_T]]c C sÀ |d kr | S | j r(t|| j}| |¡S z tdt|| j\}}}W n tk
|
rX Y n,X t||krt| |kr| jd k st |S |
|
t || j¡\| _}t || jt|t| |f |S d S )NzTuple[int, int, _T]) rð rá rV ró r rq r× r r r£ Ú_newÚ_lazy_collectionr° )rh r ÚtargetZ
|
creator_idÚself_idr r\ r\ r] r¢ S s(
|
|
ÿ
|
ÿ
|
)r r¥ rX c C s² | j rtd| jjr| jjn| j}t|| j}|d krV|d krBd S t|| j|| q®| ||¡ |d kr®| jj r®t|| jd n,|
|
|¡}| j d k st ||k r®| | |¡ d S )Nú_PlainCreatorProtocol[_T])rð r r rB rÏ rá rV r° rõ rG r¢ r r£ Ú _bulk_replace)rh r r¥ rB rû r r\ r\ r] r¦ r s& ÿ
|
û
|
z AssociationProxyInstance.setc C sL | j d kr| |d ¡ | jr<t|| j}|d k r<t|| j t|| j d S rg )rÎ r rð rá rV Údelattrr
©rh r rû r\ r\ r] r¨ s
|
z AssociationProxyInstance.deletez_LazyCollectionProtocol[_T]zTuple[Type[Any], _T])r rX c C s | j jd k r| j jn
|
td| j}t | ¡}|d krDt d| ¡| j jrd|| j ||| j | ¡fS | j j
|
r| j
|
|| ¡\}}n| j |¡\}}|t kr²|tt t||||| fS |tkrÔ|tt t||||| fS |tkrö|tt t||||| fS t d| j| jf ¡d S )Nrr zDlazy collection factory did not return a valid collection type, got zcould not guess which interface to use for collection_class "%s" backing "%s"; specify a proxy_factory and proxy_bulk_set manually)r rB r rÏ r# Zduck_type_collectionr rÚ rD r
rC r Úlistr9 Ú_AssociationListrÉ Ú_AssociationDictr¦ Ú_AssociationSetÚ ArgumentErrorr rV )rh r rB r rº Úsetterr\ r\ r] rù s
|
ÿ
|
|
ý ÿ ÿþ ÿþþ ÿþþ ÿþþ
|
|
ýÿz AssociationProxyInstance._newr r )r r¥ rX c C sz | j jr| j ||¡ n^| jtkr4td| |¡ nB| jtkrPtd| |¡ n&| jtkrltd| |¡ n
|
t
|
d¡d S )Nz_AssociationList[Any]z_AssociationDict[Any, Any]z_AssociationSet[Any]zEno proxy_bulk_set supplied for custom collection_class implementation) r rE r r r ÚextendrÉ Úupdater¦ r r )rh r r¥ r\ r\ r] Ú_set× s
|
|
|
ÿz AssociationProxyInstance._set)r rX c C sb | j jr| j jptt| j}| j jr:| j | j| ¡\}}n| j | j¡\}}||_||_||_ d S rg )
|
r rB r rr rÏ rC r r rº r )rh r rB rº r r\ r\ r] Ú_inflateè s ÿ
|
ý ÿ
|
z!AssociationProxyInstance._inflateNú)Optional[_ColumnExpressionArgument[bool]]úColumnElement[bool]©Ú criterionÚkwargsrX c K s | dd ¡}| j}|d k r:|jf d|i|}| j |¡S | jr`t| j| j}|jj|f|}n*|rpt
|
d¡n|r|d k rt
|
d¡|}| j |¡S )NÚis_hasr zJCan't apply keyword arguments to column-targeted association proxy; use ==zINon-empty has() not allowed for column-targeted association proxy; use ==) Úpopré Ú_criterion_existsræ rò rá rÏ r
rå r r )rh r r r rÞ ÚinnerrW Z
|
value_exprr\ r\ r] r ú s, ÿÿ ÿ ÿz*AssociationProxyInstance._criterion_existsc K s< | j dkr&| jr&| jr | jr&t d¡| jf |dd|S )a Produce a proxied 'any' expression using EXISTS.
|
|
This expression will be a composed product
|
using the :meth:`.Relationship.Comparator.any`
|
and/or :meth:`.Relationship.Comparator.has`
|
operators of the underlying proxied attributes.
|
|
Nz9'any()' not implemented for scalar attributes. Use has().F©r r ©ré rð rò rñ r rÚ r ©rh r r r\ r\ r] Úany s
|
ÿþþÿ ÿÿz AssociationProxyInstance.anyc K s< | j dkr&| jr | jr&| js&t d¡| jf |dd|S )a Produce a proxied 'has' expression using EXISTS.
|
|
This expression will be a composed product
|
using the :meth:`.Relationship.Comparator.any`
|
and/or :meth:`.Relationship.Comparator.has`
|
operators of the underlying proxied attributes.
|
|
Nz4'has()' not implemented for collections. Use any().Tr r r r\ r\ r] Úhas3 s
|
ÿþþÿ ÿÿz AssociationProxyInstance.hasc C s d| j j| jf S )Nz%s(%r))Ú __class__ra r r| r\ r\ r] rÌ K s z!AssociationProxyInstance.__repr__)N)N)N)&ra rb rc r r r Ú classmethodr¯ rÛ rä Úpropertyræ rè rÖ r# Úmemoized_propertyré rë rí rW rð rñ rò rï r Zro_non_memoized_propertyrF r r¢ r¦ r¨ rù r r
|
r r r rÌ r\ r\ r\ r] r® ' sh
|
.
|
B þ# þ þr® c s¸ e Zd ZdZdZddddZddd fd d
|
Zd ddd d Zd ddddZd#ddddddZ d$ddddddZ
|
e j ddddZ dddd d Zdd d d d!d"Z ZS )%rØ zcan :class:`.AssociationProxyInstance` where we cannot determine
|
the type of target object.
|
Fr r{ c C s" t d| jj| j| j| jf d S )NzÀAssociation proxy %s.%s refers to an attribute '%s' that is not directly mapped on class %s; therefore this operation cannot proceed since we don't know what type of object is referred towards)r× rÎ ra rV r
rÏ r| r\ r\ r] Ú
|
_ambiguousV s üüÿz,AmbiguousAssociationProxyInstance._ambiguousr rø c s |d kr | S t |¡S d S rg )Úsuperr¢ r÷ ©r r\ r] r¢ d s z%AmbiguousAssociationProxyInstance.getr c C s | ¡ d S rg ©r r÷ r\ r\ r] Ú__eq__j s z(AmbiguousAssociationProxyInstance.__eq__c C s | ¡ d S rg r r÷ r\ r\ r] Ú__ne__m s z(AmbiguousAssociationProxyInstance.__ne__Nr r c K s | ¡ d S rg r r r\ r\ r] r p s z%AmbiguousAssociationProxyInstance.anyc K s | ¡ d S rg r r r\ r\ r] r w s z%AmbiguousAssociationProxyInstance.hasz-Dict[Type[Any], AssociationProxyInstance[_T]]c C s i S rg r\ r| r\ r\ r] Ú _lookup_cache~ s z/AmbiguousAssociationProxyInstance._lookup_cacher )rÐ rX c C s |d k rt || j}|d k rz t|}W n tjk
|
r> Y nFX |j}|j}|| jkrb| ||¡ z | j| W S t k
|
r Y nX | S rg )
|
rá rV r! r r´ rµ r r# Ú_populate_cacher¬ )rh rÐ Z
|
actual_objr¶ rµ Úinstance_classr\ r\ r] r²
s
|
z?AmbiguousAssociationProxyInstance._non_canonical_get_for_objectz Mapper[Any]rn )r% rµ rX c C st t | j¡ | j¡}| |j¡rp|}z| || j¡}W n t k
|
rJ Y n&X |
|
t d|| j | j|| j¡| j |< d S )Nr )r" rÒ rÎ rÓ rV Zisarµ rÖ r
r× rÛ r r r# )rh r% rµ rÝ rÏ rÞ r\ r\ r] r$ s& ÿ ÿûz1AmbiguousAssociationProxyInstance._populate_cache)N)N)ra rb rc r r± r r¢ r! r" r r r# r r# r² r$ Ú __classcell__r\ r\ r r] rØ O s þ þrØ c @ sT e Zd ZU dZdZded< dZdddddd Zddd
|
d d Zddd
|
d dZ dS )rà zEan :class:`.AssociationProxyInstance` that has an object as a target.TrT rò r r )ÚotherÚkwrX c K s | j }|dk r.| j |js$| |¡n||k¡S | jr\| jr\| js\| j t| j | j
|
|¡¡S | jrz| jrz| jrzt d¡n| jjf | j
|
|iS dS )aI Produce a proxied 'contains' expression using EXISTS.
|
|
This expression will be a composed product
|
using the :meth:`.Relationship.Comparator.any`,
|
:meth:`.Relationship.Comparator.has`,
|
and/or :meth:`.Relationship.Comparator.contains`
|
operators of the underlying proxied attributes.
|
Nz<contains() doesn't apply to a scalar object endpoint; use ==) ré ræ r rð Úcontainsrò rñ r rá rÏ r
r rÚ )rh r' r( rÞ r\ r\ r] r) ½ s.
|
ÿ ýÿþýÿÿÿz'ObjectAssociationProxyInstance.containsrø c C s@ |d kr(t | jjf | j|i| jd kS | jjf | j|iS d S rg )r- ræ r r
r÷ r\ r\ r] r! à s þz%ObjectAssociationProxyInstance.__eq__c C s | j t| j| j|k¡S rg )ræ r rá rÏ r
r÷ r\ r\ r] r" ë s ÿz%ObjectAssociationProxyInstance.__ne__N)
|
ra rb rc r rò r r± r) r! r" r\ r\ r\ r] rà · s
|
# rà c @ sF e Zd ZU dZdZded< dZdddd d
|
Zd ddd d ddZdS )rã zVan :class:`.AssociationProxyInstance` that has a database column as a
|
target.
|
FrT rò Tr r ©r' rX c C s6 | | j tj|¡¡}|d kr.t|| jd kS |S d S rg )r rë Úoperater, Úeqr- ræ )rh r' Úexprr\ r\ r] r! û s ÿz%ColumnAssociationProxyInstance.__eq__zoperators.OperatorTypezColumnElement[Any])Úopr' r rX c O s | | jj|f||¡S rg )r rë r+ )rh r. r' r r\ r\ r] r+ s ÿz&ColumnAssociationProxyInstance.operateN) ra rb rc r rò r r± r! r+ r\ r\ r\ r] rã ó s
|
|
|
rã c @ sH e Zd ZdddddZdddd Zddd
|
d Zdd d ddZdS )rú r rN ©r rû c C s || _ || _d S rg ©r rû r r\ r\ r] r s z_lazy_collection.__init__rz r{ c C s t | j| jS rg )rá r rû r| r\ r\ r] ri s z_lazy_collection.__call__c C s | j | jdS )Nr/ r0 r| r\ r\ r] Ú __getstate__ s z _lazy_collection.__getstate__rn ©ÚstaterX c C s |d | _ |d | _d S )Nr rû r0 ©rh r3 r\ r\ r] Ú __setstate__ s
|
z _lazy_collection.__setstate__N)ra rb rc r ri r1 r5 r\ r\ r\ r] rú s rú Ú_ITr c @ s° e Zd ZU ded< ded< ded< ded< d ed
|
< d ddddd d d ZejrXded< n edd ZddddZ ddddZ
|
ddddZ dd d d d Z d dd d!Z d"S )#Ú_AssociationCollectionz_GetterProtocol[_IT]rº rr rB z AssociationProxyInstance[_IT]r rk r z _LazyCollectionProtocol[_IT]r ©r rB rº r r c C s" || _ || _|| _|| _|| _dS )z¡Constructs an _AssociationCollection.
|
|
This will always be a subclass of either _AssociationList,
|
_AssociationSet, or _AssociationDict.
|
|
Nr8 )rh r rB rº r r r\ r\ r] r @ s
|
z _AssociationCollection.__init__zCollection[_IT]Úcolc C s | ¡ S rg )r r| r\ r\ r] Ú<lambda>W ó z _AssociationCollection.<lambda>Úintr{ c C s
|
t | jS rg ©Úlenr9 r| r\ r\ r] Ú__len__Y s z _AssociationCollection.__len__rT c C s
|
t | jS rg )rT r9 r| r\ r\ r] Ú__bool__\ s z _AssociationCollection.__bool__r c C s | j | jdS )N©r r rA r| r\ r\ r] r1 _ s z#_AssociationCollection.__getstate__rn r2 c C s$ |d | _ |d | _| j | ¡ d S )Nr r )r r r
|
r4 r\ r\ r] r5 b s
|
|
z#_AssociationCollection.__setstate__c C s
|
t d S rg rç r| r\ r\ r] Úclearg s z _AssociationCollection.clearN)ra rb rc r r ÚtypingÚ TYPE_CHECKINGr r9 r? r@ r1 r5 rB r\ r\ r\ r] r7 ) s
|
|
r7 c @ sP e Zd ZU ded< ded< ddddd Zddd
|
d d Zd dddddZdS )Ú_AssociationSingleItemrô r rý rB r9 r rt c C s
|
| |¡S rg ©rB ru r\ r\ r] Ú_createo s z _AssociationSingleItem._create©Úobject_rX c C s
|
| |¡S rg ©rº ©rh rI r\ r\ r] Ú_getr s z_AssociationSingleItem._getr z Iterable[_IT]rn ©Ú assoc_proxyr¥ rX c C s | ¡ | | |¡ d S rg )rB r )rh rN r¥ r\ r\ r] rþ u s z$_AssociationSingleItem._bulk_replaceN)ra rb rc r rG rL rþ r\ r\ r\ r] rE k s
|
|
rE c @ sþ e Zd ZU dZded< dddddd Zed
|
dd d d Zeddd dd Zddd dd Zed
|
dddddZeddddddZddddddZed
|
dd ddZ eddd d dZ d dd d dZ d d d!d"d#Z
|
d$d%d&d'Z ddd!d(d)Z dd
|
d!d*d+Z ddd,d-d.Zd
|
dddd/d0Zdhd
|
dd d2d3Zddd!d4d5Zd6d%d7d8Zd6d%d9d:Zdd%d;d<Zd d d=d>d?Zd d d=d@dAZdBd d=dCdDZdBd d=dEdFZdBd d=dGdHZdBd d=dIdJZdBdBd=dKdLZdBdBd=dMdNZ dOdBdPdQdRZ dOdBdPdSdTZ ddUdVdWdXZ dOdUdPdYdZZ e!j"rbdidd
|
d
|
d
|
d\d]d^Z#ndd
|
d!d_d^Z#dBd%d`daZ$dbd%dcddZ%d6d%dedfZ&e!j"súe'e( )¡ D ]B\Z*Z+e,e+r²e+j e*kr²e+js²e-e'e*r²e.e'e*je+_q²[*[+dgS )jr z(Generic, converting, list-to-list proxy.zMutableSequence[_T]r9 r r9 rn )rI ro rX c C s | ||¡ d S rg ©r )rh rI ro r\ r\ r] r s z_AssociationList._setr< )ÚindexrX c C s d S rg r\ ©rh rP r\ r\ r] Ú __getitem__ s z _AssociationList.__getitem__Úslicec C s d S rg r\ rQ r\ r\ r] rR s zUnion[int, slice]z Union[_T, MutableSequence[_T]]c s6 t |ts j| ¡S fdd j| D S d S )Nc s g | ]} |¡qS r\ )rL )Ú.0Úmemberr| r\ r] Ú
|
<listcomp> s z0_AssociationList.__getitem__.<locals>.<listcomp>)rÔ rS rL r9 rQ r\ r| r] rR s
|
)rP ro rX c C s d S rg r\ ©rh rP ro r\ r\ r] Ú __setitem__ s z _AssociationList.__setitem__ú Iterable[_T]c C s d S rg r\ rW r\ r\ r] rX s zUnion[_T, Iterable[_T]]c
|
C s t |ts$| | j| td|¡ nð|jd kr8t| }n |jdk rRt| |j }n|j}|jp`d}|jpjd}t t
|
|jpxd||}t |}|dkrÆ|D ]
|
}| |= q|}|D ]} | || ¡ |d7 }qªnNt|t|krît dt|t|f t ||D ]\}} | | j| | ¡ qød S )Nr9 r é zBattempt to assign sequence of size %s to extended slice of size %s)rÔ rS r r9 r Ústopr> ÚstepÚstartr ÚrangeÚinsertÚ
|
ValueErrorÚzip)
|
rh rP ro r[ r\ r] ÚrngZ sized_valueÚiÚitemr\ r\ r] rX s4
|
|
|
|
|
|
þÿc C s d S rg r\ rQ r\ r\ r] Ú __delitem__À s z _AssociationList.__delitem__c C s d S rg r\ rQ r\ r\ r] re Ä s zUnion[slice, int]c C s | j |= d S rg ©r9 rQ r\ r\ r] re È s r rT rt c C s$ | j D ]}| |¡|kr dS qdS ©NTF©r9 rL )rh ro rU r\ r\ r] Ú __contains__Ë s
|
z _AssociationList.__contains__ú Iterator[_T]r{ c c s | j D ]}| |¡V qdS )zÇIterate over proxied values.
|
|
For the actual domain objects, iterate over .col instead or
|
just use the underlying collection directly from its property
|
on the parent.
|
Nrh ©rh rU r\ r\ r] Ú__iter__Ò s
|
z_AssociationList.__iter__c C s | j }| |¡}| |¡ d S rg )r9 rG Úappend)rh ro r9 rd r\ r\ r] rm Þ s
|
z_AssociationList.appendc C s" d}| D ]}||kr|d7 }q|S ©Nr rZ r\ )rh ro Úcountrà r\ r\ r] ro ã s
|
|
z_AssociationList.count)r¥ rX c C s |D ]}| |¡ qd S rg )rm )rh r¥ rà r\ r\ r] r ê s z_AssociationList.extendc C s | |¡g| j||
< d S rg )rG r9 rW r\ r\ r] r_ î s z_AssociationList.insertéÿÿÿÿc C s | | j |¡¡S rg )rº r9 r rQ r\ r\ r] r ñ s z_AssociationList.popc C s4 t | D ] \}}||kr| j|= d S qtdd S )Nzvalue not in list)Ú enumerater9 r` )rh ro rc Úvalr\ r\ r] Úremoveô s
|
z_AssociationList.remover c C s
|
t dS )z#Not supported, use reversed(mylist)Nrç r| r\ r\ r] Úreverseû s z_AssociationList.reversec C s
|
t dS )z!Not supported, use sorted(mylist)Nrç r| r\ r\ r] Úsort s z_AssociationList.sortc C s | j dt| j
= d S )Nr )r9 r> r| r\ r\ r] rB s z_AssociationList.clearr* c C s t | |kS rg ©r ©rh r' r\ r\ r] r! s z_AssociationList.__eq__c C s t | |kS rg rv rw r\ r\ r] r" s z_AssociationList.__ne__zList[_T]c C s t | |k S rg rv rw r\ r\ r] Ú__lt__ s z_AssociationList.__lt__c C s t | |kS rg rv rw r\ r\ r] Ú__le__ s z_AssociationList.__le__c C s t | |kS rg rv rw r\ r\ r] Ú__gt__ s z_AssociationList.__gt__c C s t | |kS rg rv rw r\ r\ r] Ú__ge__ s z_AssociationList.__ge__c C s2 z t |}W n tk
|
r$ t Y S X t | | S rg ©r Ú TypeErrorÚNotImplementedrw r\ r\ r] Ú__add__ s
|
|
z_AssociationList.__add__c C s2 z t |}W n tk
|
r$ t Y S X |t | S rg r| rw r\ r\ r] Ú__radd__! s
|
|
z_AssociationList.__radd__r2 )ÚnrX c C s t |tstS t| | S rg ©rÔ r< r~ r ©rh r r\ r\ r] Ú__mul__( s
|
z_AssociationList.__mul__c C s t |tstS |t| S rg r r r\ r\ r] Ú__rmul__- s
|
z_AssociationList.__rmul__r1 )ÚiterablerX c C s | |¡ | S rg )r )rh r r\ r\ r] Ú__iadd__2 s
|
z_AssociationList.__iadd__c C sD t |tst |dkr"| ¡ n |dkr@| t| |d ¡ | S rn )rÔ r< rÕ rB r r r r\ r\ r] Ú__imul__6 s
|
|
z_AssociationList.__imul__.)ro r] r[ rX c C s d S rg r\ )rh ro r] r[ r\ r\ r] rP E s z_AssociationList.indexc G s t | }|j|f| S rg )r rP )rh ro ÚargZlsr\ r\ r] rP J s c C s t | S rg rv r| r\ r\ r] ÚcopyN s z_AssociationList.copyrN c C s t t| S rg )rI r r| r\ r\ r] rÌ Q s z_AssociationList.__repr__c C s t dt| j d S ©Nz%s objects are unhashable©r} r ra r| r\ r\ r] Ú__hash__T s z_AssociationList.__hash__N)rp )..)/ra rb rc r r r r rR rX re ri rl rm ro r r_ r rs rt ru rB r! r" rx ry rz r{ r r r r
r r rC rD rP r rÌ r r ÚlocalsÚitemsÚ func_nameÚfuncÚcallablerâ rá r\ r\ r\ r] r | sv
|
$ ÿþýür c @ s e Zd ZU dZded< ded< ded< dd d
|
d d d Zd
|
ddddZd
|
ddddddZdddddZdddd ddZ ddddd Z
|
d d dd d Z d!d"d#d$Z dd"d%d&Z d d d'd(d)Zd d d'd*d+Zd,d"d-d.Zedd d/d0d1Zedd2d2d3d4d1Zdcdd6d7d8d9d1Zdddd dd8d:d;Zd<d"d=d>Zd?d"d@dAZdBd"dCdDZeddd/dEdFZededd2d2d3dHdFZdd
|
d
|
d2dIdJdFZdKd"dLdMZedNdddOdPdQZedRdddOdSdQZedddTdUdQZd
|
d
|
ddVdWdQZdXdYddZd[d\Zd]d"d^d_Zd`d"dadbZ e j se e ¡ D ]B\Z!Z"e#e"rHe"j e!krHe"jsHe$e%e!rHe&e%e!je"_qH[!["d5S )fr z(Generic, converting, dict-to-dict proxy.z_DictSetterProtocol[_VT]r z_KeyCreatorProtocol[_VT]rB z"MutableMapping[_KT, Optional[_VT]]r9 r@ z Optional[_VT]r rw c C s | ||¡S rg rF rx r\ r\ r] rG j s z_AssociationDict._createrA rH c C s
|
| |¡S rg rJ rK r\ r\ r] rL m s z_AssociationDict._getrn )rI rq ro rX c C s | |||¡S rg rO )rh rI rq ro r\ r\ r] r p s z_AssociationDict._set)rq rX c C s | | j| ¡S rg )rL r9 ©rh rq r\ r\ r] rR s s z _AssociationDict.__getitem__c C s6 || j kr | | j | ||¡ n| ||¡| j |< d S rg )r9 r rG rx r\ r\ r] rX v s
|
z _AssociationDict.__setitem__c C s | j |= d S rg rf r r\ r\ r] re | s z _AssociationDict.__delitem__r rT c C s
|
|| j kS rg rf r r\ r\ r] ri s z _AssociationDict.__contains__z Iterator[_KT]r{ c C s t | j ¡ S rg )Úiterr9 Úkeysr| r\ r\ r] rl s z_AssociationDict.__iter__c C s | j ¡ d S rg ©r9 rB r| r\ r\ r] rB
s z_AssociationDict.clearr* c C s t | |kS rg ©rÉ rw r\ r\ r] r! s z_AssociationDict.__eq__c C s t | |kS rg r rw r\ r\ r] r" s z_AssociationDict.__ne__rN c C s t t| S rg )rI rÉ r| r\ r\ r] rÌ s z_AssociationDict.__repr__)Ú_AssociationDict__keyrX c C s d S rg r\ ©rh r r\ r\ r] r¢ s z_AssociationDict.getzUnion[_VT, _T])r rJ rX c C s d S rg r\ ©rh r rJ r\ r\ r] r¢ s NzOptional[Union[_VT, _T]]zUnion[_VT, _T, None])rq rJ rX c C s( z
|
| | W S t k
|
r" | Y S X d S rg )r¬ ©rh rq rJ r\ r\ r] r¢ s
|
c C s, || j kr | ||¡| j |< |S | | S d S rg )r9 rG r r\ r\ r] Ú
|
setdefault¡ s
|
z_AssociationDict.setdefaultz KeysView[_KT]c C s
|
| j ¡ S rg )r9 r r| r\ r\ r] r s z_AssociationDict.keyszItemsView[_KT, _VT]c C s t | S rg r
|
r| r\ r\ r] r ° s z_AssociationDict.itemszValuesView[_VT]c C s t | S rg r r| r\ r\ r] r¥ ³ s z_AssociationDict.valuesc C s d S rg r\ r r\ r\ r] r ¶ s z_AssociationDict.pop.c C s d S rg r\ r r\ r\ r] r º s )r r r( rX c O s | j j|f||}| |¡S rg )r9 r rL )rh r r r( rU r\ r\ r] r ¾ s zTuple[_KT, _VT]c C s | j ¡ }|d | |d ¡fS rn )r9 ÚpopitemrL )rh rd r\ r\ r] r  s
|
z_AssociationDict.popitemz SupportsKeysAndGetItem[_KT, _VT])Ú_AssociationDict__mr rX c K s d S rg r\ ©rh r r r\ r\ r] r Æ s z_AssociationDict.updatezIterable[tuple[_KT, _VT]]c K s d S rg r\ r r\ r\ r] r Ì s )r rX c K s d S rg r\ )rh r r\ r\ r] r Ð s )Úar( rX c O s. i }|j || | ¡ D ]\}}|| |< qd S rg )r r )rh r r( Zuprq ro r\ r\ r] r Ô s r zMapping[_KT, _VT]rM c C s~ t | }| |pd¡}t |p d |¡}| |¡}| ¡ p<dD ]*\}}||krX|| |< q>||kr>|| |< q>|D ]
|
}| |= qnd S ©Nr\ )r¦ Ú intersectionÚ
|
differencer ) rh rN r¥ ÚexistingÚ constantsÚ additionsÚremovalsrq rU r\ r\ r] rþ Û s
|
|
|
z _AssociationDict._bulk_replacezDict[_KT, _VT]c C s t | ¡ S rg )rÉ r r| r\ r\ r] r î s z_AssociationDict.copyr c C s t dt| j d S r r r| r\ r\ r] r ñ s z_AssociationDict.__hash__)N)N).)'ra rb rc r r rG rL r rR rX re ri rl rB r! r" rÌ r r¢ r r r r¥ r r r rþ r r rC rD r r r r r râ rÉ rá r\ r\ r\ r] r c sl
|
ÿ ÿþýür c @ sÈ e Zd ZU dZded< ddddZddd d
|
Zd dd d dZddddZdddddZ dddddZ
|
dddddZ dddd Z d dd d d Z d!d dd"d#d$Zd%d&d'd(d)Zd*dd+d,Zd-d&d d.d/Zd%d&d0d1d2Zd3dd d4d5Zd6dd d7d8Zd3dd d9d:Zd6d;d d<d=Zd3dd d>d?Zd6dd d@dAZd3dd dBdCZd6d;d dDdEZd dd0dFdGZd%d&d dHdIZ d3dd'dJdKZ d%d&d'dLdMZ d3dd0dNdOZ d3dd0dPdQZ dddRdSZ!dTddUdVZ"d dd'dWdXZ#d dd'dYdZZ$d6dd'd[d\Z%d6dd'd]d^Z&d6dd'd_d`Z'd6dd'dadbZ(dcddddeZ)dfddgdhZ*e+j,sÄe-e. /¡ D ]B\Z0Z1e2e1r|e1j e0kr|e1js|e3e4e0r|e5e4e0je1_q|[0[1diS )jr z&Generic, converting, set-to-set proxy.zMutableSet[_T]r9 r< r{ c C s
|
t | jS rg r= r| r\ r\ r] r? s z_AssociationSet.__len__rT c C s | j r
|
dS dS d S rg rf r| r\ r\ r] r@ s z_AssociationSet.__bool__r )Ú_AssociationSet__orX c C s$ | j D ]}| |¡|kr dS qdS rg rh )rh r¨ rU r\ r\ r] ri s
|
z _AssociationSet.__contains__rj c c s | j D ]}| |¡V qdS )zÀIterate over proxied values.
|
|
For the actual domain objects, iterate over .col instead or just use
|
the underlying collection directly from its property on the parent.
|
|
Nrh rk r\ r\ r] rl s
|
z_AssociationSet.__iter__r9 rn )Ú_AssociationSet__elementrX c C s || kr| j | |¡¡ d S rg )r9 ÚaddrG )rh r© r\ r\ r] rª s z_AssociationSet.addc C s. | j D ]"}| |¡|kr| j |¡ q*qd S rg )r9 rL Údiscard©rh r© rU r\ r\ r] r« % s
|
z_AssociationSet.discardc C s8 | j D ]$}| |¡|kr| j |¡ d S qt|d S rg )r9 rL r« r¬ r¬ r\ r\ r] rs + s
|
|
z_AssociationSet.removec C s" | j std| j ¡ }| |¡S )Nzpop from an empty set)r9 r¬ r rL rk r\ r\ r] r 2 s
|
z_AssociationSet.poprY )ÚsrX c G s" |D ]}|D ]}| |¡ q qd S rg )rª )rh r r ro r\ r\ r] r 8 s z_AssociationSet.updater rM c
|
C s t | }| |pd¡}t |p d |¡}| |¡}| j}| j}|pDdD ]&} | |kr\|| qF| |krF|| qF|D ] } || qrd S r¡ )r¦ r¢ r£ rª rs )
|
rh rN r¥ r¤ r¥ r¦ r§ ZappenderZremoverrU r\ r\ r] rþ = s
|
|
|
z _AssociationSet._bulk_replacezAbstractSet[_S]zMutableSet[Union[_T, _S]]r* c C s* t | |¡st |D ]}| |¡ q| S rg )r$ Ú_set_binops_check_strictrÕ rª )rh r' ro r\ r\ r] Ú__ior__O s
|
z_AssociationSet.__ior__zSet[_T]c C s t t| S rg )r¦ r r| r\ r\ r] r X s z_AssociationSet._setz Iterable[_S]c G s t | j| S rg )r¦ Úunion©rh r r\ r\ r] r° [ s z_AssociationSet.union)Ú_AssociationSet__srX c C s
|
| |¡S rg )r° ©rh r² r\ r\ r] Ú__or__^ s z_AssociationSet.__or__r c G s t | j| S rg )r¦ r£ r± r\ r\ r] r£ a s z_AssociationSet.differencezAbstractSet[Any]c C s
|
| |¡S rg )r£ r± r\ r\ r] Ú__sub__d s z_AssociationSet.__sub__c G s" |D ]}|D ]}| |¡ q qd S rg )r« )rh r r' ro r\ r\ r] Údifference_updateg s z!_AssociationSet.difference_updater1 c C s* t | |¡st |D ]}| |¡ q| S rg )r$ r® rÕ r« )rh r ro r\ r\ r] Ú__isub__l s
|
z_AssociationSet.__isub__c G s t | j| S rg )r¦ r¢ r± r\ r\ r] r¢ s s z _AssociationSet.intersectionc C s
|
| |¡S rg )r¢ r± r\ r\ r] Ú__and__v s z_AssociationSet.__and__c G s\ |D ]R}| |¡t| }}|| || }}|D ]}| |¡ q2|D ]}| |¡ qFqd S rg )r¢ r¦ rs rª )rh r r' ÚwantÚhavers rª ro r\ r\ r] Úintersection_updatey s z#_AssociationSet.intersection_updatec C sb t | |¡st | |¡}t| }|| || }}|D ]}| |¡ q:|D ]}| |¡ qN| S rg )r$ r® rÕ r¢ r¦ rs rª )rh r r¹ rº rs rª ro r\ r\ r] Ú__iand__ s
|
z_AssociationSet.__iand__c C s t | |¡S rg )r¦ Úsymmetric_differencer³ r\ r\ r] r½ s z$_AssociationSet.symmetric_differencec C s
|
| |¡S rg )r½ r± r\ r\ r] Ú__xor__ s z_AssociationSet.__xor__c C sR | |¡t| }}|| || }}|D ]}| |¡ q*|D ]}| |¡ q>d S rg )r½ r¦ rs rª )rh r' r¹ rº rs rª ro r\ r\ r] Úsymmetric_difference_update s z+_AssociationSet.symmetric_difference_updatec C s t | |¡st | |¡ | S rg )r$ r® rÕ r¿ rw r\ r\ r] Ú__ixor__¢ s
|
z_AssociationSet.__ixor__c C s t | |¡S rg )r¦ Úissubsetr³ r\ r\ r] rÁ © s z_AssociationSet.issubsetc C s t | |¡S rg )r¦ Ú
|
issupersetr³ r\ r\ r] r ¬ s z_AssociationSet.issupersetc C s | j ¡ d S rg r r| r\ r\ r] rB ¯ s z_AssociationSet.clearzAbstractSet[_T]c C s t | S rg ©r¦ r| r\ r\ r] r ² s z_AssociationSet.copyc C s t | |kS rg rà rw r\ r\ r] r! µ s z_AssociationSet.__eq__c C s t | |kS rg rà rw r\ r\ r] r" ¸ s z_AssociationSet.__ne__c C s t | |k S rg rà rw r\ r\ r] rx » s z_AssociationSet.__lt__c C s t | |kS rg rà rw r\ r\ r] ry ¾ s z_AssociationSet.__le__c C s t | |kS rg rà rw r\ r\ r] rz Á s z_AssociationSet.__gt__c C s t | |kS rg rà rw r\ r\ r] r{ Ä s z_AssociationSet.__ge__rN c C s t t| S rg )rI r¦ r| r\ r\ r] rÌ Ç s z_AssociationSet.__repr__r c C s t dt| j d S r r r| r\ r\ r] r Ê s z_AssociationSet.__hash__N)6ra rb rc r r r? r@ ri rl rª r« rs r r rþ r¯ r r° r´ r£ rµ r¶ r· r¢ r¸ r» r¼ r½ r¾ r¿ rÀ rÁ r rB r r! r" rx ry rz r{ rÌ r rC rD r r r r r r râ r¦ rá r\ r\ r\ r] r sh
|
|
ÿþýür )dr Ú
|
__future__r rÇ rC r r r r r r r r r r r r r r r r r r r r r r r r r Ú r r r! r" r# r$ r% r& r' Zorm.baser( Zorm.interfacesr) r* r+ Zsqlr, r- Zsql.baser. Z util.typingr/ r0 r1 r2 r3 rD r4 r5 Z
|
orm.mapperr6 Z sql._typingr7 r8 r9 r; r= r? r@ rA ZNO_ARGr^ r_ rd rk rm rp rr rs rv ry r} r r r ZInspectionAttrInfor[ rÍ r® rØ rà rã rú r6 r7 rE r r r r\ r\ r\ r] Ú<module> sâ ñ.
|
ü O ,h<
|
B h
|
