U
|
¸ý°d/? ã @ s d Z ddlZddlmZ ddlmZ ddlmZ ddlmZ ddlm Z
|
dd lm Z ddlmZ dd
|
lmZ dd lmZ dd lmZ dd lmZ ddlmZ ddlmZ dZdd ZegZG dd deZe e _Zee _G dd dZG dd deZdd Z dd Z d d Z dS ) a Extensible class instrumentation.
|
|
The :mod:`sqlalchemy.ext.instrumentation` package provides for alternate
|
systems of class instrumentation within the ORM. Class instrumentation
|
refers to how the ORM places attributes on the class which maintain
|
data and track changes to that data, as well as event hooks installed
|
on the class.
|
|
.. note::
|
The extension package is provided for the benefit of integration
|
with other object management packages, which already perform
|
their own instrumentation. It is not intended for general use.
|
|
For examples of how the instrumentation extension is used,
|
see the example :ref:`examples_instrumentation`.
|
|
é Né )Úutil)Ú
|
attributes)Úbase)Ú collections)Úexc)Úinstrumentation)Ú_default_dict_getter)Ú_default_manager_getter)Ú_default_opt_manager_getter)Ú_default_state_getter)Ú ClassManager)ÚInstrumentationFactoryZ __sa_instrumentation_manager__c C s t | tdS )z;Find user-specified instrumentation management for a class.N)ÚgetattrÚINSTRUMENTATION_MANAGER©Úcls© r úUd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\sqlalchemy/ext/instrumentation.pyÚ%find_native_user_instrumentation_hookE s r c s| e Zd ZdZe ¡ Ze ¡ Ze ¡ ZdZ dd Z
|
dd Z dd Z d d
|
Z fd d Zd d Zdd Zdd Zdd Z ZS )Ú ExtendedInstrumentationRegistryzExtends :class:`.InstrumentationFactory` with additional
|
bookkeeping, to accommodate multiple types of
|
class managers.
|
|
Fc C s6 t D ],}||}|d k r| ||¡}||f S qdS )N)NN)Úinstrumentation_findersÚ_extended_class_manager)ÚselfÚclass_ÚfinderÚfactoryÚmanagerr r r Ú_locate_extended_factoryg s z8ExtendedInstrumentationRegistry._locate_extended_factoryc C s0 | |¡ |g¡}|r,td|jt|f d S )NzRmultiple instrumentation implementations specified in %s inheritance hierarchy: %r)Ú!_collect_management_factories_forÚ
|
differenceÚ TypeErrorÚ__name__Úlist)r r r Zexisting_factoriesr r r Ú_check_conflictsp s ÿþ þÿz0ExtendedInstrumentationRegistry._check_conflictsc C sd ||}t |ts t||}|tkr6| js6d| _t | ¡ | j|< | ¡ | j|< | ¡ | j
|
|< |S )NT) Ú
|
isinstancer Ú _ClassInstrumentationAdapterÚ _extendedÚ _install_instrumented_lookupsÚmanager_getterÚ_manager_findersÚ state_getterÚ_state_findersÚ dict_getterÚ _dict_finders)r r r r r r r r { s
|
|
z7ExtendedInstrumentationRegistry._extended_class_managerc C st t |¡}t }|D ]P}| |¡}|dk r8| |j¡ qtD ]}||}|dk r< qZq<d}| |¡ q| d¡ |S )ac Return a collection of factories in play or specified for a
|
hierarchy.
|
|
Traverses the entire inheritance graph of a cls and returns a
|
collection of instrumentation factories for those classes. Factories
|
are extracted from active ClassManagers, if available, otherwise
|
instrumentation_finders is consulted.
|
|
N)r Zclass_hierarchyÚsetÚopt_manager_of_classÚaddr r Údiscard)r r Z hierarchyZ factoriesÚmemberr r r r r r r s
|
|
|
|
zAExtendedInstrumentationRegistry._collect_management_factories_forc s2 t |¡ || jkr.| j|= | j|= | j|= d S ©N)ÚsuperÚ
|
unregisterr* r, r. ©r r ©Ú __class__r r r6 § s
|
|
z*ExtendedInstrumentationRegistry.unregisterc C s6 z| j |t¡}W n tk
|
r( Y d S X ||S d S r4 )r* Úgetr r! )r r r r r r r0 ® s ÿz4ExtendedInstrumentationRegistry.opt_manager_of_classc C sd z| j |t¡}W n& tk
|
r8 t |d| ¡Y n(X ||}|d kr\t |d| ¡|S d S )Nz2Can't locate an instrumentation manager for class )r* r: r
|
r! Úorm_excZUnmappedClassError)r r r r r r r Úmanager_of_class¹ s ÿ
|
þz0ExtendedInstrumentationRegistry.manager_of_classc C s$ |d krt d| j |jt¡|S ©Nz None has no persistent state.)ÚAttributeErrorr, r: r9 r ©r Úinstancer r r Ústate_ofÊ s ÿþz(ExtendedInstrumentationRegistry.state_ofc C s$ |d krt d| j |jt¡|S r= )r> r. r: r9 r r? r r r Údict_ofÑ s ÿþz'ExtendedInstrumentationRegistry.dict_of)r" Ú
|
__module__Ú __qualname__Ú__doc__ÚweakrefÚWeakKeyDictionaryr* r, r. r' r r$ r r r6 r0 r< rA rB Ú __classcell__r r r8 r r [ s r c @ s e Zd ZdZdd Zdd Zdd Zdd Zd
|
d Zd d Z dd Z
|
dd Z dd Z dd Z dd Zdd Zdd Zd d Zd d Zd d! Zd"d# Zd$S )%ÚInstrumentationManageraW User-defined class instrumentation extension.
|
|
:class:`.InstrumentationManager` can be subclassed in order
|
to change
|
how class instrumentation proceeds. This class exists for
|
the purposes of integration with other object management
|
frameworks which would like to entirely modify the
|
instrumentation methodology of the ORM, and is not intended
|
for regular usage. For interception of class instrumentation
|
events, see :class:`.InstrumentationEvents`.
|
|
The API for this class should be considered as semi-stable,
|
and may change slightly with new releases.
|
|
c C s d S r4 r r7 r r r Ú__init__ô s z InstrumentationManager.__init__c C s t |d| d S ©NÚ_default_class_manager©Úsetattr©r r r r r r Úmanage÷ s z InstrumentationManager.managec C s t |d d S rK ©ÚdelattrrO r r r r6 ú s z!InstrumentationManager.unregisterc C s dd }|S )Nc S s | j S r4 )rL r r r r r: þ s z2InstrumentationManager.manager_getter.<locals>.getr )r r r: r r r r) ý s z%InstrumentationManager.manager_getterc C s d S r4 r ©r r ÚkeyÚinstr r r Úinstrument_attribute s z+InstrumentationManager.instrument_attributec C s d S r4 r rS r r r Úpost_configure_attribute s z/InstrumentationManager.post_configure_attributec C s t ||| d S r4 rM rS r r r Úinstall_descriptor s z)InstrumentationManager.install_descriptorc C s t || d S r4 rQ ©r r rT r r r Úuninstall_descriptor s z+InstrumentationManager.uninstall_descriptorc C s t ||| d S r4 rM )r r rT Úimplementationr r r Úinstall_member s z%InstrumentationManager.install_memberc C s t || d S r4 rQ rY r r r Úuninstall_member s z'InstrumentationManager.uninstall_memberc C s
|
t |¡S r4 )r Zprepare_instrumentation)r r rT Úcollection_classr r r Úinstrument_collection_class s z2InstrumentationManager.instrument_collection_classc C s |j S r4 )Ú__dict__©r r r@ r r r Úget_instance_dict s z(InstrumentationManager.get_instance_dictc C s d S r4 r ra r r r Úinitialize_instance_dict s z/InstrumentationManager.initialize_instance_dictc C s t |d| d S ©NZ_default_staterM )r r r@ Ústater r r Ú install_state s z$InstrumentationManager.install_statec C s t |d d S rd rQ ra r r r Ú remove_state! s z#InstrumentationManager.remove_statec C s dd S )Nc S s
|
t | dS rd )r )r@ r r r Ú<lambda>% ó z5InstrumentationManager.state_getter.<locals>.<lambda>r r7 r r r r+ $ s z#InstrumentationManager.state_getterc s fddS )Nc s | ¡S r4 )rb )rU ©r r r r rh ( ri z4InstrumentationManager.dict_getter.<locals>.<lambda>r r7 r rj r r- ' s z"InstrumentationManager.dict_getterN)r" rC rD rE rJ rP r6 r) rV rW rX rZ r\ r] r_ rb rc rf rg r+ r- r r r r rI ß s$ rI c s¶ e Zd ZdZdd Zdd Zdd Zdd Zd*d d Z fd dZ dd Z
|
dd Z dd Z dd Z dd Zdd Zd+d d Zd d Zd,d d!Zd"d# Zd$d% Zd&d' Zd(d) Z ZS )-r& z?Adapts a user-defined InstrumentationManager to a ClassManager.c C s2 || _ | j |¡| _| j |¡| _t | |¡ d S r4 )Ú_adaptedr+ Ú
|
_get_stater- Ú _get_dictr rJ )r r Úoverrider r r rJ . s z%_ClassInstrumentationAdapter.__init__c C s | j | j| ¡ d S r4 )rk rP r ©r r r r rP 5 s z#_ClassInstrumentationAdapter.managec C s | j | j| ¡ d S r4 )rk r6 r ro r r r r6 8 s z'_ClassInstrumentationAdapter.unregisterc C s | j | j¡S r4 )rk r) r ro r r r r) ; s z+_ClassInstrumentationAdapter.manager_getterFc C s* t | |||¡ |s&| j | j||¡ d S r4 )r rV rk r )r rT rU Z
|
propagatedr r r rV > s z1_ClassInstrumentationAdapter.instrument_attributec s& t |¡ | j | j|| | ¡ d S r4 )r5 rW rk r ©r rT r8 r r rW C s z5_ClassInstrumentationAdapter.post_configure_attributec C s | j | j||¡ d S r4 )rk rX r )r rT rU r r r rX G s z/_ClassInstrumentationAdapter.install_descriptorc C s | j | j|¡ d S r4 )rk rZ r rp r r r rZ J s z1_ClassInstrumentationAdapter.uninstall_descriptorc C s | j | j||¡ d S r4 )rk r\ r )r rT r[ r r r r\ M s z+_ClassInstrumentationAdapter.install_memberc C s | j | j|¡ d S r4 )rk r] r rp r r r r] P s z-_ClassInstrumentationAdapter.uninstall_memberc C s | j | j||¡S r4 )rk r_ r )r rT r^ r r r r_ S s
|
ÿz8_ClassInstrumentationAdapter.instrument_collection_classc C s2 t | jdd }|r ||||S t | |||¡S d S )NÚinitialize_collection)r rk r rq )r rT re r Zdelegater r r rq X s ÿz2_ClassInstrumentationAdapter.initialize_collectionNc C s | j | j ¡}| ||¡ |S r4 )r Ú__new__Úsetup_instance)r re r@ r r r Ú new_instancea s z)_ClassInstrumentationAdapter.new_instancec C s | |¡rdS | |¡S dS )zInstall a default InstanceState if none is present.
|
|
A private convenience method used by the __init__ decorator.
|
FN)Ú has_staters r? r r r Ú_new_state_if_nonef s
|
z/_ClassInstrumentationAdapter._new_state_if_nonec C s: | j | j|¡ |d kr$| || ¡}| j | j||¡ |S r4 )rk rc r Z_state_constructorrf )r r@ re r r r rs p s
|
z+_ClassInstrumentationAdapter.setup_instancec C s | j | j|¡ d S r4 )rk rg r r? r r r Úteardown_instancez s z._ClassInstrumentationAdapter.teardown_instancec C s0 z| |¡ W n tjk
|
r& Y dS X dS d S )NFT)rl r; ZNO_STATEr? r r r ru } s
|
z&_ClassInstrumentationAdapter.has_statec C s | j S r4 )rl ro r r r r+
s z)_ClassInstrumentationAdapter.state_getterc C s | j S r4 )rm ro r r r r- s z(_ClassInstrumentationAdapter.dict_getter)F)N)N)r" rC rD rE rJ rP r6 r) rV rW rX rZ r\ r] r_ rq rt rv rs rw ru r+ r- rH r r r8 r r& + s(
|
|
|
|
|
r& c C s t ttjtjtjtjd dS )aº Replace global class/object management functions
|
with ExtendedInstrumentationRegistry implementations, which
|
allow multiple types of class managers to be present,
|
at the cost of performance.
|
|
This function is called only by ExtendedInstrumentationRegistry
|
and unit tests specific to this behavior.
|
|
The _reinstall_default_lookups() function can be called
|
after this one to re-establish the default functions.
|
|
©Úinstance_stateÚ instance_dictr< r0 N)Ú_install_lookupsÚdictÚ_instrumentation_factoryrA rB r< r0 r r r r r( s üÿr( c C s t tttttd dt_dS )zRestore simplified lookups.rx FN)r{ r| r r r
|
r r} r' r r r r Ú_reinstall_default_lookups£ s üÿr~ c C sr | d a | d a| d a| d at t_ t_ t_ t t_ t_t_t t_ t_t_t t_ t_ t_t_d S )Nry rz r< r0 )ry rz r< r0 Úorm_baser Úorm_instrumentationÚorm_util)Zlookupsr r r r{ ° s. þþþüÿür{ ) rE rF Ú r Zormr r r r r r; r r r Zorm.instrumentationr r
|
r r r r r r r r r} rI r& r( r~ r{ r r r r Ú<module> s8 þLa
|
