ó H`¾Tc@sÏdZddlmZmZmZddlmZddlmZddlZej dd ƒZ ej d d ƒZ ej d d ƒZ ej ddƒZ ej ddƒZej ddddƒZej ddddƒZej ddddƒZej ddddƒZej ddddƒZej d d!dd"ƒZej d#d$dd%ƒZej d&d'dd(ƒZej d)d*deeBeBeBeBƒZej d+d,deeAƒZej d-d.deeAƒZej d/d0deeAƒZej d1d2deeAƒZej d3d4deeAƒZd5Zd6Zd\Zej d9ƒZ ej d:ƒZ!ej d;d<ƒZ"ej d=d>ƒZ#ej d?d@ƒZ$ej dAdBƒZ%e&dgƒZ(dC„Z)dD„Z*ej+eƒZ,ej+dEƒZ-dF„Z.dG„Z/dH„Z0dI„Z1dJ„Z2dK„Z3dL„Z4ej5e6ƒdM„ƒZ7dN„Z8dO„Z9dP„Z:dQ„Z;dR„Z<dS„Z=dT„Z>ej?dUƒZ@ej5eAƒeBdV„ƒZCeDdW„ZEdXe6fdY„ƒYZFdZe6fd[„ƒYZGdS(]s=Constants and rudimental functions used throughout the ORM. i(tutilt inspectiontexc(t expressioni(RiÿÿÿÿNtPASSIVE_NO_RESULTs¦Symbol returned by a loader callable or other attribute/history retrieval operation when a value could not be determined, based on loader callable flags. t ATTR_WAS_SETs•Symbol returned by a loader callable to indicate the retrieved value, or values, were assigned to their attributes on the target object. t ATTR_EMPTYs@Symbol used internally to indicate an attribute had no callable.tNO_VALUEsÂSymbol which may be placed as the 'previous' value of an attribute, indicating no value was loaded for an attribute when it was modified, and flags indicated we were not to load it. t NEVER_SETsŽSymbol which may be placed as the 'previous' value of an attribute indicating that the attribute had not been assigned to previously. t NO_CHANGEs]No callables or SQL should be emitted on attribute access and no state should change t canonicalit CALLABLES_OKsELoader callables can be fired off if a value is not present. tSQL_OKsBLoader callables can emit SQL at least on scalar value attributes.tRELATED_OBJECT_OKsZCallables can use SQL to load related objects as well as scalar value attributes. itINIT_OKs‹Attributes should be initialized with a blank value (None or an empty collection) upon get, if no other value can be obtained. itNON_PERSISTENT_OKs9Callables can be emitted if the parent is not persistent.itLOAD_AGAINST_COMMITTEDsUCallables should use committed values as primary/foreign keys during a load. i t NO_AUTOFLUSHs*Loader callables should disable autoflush.i@t PASSIVE_OFFs&Callables can be emitted in all cases.tPASSIVE_RETURN_NEVER_SETsPASSIVE_OFF ^ INIT_OKtPASSIVE_NO_INITIALIZEs'PASSIVE_RETURN_NEVER_SET ^ CALLABLES_OKtPASSIVE_NO_FETCHsPASSIVE_OFF ^ SQL_OKtPASSIVE_NO_FETCH_RELATEDsPASSIVE_OFF ^ RELATED_OBJECT_OKtPASSIVE_ONLY_PERSISTENTsPASSIVE_OFF ^ NON_PERSISTENT_OKt_sa_class_managert_sa_instance_statetmappert instrumentort EXT_CONTINUEtEXT_STOPt ONETOMANYs¢Indicates the one-to-many direction for a :func:`.relationship`. This symbol is typically used by the internals but may be exposed within certain API features. t MANYTOONEs¢Indicates the many-to-one direction for a :func:`.relationship`. This symbol is typically used by the internals but may be exposed within certain API features. t MANYTOMANYs£Indicates the many-to-many direction for a :func:`.relationship`. This symbol is typically used by the internals but may be exposed within certain API features. t NOT_EXTENSIONs¡Symbol indicating an :class:`_InspectionAttr` that's not part of sqlalchemy.ext. Is assigned to the :attr:`._InspectionAttr.extension_type` attibute. cstj‡fd†ƒ}|S(s1Mark a method as generative, e.g. method-chained.csI|djƒ}xˆD]}|||jƒqW|||d|Ž|S(Nii(t_clonet__name__(tfntargstkwtselft assertion(t assertions(sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pytgenerateºs  (Rt decorator(R)R*((R)sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt _generative·scCs|jjtdƒS(N(t__dict__tgettDEFAULT_MANAGER_ATTRtNone(tcls((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pytmanager_of_classÆsR-cCstt|ƒƒS(s'Return a string describing an instance.(t state_strtinstance_state(tinstance((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt instance_strÎscCs4|dkrdSd|jjt|jƒƒfSdS(s=Return a string describing an instance via its InstanceState.R0s <%s at 0x%x>N(R0tclass_R#tidtobj(tstate((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyR3Ôs cCs%|dkrdSd|jjfSdS(sNReturn a string describing an instance's class via its InstanceState. R0s<%s>N(R0R7R#(R:((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pytstate_class_strÝs cCst|ƒd|S(Nt.(R6(R5t attribute((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt attribute_strèscCst|ƒd|S(NR<(R3(R:R=((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pytstate_attribute_strìscCs t|ƒjS(s¥Given an object, return the primary Mapper associated with the object instance. Raises :class:`sqlalchemy.orm.exc.UnmappedInstanceError` if no mapping is configured. This function is available via the inspection system as:: inspect(instance).mapper Using the inspection system will raise :class:`sqlalchemy.exc.NoInspectionAvailable` if the instance is not part of a mapping. (t object_stateR(R5((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt object_mapperðscCs2t|ƒ}|dkr*tj|ƒ‚n|SdS(sµGiven an object, return the :class:`.InstanceState` associated with the object. Raises :class:`sqlalchemy.orm.exc.UnmappedInstanceError` if no mapping is configured. Equivalent functionality is available via the :func:`.inspect` function as:: inspect(instance) Using the inspection system will raise :class:`sqlalchemy.exc.NoInspectionAvailable` if the instance is not part of a mapping. N(t_inspect_mapped_objectR0RtUnmappedInstanceError(R5R:((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyR@s  cCs>yt|ƒSWn)tjk r%dStjk r9dSXdS(N(R4RtUnmappedClassErrorR0tNO_STATE(R5((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyRBs cCs8tj|tƒ}|dk r%|jStj|ƒ‚dS(N(RtinspecttFalseR0RRRD(tclass_or_mappertinsp((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt_class_to_mapper's cCs-tj|tƒ}|dk r%|jSdSdS(s\Return the :class:`.Mapper` for the given class or None if the class is not mapped. N(RRFRGR0R(tentityRI((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt_mapper_or_none/s cCs=tj|tƒ}|dk o<t|dƒo<|jp<|jS(shReturn True if the given object is a mapped class, :class:`.Mapper`, or :class:`.AliasedClass`. RN(RRFRGR0thasattrt is_mappertis_aliased_class(RKRI((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt_is_mapped_class;s   cCs't|dƒr|jStj|ƒSdS(Ntkey(RMRQRt_column_as_key(tattr((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt _attr_as_keyIscCsItj|tƒ}t|dƒr>g|jjD] }|^q.S|gSdS(Nt selectable(RRFRGRMRUtc(RKRIRV((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt _orm_columnsPscCs.tj|tƒ}|dk o-t|dtƒS(NRO(RRFRGR0tgetattr(RKRI((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt_is_aliased_classXs cCs¯tj|ƒ}|jr*|}|j}nC|jrE|j}|}n(t|dƒrg|jj}}n|}yt ||ƒSWn*t k rªt j d||fƒ‚nXdS(sŽReturn a class attribute given an entity and string name. May return :class:`.InstrumentedAttribute` or user-defined attribute. Rs Entity '%s' has no property '%s'N( RRFt is_selectableRVRORKRMRR7RXtAttributeErrortsa_exctInvalidRequestError(RKRQRIt description((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt_entity_descriptor^s       smanager.mappercCsby&t|ƒ}|jsdS|j}Wntjk r=dSX|rZ|jrZ|jƒn|SdS(N(R2t is_mappedR0RRREt _new_mapperst_configure_all(R7t configuret class_managerR((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt_inspect_mapped_class|s    cCs`t|d|ƒ}|dkrXt|tƒsFtjd|fƒ‚ntj|ƒ‚n|SdS(sâGiven a class, return the primary :class:`.Mapper` associated with the key. Raises :exc:`.UnmappedClassError` if no mapping is configured on the given class, or :exc:`.ArgumentError` if a non-class object is passed. Equivalent functionality is available via the :func:`.inspect` function as:: inspect(some_mapped_class) Using the inspection system will raise :class:`sqlalchemy.exc.NoInspectionAvailable` if the class is not mapped. Rcs Class object expected, got '%r'.N(ReR0t isinstancettypeR\t ArgumentErrorRRD(R7RcR((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt class_mapper‹s t_InspectionAttrcBs>eZdZeZeZeZeZeZeZ eZ e Z RS(s A base class applied to all ORM objects that can be returned by the :func:`.inspect` function. The attributes defined here allow the usage of simple boolean checks to test basic facts about the object returned. While the boolean checks here are basically the same as using the Python isinstance() function, the flags here can be used without the need to import all of these classes, and also such that the SQLAlchemy class system can change while leaving the flags here intact for forwards-compatibility. ( R#t __module__t__doc__RGRZROt is_instanceRNt is_propertyt is_attributetis_clause_elementR!textension_type(((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyRj¦s t_MappedAttributecBseZdZRS(sVMixin for attributes which should be replaced by mapper-assigned attributes. (R#RkRl(((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyRrès(smapperR(HRltRRRR\tsqlRtoperatortsymbolRRRRRR R R R RRRRRRRRRRR/tDEFAULT_STATE_ATTRt _INSTRUMENTORRRRRR R!t frozensetR0t _none_setR,R2t attrgetterR4t instance_dictR6R3R;R>R?RAR@t _inspectstobjectRBRJRLRPRTRWRYR_t dottedgettert _state_mapperRgRGRetTrueRiRjRr(((sY/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/base.pyt sÚ                                     B