�
���ec@s@
dZd
dl
Z
ddlmZ
ddlmZ
ddlmZ
ddlmZ
ddlmZ
d	d
lmZ
d	dlm	Z	
ej
d�
Zd
e	efd��YZ
def
d��YZdef
d��YZe�ZejZZejZZejZZeeeeeed�Zd�Zd�Zd�ZdS(s�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.

i����Ni
(
tbase(
tcollections(
texc(
t
interfaces(
tstatei(
tutil(
tHasMemoizedtDEL_ATTRtClassManagercBs�eZ
dZejZejZee	j
e�
�
Zd2Z
d2Zd2Zd2Zd2Zd2Zee	jd
dd�

d��
�
Zeje	jd
dd�

d��
�
Zd�Zed2d2d2d2d2d�Zd�Zd	�Zd
�Zed��
Zejd��
Z ejd
��
Z!ejd��
Z"ejd��
Z#e	j$d��
Zd2d�
Z%d2d�
Z&d�Z'd�Z(d�Z)e	j$d��
Z*d�Z+e	j,d��
Z-e	j,d��
Z.e	j,d��
Z/ed�
Z0d�Z1d�Z2ed�
Z3d�Z4d �Z5d!�Z6d"�Z7d#�Z8d$�Z9d%�Z:ed&�
Z;d'�Z<ed(��
Z=d2d)�
Z>d2d*�
Z?d+�Z@d,�ZAd-�ZBd.�ZCed/�
ZDd0�ZEeEZFd1�ZGRS(3s,Tracks state information at the class level.s1.4tmessagesWThe ClassManager.deferred_scalar_loader attribute is now named expired_attribute_loaderc


Cs|jS(
N(
texpired_attribute_loader(
tself((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytdeferred_scalar_loaderAscCs
|
|_dS(
N(
R
(Rtobj((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRJscCs6
|
|_i|_
d|_i|_i|_t|_gg|jjD]!}t	|t
�rFt|�
^qFD]}|dk	rk|^qk|_x|jD]}|j
|�

q�W|jjj|
|�
x?|
jD]4}t|�
}|dk	r�|jj|j�

q�q�W|j�
d
|
jkr2
tjd|
�

ndS(Nt__del__s�__del__() method on class %s will cause unreachable cycles and memory leaks, as SQLAlchemy instrumentation often creates reference cycles.  Please remove this method.(tclass_tinfotNonetnew_inittlocal_attrst	originalstFalset
_finalizedt	__bases__t
isinstancettypetmanager_of_classt_basestupdatetdispatcht_eventst_new_classmanager_instancet__mro__t_updatetmanaget__dict__Rtwarn(RRRtmgrtbase_tbasecls((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt__init__Ss.
	
	
	
	
	
	

%






cCs�|r||_n|r(|j
|�

n|rCtj|�
|_n|rU||_n|r�|jsutd
|�
�
||_n|js�|jdk	r�|j
jtjkr�|jn	|j
j|_
n|
r�|jr�|j�
ndS(Ns>class is already instrumented, init_method %s can't be applied(tmappert_add_managertweakreftreftdeclarative_scanR
RtAssertionErrortinit_methodRRR(tobjectt
original_initt	_finalize(RtfinalizeR)tregistryR-R
R/((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
_update_stateys&












	


c

Cs7|jr
dSt
|_|j�
tjj|j�

dS(
N(RtTruet_instrument_initt_instrumentation_factoryRtclass_instrumentR(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR2�s

	

	
c

Cs
t|�
S(
N(
tid(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt__hash__�s
cCs
|
|kS(
N((Rtother((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt__eq__�s
c

Cs
d
|jkS(NR)(
R#(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt	is_mapped�sc

Cs
t|�
S(
N(
t	frozenset(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt_all_key_set�sc
Cs2tg|j
�D]}
|
jjr|
j^q�
S(
N(R?tvaluestimplt
collectiontkey(Rtattr((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt_collection_impl_keys�s
c
Cs2tg|j
�D]}
|
jjr|
j^q�
S(
N(R?RARBtaccepts_scalar_loader(RRE((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt_scalar_loader_impls�s

c
Cs&tg|j
�D]}
|
j^q�
S(
N(R?RARB(RRE((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
_loader_impls�sc

Cstj
|j�
�
dS(
N(RtUnmappedClassErrorR(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR)�sccs�i}x�|jj
d
d!D]�}|j
d}xp|jD]e}|j||�
||jkrbq7n||j|}t|tj�r7|jr7||fV
q7q7WqWdS(s
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`.

        ii����i
N(RR R#t
setdefaultRRtInspectionAttrtis_attribute(RtexcludetfoundtsuperclstinheritsRDtval((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt_all_sqla_attributes�s









	cCs9x2|jj
D] }|
|jkr
|j|
Sq
W|Sd
S(s5return an attribute on the class without tripping it.N(RR R#(RRDtdefaultRP((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt_get_class_attr_mro�s

cCs|
|ko||
jd
k	S(s\Return True if the given attribute is fully initialized.

        i.e. has an impl.
        N(RBR(RRD((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt_attr_has_impl�scCst|
d
t
�

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

        R3(tregister_classR(Rtcls((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt_subclass_manager
sc

Cs2t|j
||j�|_|jd
|j�
dS(NR((t_generate_initRR1Rtinstall_member(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR7

s

c

Cs|jj
||j�
tjS(
N(Rt
first_initRRt
InstanceState(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt_state_constructor
s
c

Cst|j
|j|�
d
S(s0Mark this instance as the manager for its class.N(tsetattrRtMANAGER_ATTR(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR"
sc


CstS(
N(
t_default_manager_getter(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytmanager_getter
sc


CstS(
s�Return a (instance) -> InstanceState callable.

        "state getter" callables should raise either KeyError or
        AttributeError if no InstanceState could be found for the
        instance.
        (
t_default_state_getter(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytstate_getter
s	c


CstS(
N(
t_default_dict_getter(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytdict_getter*
scCs�|r|
|jkr9dSn||j|
<|j
|
|�
|j�
|||
<x9|jj�D](}|j|�
}|j|
|t�
q]WdS(
N(Rtinstall_descriptort_reset_memoizationsRt__subclasses__RYtinstrument_attributeR6(RRDtinstt
propagatedRXtmanager((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRj.
s










ccsrxk|jj
�D]Z}t|�
}|dk	r||k	r|V
|
rjx|jt�
D]}|V
qUWqjqqWdS(
N(RRiRRtsubclass_managersR6(Rt	recursiveRXR%t
m((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRn<
s






cCs!tj
j|j|
||
�
dS(
N(R8Rtattribute_instrumentR(RRD((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytpost_configure_attributeE
s
	
cCs�|
|krdS|r,|
|jkrCdSn|j|
=|j
|
�

|j�
||
=x<|jj�D]+}t|�
}|rd|j|
t�
qdqdWdS(
N(Rtuninstall_descriptorRhRRiRtuninstrument_attributeR6(RRDRlRXRm((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRtJ
s














c
Cs�x$t|j
�
D]}
|j|
�

qWd
|_|_|_|jj�
x3t|�
D]%}
|
|j	krX|j
|
�

qXqXW|j|jj
kr�t|j|j�
nd
S(s<remove all instrumentation established by this ClassManager.N(tlistRtuninstall_memberRR)RRRtclearRRtR`RR#tdelattr(RRD((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
unregisterZ
s





cCsB|
|j|j
fkr+td
|
�
�
nt|j|
|�
dS(NsW%r: requested attribute name conflicts with instrumentation attribute of the same name.(t
STATE_ATTRR`tKeyErrorR_R(RRDRk((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRgj
s





cCst|j
|
�
dS(
N(RxR(RRD((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRsr
s
cCsg|
|j|j
fkr+td
|
�
�
n|jj|
|jjj|
t��
t	|j|
|�
dS(NsW%r: requested attribute name conflicts with instrumentation attribute of the same name.(
RzR`R{RRKRR#tgetRR_(RRDtimplementation((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR[u
s




%
cCsK|jj
|
d�}|tk	r7t|j|
|�
nt|j|
�
dS(
N(RtpopRRR_RRx(RRDtoriginal((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRv~
s


cCs
tj
|�
S(
N(R
tprepare_instrumentation(RRDtcollection_class((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytinstrument_collection_class�
s
cCs1|�}tj
|j|
�
||�}||fS(
N(R
tCollectionAdaptertget_impl(RRDRtfactoryt	user_datatadapter((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytinitialize_collection�
s
	

cCs!|r|
|kS|
|jkSdS(
N(
R(RRDtsearch((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytis_instrumented�
s


cCs||
jS(
N(
RB(RRD((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR��
s
c

Cst|j
��
S(
N(titerRA(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
attributes�
scCsJ|jj
|j�
}|
dkr6|j||�}
n|j||
�
|S(
N(Rt__new__RR^t
_state_setter(RRtinstance((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytnew_instance�
s





cCs5|dkr!|j
|
|�}n|j|
|�
dS(
N(RR^R�(RR�R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytsetup_instance�
s


cCst|
|j
�
dS(
N(RxRz(RR�((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytteardown_instance�
s
cCs
t|
|�S(
N(
t_SerializeManager(RRt
state_dict((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
_serialize�
s
cCstt|
|j
�rtS|j|
jk	rJ|jrJ|j|
j�
j|
�
S|j|
|�}|j	|
|�
|Sd
S(s�Install a default InstanceState if none is present.

        A private convenience method used by the __init__ decorator.

        N(
thasattrRzRRt	__class__R>RYt_new_state_if_noneR^R�(RR�R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR��
s





cCst|
|j
�S(
N(R�Rz(RR�((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt	has_state�
s
cCs|j|�
j
|
d
|�

S(tTODOt
optimistic(R�t	hasparent(RRRDR�((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
has_parent�
sc


CstS(
s=All ClassManagers are non-zero regardless of attribute state.(
R6(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt__bool__�
sc

Cs d
|jj
|jt|�
fS(Ns<%s of %r at %x>(R�t__name__RR:(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt__repr__�
s

	

N(HR�t
__module__t__doc__RtDEFAULT_MANAGER_ATTRR`tDEFAULT_STATE_ATTRRztstaticmethodRt
attrsetterR�RR
R/R�R)R-R4tpropertyt
deprecatedRtsetterR(RR5R2R;R=R>Rtmemoized_attributeR@RFRHRItmemoized_propertyRSRURVRYR7R^R"thybridmethodRbRdRfRjRnRrRtRyRgRsR[RvR�R�R�R�R�R�R�R�R�R�R�R�R�t__nonzero__R�(((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR/s�
	
	








	(




				
!			
																			R�c
Bs eZ
dZd
�Zd�ZRS(s�Provide serialization of a :class:`.ClassManager`.

    The :class:`.InstanceState` uses ``__init__()`` on serialize
    and ``__call__()`` on deserialize.

    cCs,|
j|_|
j
}|jj|
|�
dS(
N(RRmRtpickle(RRt
dRm((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR(�
s

	
cCs�t|j
�
|
_}|dkr>tj|d
|j
��
n&|jrd|jjrd|jj	�
n|dk	r�|j
||
�
n|jj|
|�
dS(NsxCannot deserialize object of type %r - no mapper() has been configured for this class within the current Python process!(
RRRmRRtUnmappedInstanceErrorR>R)t
configuredt_check_configureR�Rtunpickle(RRRkR�Rm((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt__call__�
s







(R�R�R�R(R�(((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR��
s	tInstrumentationFactoryc
Bs2eZ
dZd
�Zd�Zd�Zd�ZRS(s'Factory for new ClassManager instances.cCs}|
dk	st
�
t|
�
dks*t
�
|j|
�
\}}|dkr`t}||
�
}n|j|
|�
||_|S(
N(RR.Rt_locate_extended_factoryRt_check_conflictsR�(RRRmR�((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytcreate_manager_for_clss



	cCsdS(s2Overridden by a subclass to do an extended lookup.N(NN(
R(RR((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR�sc
Csd
S(s;Overridden by a subclass to test for conflicting factories.N((RRR�((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR�scCs*t|
�
}|j
�
|jj|
�

dS(
N(RRyRtclass_uninstrument(RRRm((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRys



(R�R�R�R�R�R�Ry(((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR��
s

			c
Cs\t|�
}|dkr*tj|�
}n|jd
|d|d|d|d|d|
�
|S(s_Register class instrumentation.

    Returns the existing or newly created class manager.

    R)R4R-R
R/R3N(RRR8R�R5(RR3R)R4R-R
R/Rm((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRW.s


	





c

Cstj
|�

d
S(s!Unregister class instrumentation.N(R8Ry(
R((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pytunregister_classLscCst|j
�
j|
d
t�

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

    R�(RR�R�R6(R�RD((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR�Rs
cBs
|d	kr|j
}nd
}ej|de�

}||}ejrme|d|�}e|dd	�}n$e|dd	�}e|dd	�}e�j�}	e	|	d<||	U|	d}
|j
|
_
||
_|r�||
_nejr�|r�||
_
n|
S(
s>Build an __init__ decorator that triggers ClassManager events.s�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)
tgroupedtim_funct
func_defaultst__defaults__t__kwdefaults__R�R(N(RR(Rtformat_argspec_initRtpy2ktgetattrtlocalstcopyR�R�t_sa_original_initR�R�(Rt
class_managerR1t	func_bodyt	func_varst	func_texttfuncR�tfunc_kw_defaultstenvR(((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRZ_s*



	









	


(R�R+tRR
RRRRRtsymbolRtdictRR0R�R�R8tinstance_stateRct
instance_dictReRRaR6RRWR�R�RZ(((sO/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt<module>s4





��"%