Current File : //opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyc
�
��4]c @ s d Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z e j � Z d e
f d
� � YZ d e f d � � YZ
d
e f d � � YZ e � Z e j Z Z e j Z Z e j Z Z d � Z d � Z d � Z d � Z d S( 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 ( t base( t collections( t exc( t
interfaces( t statei ( t utilt ClassManagerc B s6 e Z d Z e j Z e j Z e e j
e � � Z d, Z
e j Z d, Z d � Z d � Z d � Z e d � � Z e d � � Z e d � � Z e d � � Z e j d � � Z d, 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( e) d � Z* d � Z+ d � Z, e) d � Z- d � Z. d � Z/ d � Z0 d � Z1 d � Z2 d � Z3 d � Z4 e) d � Z5 d! � Z6 e d" � � Z7 d, d# � Z8 d, d$ � Z9 d% � Z: d& � Z; d' � Z< d( � Z= e) d) � Z> d* � Z? e? Z@ d+ � ZA RS(- s, tracks state information at the class level.c C s7 | | _ i | _ d | _ i | _ i | _ g g | j j D]! } t | t � r= t | � ^ q= D] } | d k rb | ^ qb | _
x | j
D] } | j | � q� W| j j
j | | � x? | j D]4 } t | � } | d k r� | j j | j � q� q� W| j � | j � d | j k r3t j d | � n d S( 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.( t class_t infot Nonet new_initt local_attrst originalst __bases__t
isinstancet typet manager_of_classt _basest updatet dispatcht _eventst _new_classmanager_instancet __mro__t _updatet managet _instrument_initt __dict__R t warn( t selfR R t mgrt base_t basecls( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt __init__: s. %
c C s
t | � S( N( t id( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt __hash__` s c C s
| | k S( N( ( R t other( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt __eq__c s c C s
d | j k S( Nt mapper( R ( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt is_mappedf s c C s
t | � S( N( t frozenset( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _all_key_setj s c C s2 t g | j � D] } | j j r | j ^ q � S( N( R( t valuest implt
collectiont key( R t attr( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _collection_impl_keysn s c C s2 t g | j � D] } | j j r | j ^ q � S( N( R( R* R+ t accepts_scalar_loader( R R. ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _scalar_loader_implst s c C s t j | j � � d S( N( R t UnmappedClassErrorR ( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR& ~ s c c s� | d k r t � } n xz | j j D]l } xc t | j � j | � D]I } | j | � | j | } t | t j � rD | j
rD | | f VqD qD Wq% Wd S( 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`.
N( R
t setR R R t
differencet addR R t InspectionAttrt is_attribute( R t excludet superclsR- t val( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _all_sqla_attributes� s
c C s9 x2 | j j D] } | | j k r
| j | Sq
W| Sd S( s5 return an attribute on the class without tripping it.N( R R R ( R R- t defaultR9 ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _get_class_attr_mro� s c C s | | k o | | j d k S( s\ Return True if the given attribute is fully initialized.
i.e. has an impl.
N( R+ R
( R R- ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _attr_has_impl� s c C s. t | � } | d k r* t j | � } n | 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.
N( R R
t _instrumentation_factoryt create_manager_for_cls( R t clst manager( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _subclass_manager� s c C s; | j j | _ t | j | � | _ | j d | j � d S( NR! ( R R! t
original_initt _generate_initR t install_member( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR � s c C s& | j r" | j d � d | _ n d S( NR! ( R t uninstall_memberR
( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _uninstrument_init� s
c C s | j j | | j � t j S( N( R t
first_initR R t
InstanceState( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt _state_constructor� s c C s t | j | j | � d S( s0 Mark this instance as the manager for its class.N( t setattrR t MANAGER_ATTR( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR � s c C s t | j | j � d S( s) Dissasociate this manager from its class.N( t delattrR RM ( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt dispose� s c C s t S( N( t _default_manager_getter( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt manager_getter� s c C s t S( 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 ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt state_getter� s c C s t S( N( t _default_dict_getter( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt dict_getter� s c C s� | r | | j k r9 d Sn | | j | <| j | | � t j | � | | | <x9 | j j � D]( } | j | � } | j | | t � q` Wd S( N( R t install_descriptort _memoized_key_collectiont expire_instanceR t __subclasses__RC t instrument_attributet True( R R- t instt
propagatedRA RB ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRZ � s
c c sr xk | j j � D]Z } t | � } | d k r | | k r | V| rj x | j t � D] } | VqU Wqj q q Wd S( N( R RY R R
t subclass_managersR[ ( R t recursiveRA R t m( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR^ � s c C s! t j j | j | | | � d S( N( R? R t attribute_instrumentR ( R R- ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt post_configure_attribute s c C s� | | k r d S| r, | | j k rC d Sn | j | =| j | � t j | � | | =x< | j j � D]+ } t | � } | rg | j | t � qg qg Wd S( N( R t uninstall_descriptorRW RX R RY R t uninstrument_attributeR[ ( R R- R] RA RB ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRd s
c C sa | j � d | _ | _ | j j � x3 t | � D]% } | | j k r4 | j | � q4 q4 Wd S( s< remove all instrumentation established by this ClassManager.N( RH R
R& R R t cleart listR Rd ( R R- ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
unregister s
c C sB | | j | j f k r+ t d | � � n t | j | | � d S( NsW %r: requested attribute name conflicts with instrumentation attribute of the same name.( t
STATE_ATTRRM t KeyErrorRL R ( R R- R\ ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRV " s
c C s t | j | � d S( N( RN R ( R R- ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRc * s c C sd | | j | j f k r+ t d | � � n | j j | t | j | d � � t | j | | � d S( NsW %r: requested attribute name conflicts with instrumentation attribute of the same name.( Rh RM Ri R
t
setdefaultt getattrR R
RL ( R R- t implementation( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRF - s
"c C s; | j j | d � } | d k r7 t | j | | � n d S( N( R
t popR
RL R ( R R- t original( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRG 6 s c C s
t j | � S( N( R t prepare_instrumentation( R R- t collection_class( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt instrument_collection_class; s c C s1 | � } t j | j | � | | � } | | f S( N( R t CollectionAdaptert get_impl( R R- R t factoryt user_datat adapter( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt initialize_collection> s c C s! | r | | k S| | j k Sd S( N( R ( R R- t search( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt is_instrumentedE s
c C s | | j S( N( R+ ( R R- ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRs K s c C s t | j � � S( N( t iterR* ( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
attributesN s c C sJ | j j | j � } | d k r6 | j | | � } n | j | | � | S( N( R t __new__R
RK t
_state_setter( R R t instance( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt new_instanceT s
c C s5 | d k r! | j | | � } n | j | | � d S( N( R
RK R} ( R R~ R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt setup_instance[ s c C s t | | j � d S( N( RN Rh ( R R~ ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt teardown_instance` s c C s
t | | � S( N( t _SerializeManager( R R t
state_dict( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
_serializec s c C st t | | j � r t S| j | j k rJ | j rJ | 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(
t hasattrRh t FalseR t __class__R' RC t _new_state_if_noneRK R} ( R R~ R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR� f s c C s t | | j � S( N( R� Rh ( R R~ ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt has_state| s c C s | j | � j | d | �S( t TODOt
optimistic( Rs t hasparent( R R R- R� ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt
has_parent s c C s t S( s= All ClassManagers are non-zero regardless of attribute state.( R[ ( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt __bool__� s c C s d | j j | j t | � f S( Ns <%s of %r at %x>( R� t __name__R R" ( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt __repr__� s N(B R� t
__module__t __doc__R t DEFAULT_MANAGER_ATTRRM t DEFAULT_STATE_ATTRRh t staticmethodR t
attrsetterR} R
t deferred_scalar_loadert objectR! RD Rt R# R% t propertyR' RW R) R/ R1 t memoized_propertyR& R; R= R> RC R RH RK R RO t hybridmethodRQ RS RU R� RZ R^ Rb Rd Rg RV Rc RF RG Rq Rw Ry Rs R{ R R� R� R� R� R� R� R� t __nonzero__R� ( ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR , sf &
R� c B s e Z d Z d � Z d � Z RS( s� Provide serialization of a :class:`.ClassManager`.
The :class:`.InstanceState` uses ``__init__()`` on serialize
and ``__call__()`` on deserialize.
c C s, | j | _ | j } | j j | | � d S( N( R RB R t pickle( R R t dRB ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR! � s c C s� t | j � | _ } | d k r> t j | d | j � � n& | j rd | j j rd | j j � n | d k r� | j
| | � n | j j | | � d S( Nsx Cannot deserialize object of type %r - no mapper() has been configured for this class within the current Python process!(
R R RB R
R t UnmappedInstanceErrorR' R& t
configuredt _configure_allR� R t unpickle( R R R\ R� RB ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt __call__� s ( R� R� R� R! R� ( ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR� � s t InstrumentationFactoryc B s2 e Z d Z d � Z d � Z d � Z d � Z RS( s' Factory for new ClassManager instances.c C s� | d k s t � t | � d k s* t � | j | � \ } } | d k r` t } | | � } n | j | | � | | _ | j j | � | S( N( R
t AssertionErrorR t _locate_extended_factoryR t _check_conflictsRt R t class_instrument( R R RB Rt ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR@ � s c C s d S( s2 Overridden by a subclass to do an extended lookup.N( NN( R
( R R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR� � s c C s d S( s; Overridden by a subclass to test for conflicting factories.N( ( R R Rt ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR� � s c C sY t | � } | j � | j � | j j | � t j | j k rU t | t j � n d S( N( R Rg RO R t class_uninstrumentR RM R RN ( R R RB ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRg � s
( R� R� R� R@ R� R� Rg ( ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyR� � s
c C s. t | � } | d k r* t j | � } n | S( s_ Register class instrumentation.
Returns the existing or newly created class manager.
N( R R
R? R@ ( R RB ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt register_class� s c C s t j | � d S( s! Unregister class instrumentation.N( R? Rg ( R ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt unregister_class� s c C s t | 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.
Rx ( R R� Ry R[ ( R~ R- ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRy � s c B s� | j } | s t � d } e j | d e �} | | } e j rj e | d | � } e | d d � } n$ e | d d � } e | d d � } e � j � } | | U| d }
| j
|
_
| |
_ | r� | |
_ n e j 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)
t groupedt im_funct
func_defaultst __defaults__t __kwdefaults__R! N( R! R� R t format_argspec_initR� t py2kRk R
t localst copyR� t _sa_original_initR� R� ( R t
class_managert original__init__t func_bodyt func_varst func_textt funcR� t func_kw_defaultst envR! ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyRE s(
N( R� t R R R R R R t! group_expirable_memoized_propertyRW t dictR R� R� R� R? t instance_stateRR t
instance_dictRT R RP R� R� Ry RE ( ( ( sQ /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/instrumentation.pyt <module> s& � f")
Mini Shell