bD
& d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ej Z G d d
e
Z G d d e Z
G d
de Z e Zej xZZej xZZej xZZd Zd Zd Zd ZdS )a Defines SQLAlchemy's system of class instrumentation.
This module is usually not directly visible to user applications, but
defines a large part of the ORM's interactivity.
instrumentation.py deals with registration of end-user classes
for state tracking. It interacts closely with state.py
and attributes.py which establish per-instance and per-class-attribute
instrumentation, respectively.
The class instrumentation system can be customized on a per-class
or global basis using the :mod:`sqlalchemy.ext.instrumentation`
module, which provides the means to build and specify
alternate instrumentation forms.
.. versionchanged: 0.8
The instrumentation extension system was moved out of the
ORM and into the external :mod:`sqlalchemy.ext.instrumentation`
package. When that package is imported, it installs
itself within sqlalchemy.orm so that its more comprehensive
resolution mechanics take effect.
)base) collections)exc)
interfaces)state )utilc ^ e Zd ZdZej Zej Z e e
j e Z dZ
ej ZdZd Zd Zd Zed Zed Zed Zed Ze
j d
Zd/d Z d/d Z d
Z d Z d Z d Z!e
j d Z"d Z#d Z$e
j% d Z&e
j% d Z'e
j% d Z(d0dZ)d Z*d Z+d0dZ,d Z-d Z.d Z/d Z0d Z1d! Z2d" Z3d0d#Z4d$ Z5ed% Z6d/d&Z7d/d'Z8d( Z9d) Z:d* Z;d+ Ze>Z?d. Z@dS )1 ClassManagerz,Tracks state information at the class level.Nc || _ i | _ d | _ i | _ i | _ d d | j j D D | _ | j D ]}| | | j j
|| |j D ]2}t | }| | j
|j 3| | d|j v rt# j d|z d S d S )Nc g | ]}||S N ).0mgrs r/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib64/python3.11/site-packages/sqlalchemy/orm/instrumentation.py
z)ClassManager.__init__..A s)
c V g | ]&}t |t t | 'S r )
isinstancetypemanager_of_class)r r s r r z)ClassManager.__init__..C s@ dD)) && r __del__z__del__() method on class %s will cause unreachable cycles and memory leaks, as SQLAlchemy instrumentation often creates reference cycles. Please remove this method.)class_infonew_init local_attrs originals __bases___basesupdatedispatch_events_new_classmanager_instance__mro__r _updatemanage_instrument_init__dict__r warn)selfr base_baseclsr s r __init__zClassManager.__init__: sJ
K 1
[ E KK
88FFF ~ 4 4G"7++C
%%cl333
' ' I@ CII
( 'r c t | S r )idr+ s r __hash__zClassManager.__hash__` s
$xxr c
|| u S r r )r+ others r __eq__zClassManager.__eq__c s } r c d| j v S )Nmapper)r) r1 s r is_mappedzClassManager.is_mappedf s 4=((r c t | S r ) frozensetr1 s r _all_key_setzClassManager._all_key_setj s r c X t d | D S )Nc 4 g | ]}|j j |j S r )impl
collectionkeyr attrs r r z6ClassManager._collection_impl_keys..q s$ H H H$493G HTX H H Hr r: valuesr1 s r _collection_impl_keysz"ClassManager._collection_impl_keysn s- H H$++-- H H H
r c X t d | D S )Nc 4 g | ]}|j j |j S r )r> accepts_scalar_loaderrA s r r z5ClassManager._scalar_loader_impls..w s5
92
r rC r1 s r _scalar_loader_implsz!ClassManager._scalar_loader_implst s8
KKMM
r c 4 t j | j r )r UnmappedClassErrorr r1 s r r7 zClassManager.mapper~ s $T[111r c # K i }| j j dd D ]s}|j d }|j D ]\}| || ||j v r"|| j | }t |t
j r
|j r||fV ]tdS )a return an iterator of all classbound attributes that are
implement :class:`.InspectionAttr`.
This includes :class:`.QueryableAttribute` as well as extension
types such as :class:`.hybrid_property` and
:class:`.AssociationProxy`.
r N)r r% r)
setdefaultr r InspectionAttr is_attribute)r+ excludefoundsuperclsinheritsr@ vals r _all_sqla_attributesz!ClassManager._all_sqla_attributes s +AbD1 # #H '*H (
#
# h///(+++ Cj)#. sJ$=>>#(# s(NNN
# # #r c T | j j D ]}||j v r|j | c S |S )z5return an attribute on the class without tripping it.)r r% r) )r+ r@ defaultrT s r _get_class_attr_mroz ClassManager._get_class_attr_mro sF + Hh''' (---- ( Nr c ( || v o| | j duS )z\Return True if the given attribute is fully initialized.
i.e. has an impl.
Nr> r+ r@ s r _attr_has_implzClassManager._attr_has_impl s d{9tCy~T 99r c \ t | }|t | }|S )a Create a new ClassManager for a subclass of this ClassManager's
class.
This is called automatically when attributes are instrumented so that
the attributes can be propagated to subclasses against their own
class-local manager, without the need for mappers etc. to have already
pre-configured managers for the full class hierarchy. Mappers
can post-configure the auto-generated ClassManager when needed.
r _instrumentation_factorycreate_manager_for_cls)r+ clsmanagers r _subclass_managerz ClassManager._subclass_manager s. #3'' ?.EEcJJGr c | j j | _ t | j | | _ | d| j d S Nr. )r r.
original_init_generate_initr install_memberr1 s r r( z ClassManager._instrument_init sB "[ 1&t{D99
J
66666r c P | j r | d d | _ d S d S rg )r uninstall_memberr1 s r _uninstrument_initz ClassManager._uninstrument_init s5 = ! ! !* - - - DMMM ! !r c Z | j | | j t j S r )r"
first_initr r
InstanceStater1 s r _state_constructorz ClassManager._state_constructor s%
t{333""r c < t | j | j | dS )z0Mark this instance as the manager for its class.N)setattrr MANAGER_ATTRr1 s r r' zClassManager.manage s! T .55555r c : t | j | j dS )z)Disassociate this manager from its class.N)delattrr rt r1 s r disposezClassManager.dispose s T ./////r c t S r )_default_manager_getterr1 s r manager_getterzClassManager.manager_getter s &&r c t S )zReturn a (instance) -> InstanceState callable.
"state getter" callables should raise either KeyError or
AttributeError if no InstanceState could be found for the
instance.
)_default_state_getterr1 s r state_getterzClassManager.state_getter s
%$r c t S r )_default_dict_getterr1 s r dict_getterzClassManager.dict_getter s ##r Fc 0 |r || j v rd S n || j |< | || t | || |< | j D ].}| | }| ||d /d S NT)r install_descriptor_memoized_key_collectionexpire_instancer __subclasses__re instrument_attribute)r+ r@ inst
propagatedrc rd s r r z!ClassManager.instrument_attribute s /d&&& ' %)D S ! # #C . . . 00666S ;--// : :C,,S11G ( (dD 9 9 9 9 : :r c # K | j D ]9}t | }|&|| ur"|V |r | d D ]}|V :d S r )r r r subclass_managers)r+ recursiverc r ms r r z ClassManager.subclass_managers s ;--// C"3''C3d?? 2 24 8 8
r c ^ t j | j || | d S r )ra r" attribute_instrumentr r] s r post_configure_attributez%ClassManager.post_configure_attribute
s4 )>> Kd3i
r c ( || vrd S |r || j v rd S n | j |= | | t | | |= | j D ])}t
| }|r| |d *d S r )r uninstall_descriptorr r r r r uninstrument_attribute)r+ r@ r rc rd s r r z#ClassManager.uninstrument_attribute s d?? F +d&&& ' % % %c * * * 00666 I;--// : :C&s++G
:..sD999 : :r c | dx| _ | _ | j t | D ] }|| j v r| | !dS )z@CD
S$'''''r c 0 t | j | d S r )rv r r] s r r z!ClassManager.uninstall_descriptor6 s S!!!!!r c || j | j fv rt d|z | j |t | j |d t | j || d S r )r rt r r rO getattrr rs )r+ r@ implementations r rj zClassManager.install_member9 sy 4?D$56 6 6>@CD
!!#wt{C'F'FGGG S.11111r c p | j |d }|t | j || d S d S r )r poprs r )r+ r@ originals r rl z ClassManager.uninstall_memberB sA >%%c400 DKh / / / / / r c * t j | S r )r prepare_instrumentation)r+ r@ collection_classs r instrument_collection_classz(ClassManager.instrument_collection_classG s 23CDDDr c p | }t j | | || }||fS r )r CollectionAdapterget_impl)r+ r@ r factory user_dataadapters r initialize_collectionz"ClassManager.initialize_collectionJ s? GII / MM# y
!!r c |r|| v S || j v S r )r )r+ r@ searchs r is_instrumentedz ClassManager.is_instrumentedQ s" +$; $** *r c | | j S r r\ r] s r r zClassManager.get_implW s Cy~ r c D t | S r )iterrD r1 s r
attributeszClassManager.attributesZ s DKKMM"""r c | j | j }|| || }| || |S r )r __new__rq
_state_setter)r+ r instances r new_instancezClassManager.new_instance` sN ;&&t{33 =++Hd;;E 8U+++r c b || || }| || d S r )rq r r+ r r s r setup_instancezClassManager.setup_instanceg s8 =++Hd;;E 8U+++++r c 0 t || j d S r )rv r r+ r s r teardown_instancez ClassManager.teardown_instancel s $/*****r c " t || S r )_SerializeManager)r+ r
state_dicts r
_serializezClassManager._serializeo s
333r c t || j rdS | j |j ur4| j r-| |j | S | || }| || |S )zInstall a default InstanceState if none is present.
A private convenience method used by the __init__ decorator.
F) hasattrr r __class__r8 re _new_state_if_nonerq r r s r r z ClassManager._new_state_if_noner s 8T_ - - 5
[ 2
2
2t~
2 ))" **
+ ++Hd;;E x / / /Lr c , t || j S r )r r r s r has_statezClassManager.has_state s x 111r c V | | || S )TODO)
optimistic)r hasparent)r+ r r@ r s r
has_parentzClassManager.has_parent s' }}S!!++Ej+IIIr c dS )z=All ClassManagers are non-zero regardless of attribute state.Tr r1 s r __bool__zClassManager.__bool__ s tr c J d| j j | j t | fz S )Nz<%s of %r at %x>)r __name__r r0 r1 s r __repr__zClassManager.__repr__ s* ! N # K tHH%
r r )F)Ar
__module__ __qualname____doc__r DEFAULT_MANAGER_ATTRrt DEFAULT_STATE_ATTRr staticmethodr
attrsetterr deferred_scalar_loaderobjectr. rh r r2 r5 propertyr8 r r; rE rI memoized_propertyr7 rW rZ r^ re r( rm rq r' rw hybridmethodrz r} r r r r r r r r rj rl r r r r r r r r r r r r r __nonzero__r r r r r r , s 66,L(J L !Build an __init__ decorator that triggers ClassManager events.zdef __init__(%(apply_pos)s):
new_state = class_manager._new_state_if_none(%(self_arg)s)
if new_state:
return new_state._initialize_instance(%(apply_kw)s)
else:
return original__init__(%(apply_kw)s)
F)groupedim_func
func_defaultsN __defaults____kwdefaults__r. ) r. r format_argspec_initpy2kr localscopyexecr _sa_original_initr r ) r
class_manageroriginal__init__ func_body func_vars func_textfuncr func_kw_defaultsenvr. s r ri ri s I ()95IIIII%I y M'4DEE ot<<
0.$GG
"#35EtLL
((--//CC:H'/H!1H . - 9 3) 3"2 Or N)r r r r r r r !group_expirable_memoized_propertyr dictr r r r ra instance_stater|
instance_dictr r ry r r r ri r r r r s 2 B4ACC n
n
n
n
n
4 n
n
n
b 5 5 5 5 5 5 5 5D$7 $7 $7 $7 $7V $7 $7 $7R 2133
*.)< <&'+'9 9
$-1-B B *
0 0 0
+ + + + +r