Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
local
/
lib
/
python3.10
/
dist-packages
/
sqlalchemy
/
orm
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: instrumentation.cpython-310.pyc
o [�h�F � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ e�� Z G d d � d e �Z G d d � d e �Z G d d� de �Ze� Zej ZZej ZZej ZZdd� Zdd� Zdd� Zdd� 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 @ s� e Zd ZdZejZejZe e � e��Z dZ ejZdZdd� Zdd� Zdd� Zed d � �Zed d � �Zed d� �Zedd� �Ze jdd� �ZdZdd�Z dZdd�Z dd� Z dd� Z dd � Z d d � Z!e jd d � �Z"d!d"� Z#d#d$� Z$e j%d%d&� �Z&e j%d'd(� �Z'e j%d)d*� �Z(d[d,d-�Z)d.d/� Z*d0d1� Z+d[d2d3�Z,d4d5� Z-d6d7� Z.d8d9� Z/d:d;� Z0d<d=� Z1d>d?� Z2d@dA� Z3d[dBdC�Z4dDdE� Z5edFdG� �Z6dZdHdI�Z7dZdJdK�Z8dLdM� Z9dNdO� Z:dPdQ� Z;dRdS� Z<d[dTdU�Z=dVdW� Z>e>Z?dXdY� Z@dS )\� ClassManagerz,tracks state information at the class level.Nc C s� || _ i | _d | _i | _i | _dd� dd� | j jD �D �| _| jD ]}| �|� q!| jj � || � |j D ]}t |�}|d urE| j� |j� q4| �� | �� d|jv r\t�d| � d S d S )Nc S s g | ]}|d ur|�qS �N� )�.0�mgrr r �I/usr/local/lib/python3.10/dist-packages/sqlalchemy/orm/instrumentation.py� <listcomp>A s �z)ClassManager.__init__.<locals>.<listcomp>c S s g | ] }t |t�rt|��qS r )� isinstance�type�manager_of_class)r r r r r r C s ���__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_�info�new_init� local_attrs� originals� __bases__�_bases�update�dispatch�_events�_new_classmanager_instance�__mro__r �_update�manage�_instrument_init�__dict__r �warn)�selfr �base_�baseclsr r r r �__init__: s6 �� � ���zClassManager.__init__c C � t | �S r )�id�r% r r r �__hash__` � zClassManager.__hash__c C s || u S r r )r% �otherr r r �__eq__c r- zClassManager.__eq__c C s d| j v S )N�mapper)r# r+ r r r � is_mappedf s zClassManager.is_mappedc C r) r )� frozensetr+ r r r � _all_key_setj s zClassManager._all_key_setc C � t dd� | �� D ��S )Nc S s g | ] }|j jr|j�qS r )�impl� collection�key�r �attrr r r r q s z6ClassManager._collection_impl_keys.<locals>.<listcomp>�r2 �valuesr+ r r r �_collection_impl_keysn s �z"ClassManager._collection_impl_keysc C r4 )Nc S s g | ] }|j jr|j �qS r )r5 �accepts_scalar_loaderr8 r r r r w s ��z5ClassManager._scalar_loader_impls.<locals>.<listcomp>r: r+ r r r �_scalar_loader_implst s ��z!ClassManager._scalar_loader_implsc C s t �| j��r )r �UnmappedClassErrorr r+ r r r r0 ~ s zClassManager.mapperc c sh � |du rt � }| jjD ]%}t |j��|�D ]}|�|� |j| }t|tj�r0|j r0||fV qq dS )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`. N) �setr r r# � difference�addr r �InspectionAttr� is_attribute)r% �exclude�superclsr7 �valr r r �_all_sqla_attributes� s � �� ���z!ClassManager._all_sqla_attributesc C s* | j jD ]}||jv r|j| S q|S )z5return an attribute on the class without tripping it.)r r r# )r% r7 �defaultrF r r r �_get_class_attr_mro� s �z ClassManager._get_class_attr_mroc C s || v o | | j duS )z\Return True if the given attribute is fully initialized. i.e. has an impl. N�r5 �r% r7 r r r �_attr_has_impl� s zClassManager._attr_has_implc C s t |�}|du r 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. N�r �_instrumentation_factory�create_manager_for_cls)r% �cls�managerr r r �_subclass_manager� s z ClassManager._subclass_managerc C s* | j j| _t| j | �| _| �d| j� d S �Nr( )r r( � original_init�_generate_initr �install_memberr+ r r r r" � s z ClassManager._instrument_initc C s | j r | �d� d | _ d S d S rT )r �uninstall_memberr+ r r r �_uninstrument_init� s �z ClassManager._uninstrument_initc C s | j �| | j� tjS r )r � first_initr r � InstanceStater+ r r r �_state_constructor� s z ClassManager._state_constructorc C s t | j| j| � dS )z0Mark this instance as the manager for its class.N)�setattrr � MANAGER_ATTRr+ r r r r! � s zClassManager.managec C s t | j| j� dS )z)Dissasociate this manager from its class.N)�delattrr r^ r+ r r r �dispose� s zClassManager.disposec C � t S r )�_default_manager_getterr+ r r r �manager_getter� � zClassManager.manager_getterc C ra )z�Return a (instance) -> InstanceState callable. "state getter" callables should raise either KeyError or AttributeError if no InstanceState could be found for the instance. )�_default_state_getterr+ r r r � state_getter� s zClassManager.state_getterc C ra r )�_default_dict_getterr+ r r r � dict_getter� rd zClassManager.dict_getterFc C sh |r || j v r d S n || j |< | �||� t�| � || |< | j�� D ]}| �|�}|�||d� q#d S �NT)r �install_descriptor�_memoized_key_collection�expire_instancer �__subclasses__rS �instrument_attribute)r% r7 �inst� propagatedrQ rR r r r rn � s � �z!ClassManager.instrument_attributec c sN � | j �� D ] }t|�}|d ur$|| ur$|V |r$|�d�D ]}|V q qd S ri )r rm r �subclass_managers)r% � recursiverQ r �mr r r rq � s ���z ClassManager.subclass_managersc C s t j�| j|| | � d S r )rO r �attribute_instrumentr rL r r r �post_configure_attribute s �z%ClassManager.post_configure_attributec C sn || vrd S |r|| j v rd S n | j |= | �|� t�| � | |= | j�� D ]}t|�}|r4|�|d� q&d S ri )r �uninstall_descriptorrk rl r rm r �uninstrument_attribute)r% r7 rp rQ rR r r r rw s � ��z#ClassManager.uninstrument_attributec C sD | � � d | _| _| j�� t| �D ] }|| jv r | �|� qdS )z<remove all instrumentation established by this ClassManager.N)rY r0 r r �clear�listr rw rL r r r � unregister s ��zClassManager.unregisterc C s. || j | jfv rtd| ��t| j||� d S �NzW%r: requested attribute name conflicts with instrumentation attribute of the same name.)� STATE_ATTRr^ �KeyErrorr] r )r% r7 ro r r r rj " s ��z ClassManager.install_descriptorc C s t | j|� d S r )r_ r rL r r r rv * � z!ClassManager.uninstall_descriptorc C sF || j | jfv rtd| ��| j�|t| j|d �� t| j||� d S r{ )r| r^ r} r � setdefault�getattrr r] )r% r7 �implementationr r r rW - s ��zClassManager.install_memberc C s, | j �|d �}|d urt| j||� d S d S r )r �popr] r )r% r7 �originalr r r rX 6 s �z ClassManager.uninstall_memberc C s t �|�S r )r �prepare_instrumentation)r% r7 �collection_classr r r �instrument_collection_class; � z(ClassManager.instrument_collection_classc C s" |� }t �| �|�||�}||fS r )r �CollectionAdapter�get_impl)r% r7 r �factory� user_data�adapterr r r �initialize_collection> s �z"ClassManager.initialize_collectionc C s |r|| v S || j v S r )r )r% r7 �searchr r r �is_instrumentedE s z ClassManager.is_instrumentedc C s | | j S r rK rL r r r r� K r� zClassManager.get_implc C s t | �� �S r )�iterr; r+ r r r � attributesN s zClassManager.attributesc C s2 | j �| j �}|d u r| �|| �}| �||� |S r )r �__new__r\ � _state_setter)r% r �instancer r r � new_instanceT s zClassManager.new_instancec C s$ |d u r | � || �}| �||� d S r )r\ r� �r% r� r r r r �setup_instance[ s zClassManager.setup_instancec C s t || j� d S r )r_ r| �r% r� r r r �teardown_instance` r~ z ClassManager.teardown_instancec C s t ||�S r )�_SerializeManager)r% r � state_dictr r r � _serializec r� zClassManager._serializec C sP t || j�rdS | j|jur| jr| �|j��|�S | �|| �}| �||� |S )z�Install a default InstanceState if none is present. A private convenience method used by the __init__ decorator. F) �hasattrr| r � __class__r1 rS �_new_state_if_noner\ r� r� r r r r� f s �� z ClassManager._new_state_if_nonec C s t || j�S r )r� r| r� r r r � has_state| s zClassManager.has_statec C s | � |�j||d�S )�TODO)� optimistic)r� � hasparent)r% r r7 r� r r r � has_parent s zClassManager.has_parentc C � dS )z=All ClassManagers are non-zero regardless of attribute state.Tr r+ r r r �__bool__� rd zClassManager.__bool__c C s d| j j| jt| �f S )Nz<%s of %r at %x>)r� �__name__r r* r+ r r r �__repr__� s �zClassManager.__repr__r )F)Ar� � __module__� __qualname__�__doc__r �DEFAULT_MANAGER_ATTRr^ �DEFAULT_STATE_ATTRr| � staticmethodr � attrsetterr� �deferred_scalar_loader�objectr( rU r� r, r/ �propertyr1 rk r3 r< r> �memoized_propertyr0 rH rJ rM rS r" rY r\ r! r` � hybridmethodrc rf rh rn rq ru rw rz rj rv rW rX r� r� r� r� r� r� r� r� r� r� r� r� r� � __nonzero__r� r r r r r , s| & r c @ s e Zd ZdZdd� Zdd� ZdS )r� z�Provide serialization of a :class:`.ClassManager`. The :class:`.InstanceState` uses ``__init__()`` on serialize and ``__call__()`` on deserialize. c C s |j | _ |j}|j�||� d S r )r rR r �pickle)r% r �drR r r r r( � s z_SerializeManager.__init__c C sh t | j� |_}|d u rt�|d| j ��|jr!|jjs!|j�� |d ur+|� ||� |j � ||� d S )NzxCannot deserialize object of type %r - no mapper() has been configured for this class within the current Python process!) r r rR r �UnmappedInstanceErrorr1 r0 � configured�_configure_allr� r �unpickle)r% r ro r� rR r r r �__call__� s �� z_SerializeManager.__call__N)r� r� r� r� r( r� r r r r r� � s r� c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) �InstrumentationFactoryz'Factory for new ClassManager instances.c C s` |d usJ �t |�d u sJ �| �|�\}}|d u r t}||�}| �||� ||_| j�|� |S r )r �_locate_extended_factoryr �_check_conflictsr� r �class_instrument)r% r rR r� r r r rP � s z-InstrumentationFactory.create_manager_for_clsc C r� )z2Overridden by a subclass to do an extended lookup.)NNr )r% r r r r r� � rd z/InstrumentationFactory._locate_extended_factoryc C r� )z;Overridden by a subclass to test for conflicting factories.Nr )r% r r� r r r r� � rd z'InstrumentationFactory._check_conflictsc C sD t |�}|�� |�� | j�|� tj|jv r t|tj� d S d S r ) r rz r` r �class_uninstrumentr r^ r# r_ )r% r rR r r r rz � s �z!InstrumentationFactory.unregisterN)r� r� r� r� rP r� r� rz r r r r r� � s r� c C s t | �}|du r t�| �}|S )z_Register class instrumentation. Returns the existing or newly created class manager. NrN )r rR r r r �register_class� s r� c C s t �| � dS )z!Unregister class instrumentation.N)rO rz )r r r r �unregister_class� s r� c C s t | j�j|dd�S )z�Return True if the given attribute on the given instance is instrumented by the attributes package. This function may be used regardless of instrumentation applied directly to the class, i.e. no descriptors are required. T)r� )r r� r� )r� r7 r r r r� � s �r� c C s� | j }|sJ �d}tj|dd�}|| }tjr$t|d|�}t|dd�}n t|dd�}t|dd�}t� �� } t|| � | d } |j| _|| _ |rJ|| _ tjsR|rR|| _ | S ) z>Build an __init__ decorator that triggers ClassManager events.z�def __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)�grouped�im_func� func_defaultsN� __defaults__�__kwdefaults__r( ) r( r �format_argspec_init�py2kr� �locals�copy�execr� �_sa_original_initr� r� ) r � class_manager�original__init__� func_body� func_vars� func_text�funcr� �func_kw_defaults�envr( r r r rV s( rV N)r� � r r r r r r �!group_expirable_memoized_propertyrk �dictr r� r� r� rO �instance_statere � instance_dictrg r rb r� r� r� rV r r r r �<module> s* g")
Save
Cancel