�
��4]c@sT
dZd
dl
Z
ddlmZ
ddlmZ
ddlmZ
ddlmZ
ddlm	Z

dd	lmZ
dd
l
mZ
ddl
mZ
ddl
mZ
dd
l
mZ
ddl
mZ
dZd�Zeg
Zdef
d��YZe�e_Zee_def
d��YZdef
d��YZd�Zd�Zd�ZdS(s�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`.

i����Ni(
tutil(
t
attributes(
tbase(
tcollections(
texc(
tinstrumentation(
t_default_dict_getter(
t_default_manager_getter(
t_default_state_getter(
tClassManager(
tInstrumentationFactoryt__sa_instrumentation_manager__c

Cst|t
d
�S(s;Find user-specified instrumentation management for a class.N(tgetattrtINSTRUMENTATION_MANAGERtNone(
tcls((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt%find_native_user_instrumentation_hook;stExtendedInstrumentationRegistryc
Bs�eZ
dZej�Zej�Zej�ZeZ	d
�Z
d�Zd�Zd�Z
d�Zd�Zd�Zd�ZRS(	s�Extends :class:`.InstrumentationFactory` with additional
    bookkeeping, to accommodate multiple types of
    class managers.

    cCsMxFtD]:}||
�
}|dk	r|j|
|�}||fSqWd
SdS(N(NN(tinstrumentation_findersRt_extended_class_manager(tselftclass_tfindertfactorytmanager((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt_locate_extended_factory]s





cCsG|j|
�
j
|g
�
}|rCtd
|
jt|�
f�
�
ndS(NsRmultiple instrumentation implementations specified in %s inheritance hierarchy: %r(t!_collect_management_factories_fort
differencet	TypeErrort__name__tlist(RRRtexisting_factories((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt_check_conflictsfs

	



cCs�||
�
}t|t
�s-t|
|�}n|t
krV|jrVt|_t�
n|j�|j|
<|j�|j	|
<|j
�|j|
<|S(
N(t
isinstanceR	t_ClassInstrumentationAdaptert	_extendedtTruet_install_instrumented_lookupstmanager_gettert_manager_finderststate_gettert_state_finderstdict_gettert
_dict_finders(RRRR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRqs


	




cCs�tj
|
�
}t�}x||D]t}|j|�
}|d
k	rS|j|j�

qx0tD]"}||�
}|d
k	rZPqZqZWd
}|j|�

qW|jd
�

|S(sc
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(	Rtclass_hierarchytsettmanager_of_classRtaddRRtdiscard(RRt	hierarchyt	factoriestmemberRRR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR�s

	












cCsJ|
|jkr0|j|
=|j
|
=|j|
=ntt|�j|
�

dS(
N(R'R)R+tsuperRt
unregister(RR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR5�s








cCsL|
dkrdSy|j
j|
t�}Wntk
r=


dSX||
�
SdS(
N(RR'tgetRR(RRR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR.�s





cCs7|
dkrt
d
�
�
n|jj|
jt�|
�
S(NsNone has no persistent state.(RtAttributeErrorR)R6t	__class__R(Rtinstance((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytstate_of�s



	

cCs7|
dkrt
d
�
�
n|jj|
jt�|
�
S(NsNone has no persistent state.(RR7R+R6R8R(RR9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytdict_of�s



	

(Rt
__module__t__doc__tweakreftWeakKeyDictionaryR'R)R+tFalseR#RR RRR5R.R:R;(((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRQs


								tInstrumentationManagerc
Bs�eZ
dZd
�Zd�Zd�Zd�Zd�Zd�Zd�Z	d�Z
d	�Zd
�Zd�Z
d�Zd
�Zd�Zd�Zd�Zd�ZRS(sWUser-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
CsdS(
N((RR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt__init__�s
cCst|
d
|�
dS(Nt_default_class_manager(
tsetattr(RRR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytmanage�s
cCst|
d
�
dS(NRC(
tdelattr(RRR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytdispose�s
c
Cs
d
�}|S(Nc


Ss|jS(
N(
RC(
R((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR6�s
((RRR6((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR&�s
	c
CsdS(
N((RRtkeytinst((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytinstrument_attribute�s
c
CsdS(
N((RRRHRI((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytpost_configure_attribute�s
cCst|
||�
dS(
N(
RD(RRRHRI((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytinstall_descriptor�s
cCst|
|�
dS(
N(
RF(RRRH((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytuninstall_descriptor�s
cCst|
||�
dS(
N(
RD(RRRHtimplementation((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytinstall_member�s
cCst|
|�
dS(
N(
RF(RRRH((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytuninstall_member�s
cCs
tj
|�
S(
N(Rtprepare_instrumentation(RRRHtcollection_class((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytinstrument_collection_class�s
c
Cs|jS(
N(
t__dict__(RRR9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytget_instance_dict�s
c
CsdS(
N((RRR9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytinitialize_instance_dict
s
cCst|d
|�
dS(Nt_default_state(
RD(RRR9tstate((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt
install_state
s
cCst|d
�
dS(NRW(
RF(RRR9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytremove_state
s
c
Csd
�S(Nc

Ss
t|d
�S(NRW(
R(
R9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt<lambda>

t((RR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR(	
s
cs��
fd
�S(Nc

s�
j�|�S(
N(
RU(
RI(RR(sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR[

R\((RR((RRsQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR*
s
(RR<R=RBRERGR&RJRKRLRMRORPRSRURVRYRZR(R*(((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRA�s$																R"cBs�eZ
dZd
�Zd�Zd�Zd�Zed�
Zd�Z	d�Z
d�Zd	�Zd
�Z
d�Zd�Zdd
�
Zd�Zdd�
Zd�Zd�Zd�Zd�ZRS(s?Adapts a user-defined InstrumentationManager to a ClassManager.cCsG||_|jj
|
�
|_|jj|
�
|_tj||
�
dS(
N(t_adaptedR(t
_get_stateR*t	_get_dictR	RB(RRtoverride((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRB
s
	

c

Cs|jj
|j|�
dS(
N(R]RER(
R((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRE
s
c

Cs|jj
|j�

dS(
N(R]RGR(
R((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRG
s
c

Cs|jj
|j�
S(
N(R]R&R(
R((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR& 
s
cCs<tj
||
||�
|s8|jj
|j|
|�
ndS(
N(R	RJR]R(RRHRIt
propagated((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRJ#
s


cCs7tt
|�j|
�

|jj|j|
||
�
dS(
N(R4R"RKR]R(RRH((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRK(
s

cCs|jj
|j|
|�
dS(
N(R]RLR(RRHRI((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRL,
s
cCs|jj
|j|
�
dS(
N(R]RMR(RRH((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRM/
s
cCs|jj
|j|
|�
dS(
N(R]ROR(RRHRN((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRO2
s
cCs|jj
|j|
�
dS(
N(R]RPR(RRH((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRP5
s
cCs|jj
|j|
|�S(
N(R]RSR(RRHRR((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRS8
s
	
cCsEt|j
d
d�}|r+||
||�Stj||
||�SdS(Ntinitialize_collection(RR]RR	Rb(RRHRXRtdelegate((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRb=
s




cCs)|jj
|j�
}|j||
�
|S(
N(Rt__new__tsetup_instance(RRXR9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytnew_instanceF
s


cCs$|j|
�
rt
S|j|
�
Sd
S(s�Install a default InstanceState if none is present.

        A private convenience method used by the __init__ decorator.
        N(t	has_stateR@Re(RR9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt_new_state_if_noneK
s
cCsT|jj
|j|
�
|dkr7|j|
|�}n|jj|j|
|�
|S(
N(R]RVRRt_state_constructorRY(RR9RX((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyReU
s



cCs|jj
|j|
�
dS(
N(R]RZR(RR9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pytteardown_instance_
s
cCs1y|j|
�

Wnt
jk
r(


tSXtSdS(
N(R^torm_exctNO_STATER@R$(RR9((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRgb
s




c


Cs|jS(
N(
R^(
R((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR(j
s
c


Cs|jS(
N(
R_(
R((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR*m
s
N(RR<R=RBRERGR&R@RJRKRLRMRORPRSRbRRfRhReRjRgR(R*(((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR"
s(
													

			cCs,tt
d
tjdtjdtj��

dS(s�
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.

    tinstance_statet
instance_dictR.N(t_install_lookupstdictt_instrumentation_factoryR:R;R.(((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyR%q
s



	
	
cCs,tt
d
tdtdt��

tt_dS(sRestore simplified lookups.RmRnR.N(RoRpRRRR@RqR#(((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt_reinstall_default_lookups�
s




c

Csg|d
a|da
|datt_t_t_t
t_
t_
t_
tt_t_t_dS(NRmRnR.(RmRnR.torm_baseR
torm_instrumentation(
tlookups((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyRo�
s




(R=R>R\RtormR
RRsRRRkRRttorm.instrumentationRRRR	R
R
RRRRqtobjectRAR"R%RrRo(((sQ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/ext/instrumentation.pyt<module>s.










		o
	La