H`Tc@sdZddlZddlmZmZmZddlmZmZmZ ddl m Z m Z m Z ddl mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z dd l m!Z!m"Z"ej#d ej$ej%ej&fd YZ'd e'fd YZ(dZ)ej*dZ+ej*dZ,ej*dZ-de.fdYZ/de.fdYZ0de0fdYZ1de1fdYZ2de0fdYZ3dZ4ej*dZ5e6e7ee7ee7egZ8ej9ddd d!gZ:de:fd"YZ:e:e;e;e;Z<ed#Z=ed$Z>e?d%Z@d&ZAe?e;e?e;e;d'ZBe;e;e;d(ZCd)ZDd*ZEd+ZFd,ZGd-ZHd.ZId/ZJd0ZKdS(1sDefines instrumentation for class attributes and their interaction with instances. This module is usually not directly visible to user applications, but defines a large part of the ORM's interactivity. iNi(tutilteventt inspectioni(t interfacest collectionstexc(tinstance_statet instance_dicttmanager_of_class(tPASSIVE_NO_RESULTt ATTR_WAS_SETt ATTR_EMPTYtNO_VALUEt NEVER_SETt NO_CHANGEt CALLABLES_OKtSQL_OKtRELATED_OBJECT_OKtINIT_OKtNON_PERSISTENT_OKtLOAD_AGAINST_COMMITTEDt PASSIVE_OFFtPASSIVE_RETURN_NEVER_SETtPASSIVE_NO_INITIALIZEtPASSIVE_NO_FETCHtPASSIVE_NO_FETCH_RELATEDtPASSIVE_ONLY_PERSISTENTt NO_AUTOFLUSH(t state_strt instance_strtQueryableAttributecBseZdZeZdddddZejdZ e dZ dZ ejdZ ejdZedZdZd Zd Zd Zd Zd ZdZedZdZdZejdZRS(sBase class for :term:`descriptor` objects that intercept attribute events on behalf of a :class:`.MapperProperty` object. The actual :class:`.MapperProperty` is accessible via the :attr:`.QueryableAttribute.property` attribute. .. seealso:: :class:`.InstrumentedAttribute` :class:`.MapperProperty` :attr:`.Mapper.all_orm_descriptors` :attr:`.Mapper.attrs` c Cs||_||_||_||_||_||_t|}|rx:|jD],}||krR|jj ||jqRqRWndS(N( tclass_tkeytimplt comparatort _parententityt_of_typeRt_basestdispatcht_update( tselfRR R!R"t parententitytof_typetmanagertbase((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt__init__8s        cCs |jjS(N(R!tsupports_population(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt_supports_populationKscCs"|jjt|t||S(N(R!t get_historyRR(R(tinstancetpassive((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR0OscCs|S(N((R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt__selectable__SscCs |jjS(sReturn the 'info' dictionary for the underlying SQL element. The behavior here is as follows: * If the attribute is a column-mapped property, i.e. :class:`.ColumnProperty`, which is mapped directly to a schema-level :class:`.Column` object, this attribute will return the :attr:`.SchemaItem.info` dictionary associated with the core-level :class:`.Column` object. * If the attribute is a :class:`.ColumnProperty` but is mapped to any other kind of SQL expression other than a :class:`.Column`, the attribute will refer to the :attr:`.MapperProperty.info` dictionary associated directly with the :class:`.ColumnProperty`, assuming the SQL expression itself does not have its own ``.info`` attribute (which should be the case, unless a user-defined SQL construct has defined one). * If the attribute refers to any other kind of :class:`.MapperProperty`, including :class:`.RelationshipProperty`, the attribute will refer to the :attr:`.MapperProperty.info` dictionary associated with that :class:`.MapperProperty`. * To access the :attr:`.MapperProperty.info` dictionary of the :class:`.MapperProperty` unconditionally, including for a :class:`.ColumnProperty` that's associated directly with a :class:`.schema.Column`, the attribute can be referred to using :attr:`.QueryableAttribute.property` attribute, as ``MyClass.someattribute.property.info``. .. versionadded:: 0.8.0 .. seealso:: :attr:`.SchemaItem.info` :attr:`.MapperProperty.info` (R"tinfo(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR4Ws)cCstj|jS(sReturn an inspection instance representing the parent. This will be either an instance of :class:`.Mapper` or :class:`.AliasedInsp`, depending upon the nature of the parent entity which this attribute is associated with. (RtinspectR#(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytparents cCs |jjS(N(R"t__clause_element__(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt expressionscCs |jjS(N(R"R7(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR7scCs |jjS(shlike __clause_element__(), but called specifically by :class:`.Query` to allow special behavior.(R"t_query_clause_element(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR9sc CsG|j st|j|j|jd|jd|jj|d|S(NR!R"R)(R$tAssertionErrort __class__tentityR R!R"tadapt_to_entity(R(R=((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR=s    cCs4t|j|j|j|jj||jd|S(NR*(RRR R!R"R*R#(R(tcls((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR*s cCs|jj|S(N(R9tlabel(R(tname((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR?scOs||j||S(N(R"(R(toptothertkwargs((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytoperatescKs|||j|S(N(R"(R(RARBRC((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytreverse_operatescCs|jj|d|tk S(Nt optimistic(R!t hasparenttFalse(R(tstateRF((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRGscCs]yt|j|SWnBtk rXtdt|jt|jj||fnXdS(NsFNeither %r object nor %r object associated with %s has an attribute %r(tgetattrR"tAttributeErrorttypet__name__(R(R ((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt __getattr__s  cCsd|jj|jfS(Ns%s.%s(RRMR (R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt__str__scCs |jjS(sReturn the :class:`.MapperProperty` associated with this :class:`.QueryableAttribute`. Return values here will commonly be instances of :class:`.ColumnProperty` or :class:`.RelationshipProperty`. (R"tproperty(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRPs N(RMt __module__t__doc__tTruet is_attributetNoneR-Rtmemoized_propertyR/RR0R3R4R6RPR8R7R9R=R*R?RDRERHRGRNRO(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs,   +         tInstrumentedAttributecBs)eZdZdZdZdZRS(sClass bound instrumented attribute which adds basic :term:`descriptor` methods. See :class:`.QueryableAttribute` for a description of most features. cCs)|jjt|t||ddS(N(R!tsetRRRU(R(R1tvalue((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt__set__scCs#|jjt|t|dS(N(R!tdeleteRR(R(R1((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt __delete__scCs\|dkr|St|}|jr?|j|kr?||jS|jjt||SdS(N(RURR/R R!tgetR(R(R1townertdict_((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt__get__s    (RMRQRRRZR\R`(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRWs  csXdtffdY}tjd|_tj|tddd|S(sCreate an QueryableAttribute / user descriptor hybrid. Returns a new QueryableAttribute type that delegates descriptor behavior and getattr() to the given descriptor. tProxycskeZdZddddZedZejdZdZ dZ dZ fdZ RS( sPresents the :class:`.QueryableAttribute` interface as a proxy on top of a Python descriptor / :class:`.PropComparator` combination. cSsC||_||_||_||_||_||_||_dS(N(RR t descriptortoriginal_propertyt _comparatort_adapt_to_entityRR(R(RR RbR"R=tdocRc((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR-s      cSs |jjS(N(R"RP(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRPscSsOtj|jr$|j|_n|jrH|jj|j|_n|jS(N(RtcallableRdReR=(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR"s   cSs%|j|j|j|j|j|S(N(R;R<R RbRd(R(R=((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR=s  cSs'|dkr|S|jj||SdS(N(RURbR`(R(R1R^((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR`$s cSsd|jj|jfS(Ns%s.%s(RRMR (R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRO*scsyt|SWnjtk r}yt|j|SWq~tk rytdtjt|jj||fq~XnXdS(sNDelegate __getattr__ to the original descriptor and/or comparator.sFNeither %r object nor %r object associated with %s has an attribute %rN(RJRKR"RLRM(R(t attribute(Rb(s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRN-s   N( RMRQRRRUR-RPRRVR"R=R`RORN((Rb(s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRas    R@Rbt from_instance(RRLRMRtmonkeypatch_proxied_specials(RbRa((Rbs_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytcreate_proxied_attributes DtREMOVEtAPPENDtREPLACEtEventcBs;eZdZdZdZdZedZdZ RS(sA token propagated throughout the course of a chain of attribute events. Serves as an indicator of the source of the event and also provides a means of controlling propagation across a chain of attribute operations. The :class:`.Event` object is sent as the ``initiator`` argument when dealing with the :meth:`.AttributeEvents.append`, :meth:`.AttributeEvents.set`, and :meth:`.AttributeEvents.remove` events. The :class:`.Event` object is currently interpreted by the backref event handlers, and is used to control the propagation of operations across two mutually-dependent attributes. .. versionadded:: 0.9.0 cCs%||_||_|jj|_dS(N(R!RAt parent_token(R(tattribute_implRA((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR-ls  cCs |jjS(N(R!R (R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR qscCs|jj|S(N(R!RG(R(RI((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRGusN( RMRQRRRUR!RAR-RPR RG(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRoLs  t AttributeImplcBseZdZeddedeedZdZdZdZ e ee Z edZ dZ dZedZed Zd Zed Zed Zed ZedZededZedZdZRS(s4internal implementation for instrumented attributes.c Ks||_||_||_||_||_| p6||_| |_|dkr`tj |_ n ||_ t ||} x-t j |pgD]}|j| |qW|rt|j_n| |_dS(sConstruct an AttributeImpl. \class_ associated class key string name of the attribute \callable_ optional function which generates a callable based on a parent instance, which produces the "default" values for a scalar or collection attribute when it's first accessed, if not present already. trackparent if True, attempt to track if an instance has a parent attached to it via this attribute. extension a single or list of AttributeExtension object(s) which will receive set/delete/append/remove/etc. events. Deprecated. The event package is now used. compare_function a function that compares two values which are normally assignable to this attribute. active_history indicates that get_history() should always return the "old" value, even if it means executing a lazy callable upon attribute change. parent_token Usually references the MapperProperty, used as a key for the hasparent() function to identify an "owning" attribute. Allows multiple AttributeImpls to all match a single owner attribute. expire_missing if False, don't add an "expiry" callable to this attribute during state.expire_attributes(None), if no value is present for this key. send_modified_events if False, the InstanceState._modified_event method will have no effect; this means the attribute will never show up as changed in a history entry. N(RR t callable_R&t trackparentRptsend_modified_eventsRUtoperatorteqtis_equalRRtto_listt_adapt_listenerRSt_active_historytexpire_missing(R(RR RsR&Rtt extensiontcompare_functiontactive_historyRpR|RuRCtattrtext((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR-}s 5        cCsd|jj|jfS(Ns%s.%s(RRMR (R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyROscCs |jjS(s(Backwards compat for impl.active_history(R&R{(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt_get_active_historyscCs||j_dS(N(R&R{(R(RY((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt_set_active_historyscCs=d}|jst||jjt|j|tk S(s4Return the boolean value of a `hasparent` flag attached to the given state. The `optimistic` flag determines what the default return value should be if no `hasparent` flag can be located. As this function is used to determine if an instance is an *orphan*, instances that were loaded from storage should be assumed to not be orphans, until a True/False value for this flag is set. An instance attribute that is loaded by a callable function will also not have a `hasparent` flag. s6This AttributeImpl is not configured to track parents.(RtR:tparentsR]tidRpRH(R(RIRFtmsg((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRGscCsd}|jst|t|j}|r@||j|W|j|||dS(N( RtRURRRHR&RRR(R(RIR_RYRR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR/s cCs|jrI||k rI|dttfkrI|jt||tqInx2|jjD]$}|||||pt|j }qVW|j ||||jr|dk r|jt||t qn|S(N( RtRUR R RRRHR&RXRRRS(R(RIR_RYRRR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR8s    N(RMRQRRRHRRSRR.RR[RR0RRRURXRR(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs  ! tCollectionAttributeImplcBseZdZeZeZeZeZdeddddZ dZ e dZ edZejdZejdZdZdZd Zd Zd Zd Ze d Ze dZe dZe edZddZdZdZ de dZ!RS(sA collection-holding attribute that instruments changes in membership. Only handles collections of instrumented objects. InstrumentedCollectionAttribute holds an arbitrary, user-specified container object (defaulting to a list) and brokers access to the CollectionAdapter, a "view" onto that object that presents consistent bag semantics to the orm layer independent of the user data implementation. c Ksbtt|j||||d|d|d| | |dkrL|j}n||_||_dS(NRtR}R~(tsuperRR-RUt_CollectionAttributeImpl__copytcopytcollection_factory( R(RR RsR&t typecallableRtR}t copy_functionR~RC((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR-\s    cCs gtj|D] }|^qS(N(Rtcollection_adapter(R(titemty((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt__copymscCs?|j||d|}|tkr(tStj|||SdS(NR2(R]R RRtfrom_collection(R(RIR_R2R((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR0ps c Cs|j|krgS||j}t|d}|j|jkry|j|j}|ttfkryg|D]*}|dk rt|pd|f^qj}g|D]*}|dk rt|pd|f^q}t|} t|} g|D]$\} } | | kr| | f^qg|D]$\} } | | kr| | f^qg|D]$\} } | | krM| | f^qMSng|D]} t| | f^qS(Nt _sa_adapter(R RJRR R RURtdict( R(RIR_R2RRtctcurrent_statestoriginal_statest current_sett original_settsto((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRws" 44  ] cCs t|tS(N(Rot OP_APPEND(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRscCs t|tS(N(RoR(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRscCs}x/|jjD]!}||||p(|j}q W|j||tt|jry|dk ry|jt ||tn|S(N( R&RRRR RSRtRURR(R(RIR_RYRR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytfire_append_events cCs|j||ttdS(N(RR RS(R(RIR_R((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytfire_pre_remove_eventscCs{|jr1|dk r1|jt||tnx-|jjD]}||||pY|jq>W|j||t t dS(N( RtRURRRHR&RRRR RS(R(RIR_RYRR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs cCsV|j|krdS|j||tt|j||j}|j||j=dS(N(R RR RStget_collectionRtclear_with_event(R(RIR_R((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR[s  cCs&|j|\}}|||j<|S(s3Initialize this attribute with an empty collection.(t_initialize_collectionR (R(RIR_t_t user_data((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs cCs|jj|j||jS(N(R+tinitialize_collectionR R(R(RI((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs cCs|j||d|}|tkrs|j||||}|j|ksWtd|j|jj|n|j||dS(NR2s,Collection was loaded during event handling.(RR RR R:t_get_pending_mutationRtappend_with_event(R(RIR_RYRR2R((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs  cCs|j||jd|}|tkrt|j|||||j|ksXtd|j|jj|n|j||dS(NR2s,Collection was loaded during event handling.( RRR RR R:RRtremove_with_event(R(RIR_RYRR2R((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs  cCsAy |j||||d|Wntttfk r<nXdS(NR2(RRRt IndexError(R(RIR_RYRR2((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs cCs|j|||ddS(s*Set a value on the given object. cSs |j|S(N(tadapt_like_to_iterable(tadapterti((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytsN(t _set_iterable(R(RIR_RYRR2R((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRXs c Cs|j|\}}|r3t|||}n t|}|j||dt}|tkrx|j||}n||krdS|j|||tt|d} |||j              c s|dkrdSt|t|}}|jj}|jk rm|j|jk rm|||nI|j|k s|jttfkr|j |||j |dt n|S(NR2( RURRR+R!RpRARRRRR(RIRRRRR(RRpR (s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt)emit_backref_from_collection_append_events"    cs|dk rt|t|}}|jj}|j|k sY|jttfkr|j|||j |dt qndS(NR2( RURRR+R!RARRRRR(RIRRRRR(R (s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt)emit_backref_from_collection_remove_events   RtretvaltrawRXRN(R!RpRtlistenRS(RhR tuselistRRR((RpRhRRR s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytbackref_listenersEs    %    t NO_HISTORYRRt unchangedtdeletedcBseZdZdZeZdZdZdZdZdZ dZ e dZ e d Z e d ZRS( sA 3-tuple of added, unchanged and deleted values, representing the changes which have occurred on an instrumented attribute. The easiest way to get a :class:`.History` object for a particular attribute on an object is to use the :func:`.inspect` function:: from sqlalchemy import inspect hist = inspect(myobject).attrs.myattribute.history Each tuple member is an iterable sequence: * ``added`` - the collection of items added to the attribute (the first tuple element). * ``unchanged`` - the collection of items that have not changed on the attribute (the second tuple element). * ``deleted`` - the collection of items that have been removed from the attribute (the third tuple element). cCs |tkS(N(R(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt__bool__scCs t|jp|jp|j S(shReturn True if this :class:`.History` has no changes and no existing, unchanged state. (tboolRRR(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytemptyscCs'|jp g|jpg|jp%gS(s3Return a collection of added + unchanged + deleted.(RRR(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytsumscCs|jp g|jpgS(s)Return a collection of added + unchanged.(RR(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt non_deleteds cCs|jp g|jpgS(s+Return a collection of unchanged + deleted.(RR(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt non_addeds cCst|jp|jS(s2Return True if this :class:`.History` has changes.(RRR(R(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt has_changesscCstg|jD]$}|dk r+t|p.d^q g|jD]$}|dk r\t|p_d^q>g|jD]$}|dk rt|pd^qoS(N(RRRURRR(R(R((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytas_states..cCs|jj|jt}|tkrV|tkr@|dddS|d|gdSn~|j||tkr|d|gdSt|tkrd}n |g}|tkr|d d |S||gd |SdS( N(((((((((((( RR]R t _NO_HISTORYR RxRSRt_NO_STATE_SYMBOLS(R>RhRIRRR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs     cCs|jj|jt}|tkrb|tks<|tkrL|dddS|d|gdSn||kr|d|gdSt|tks|dkrd}n |g}|tks|tkr|d d |S||gd |SdS( N(((((((((((( RR]R R R R RR RU(R>RhRIRRR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR#s    c Cs|jj|jt}|tks0|tkr@|dddSt|d}|ttfkrw|t|ddS|tkr|dt|dSg|D]*}|dk rt |pd|f^q}g|D]*}|dk rt |pd|f^q}t |}t |} |g|D]\} } | | kr)| ^q)g|D]\} } | | krQ| ^qQg|D]\} } | |kry| ^qySdS( NR(((((((( RR]R R R R RJRRURR( R>RhRIRRRRRRRRR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR=s$ 44  (((RMRQRRRt __nonzero__RRRRR R t classmethodRRR(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs      cCsZ|tkr"tjdt}n"|tkrDtjdt}ntt|||S(sReturn a :class:`.History` record for the given object and attribute key. :param obj: an object whose class is instrumented by the attributes package. :param key: string attribute name. :param passive: indicates loading behavior for the attribute if the value is not already present. This is a bitflag attribute, which defaults to the symbol :attr:`.PASSIVE_OFF` indicating all necessary SQL should be emitted. sNPassing True for 'passive' is deprecated. Use attributes.PASSIVE_NO_INITIALIZEsFPassing False for 'passive' is deprecated. Use attributes.PASSIVE_OFF(RSRtwarn_deprecatedRRHRtget_state_historyR(RR R2((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR0`s      cCs|j||S(N(R0(RIR R2((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR|scCs+t|}t|}|j|||S(tTODO(RRt has_parent(R>RR RFR+RI((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs  cKse|jdd}|jdd}|jdd}t||||d|}t||||S(NR"R)Rf(RRUtregister_descriptortregister_attribute_impl(RR tkwR"R)Rftdesc((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytregister_attributes c Kst|}|r?|jdd} |j|| p6t} n|jdd} ||j} |r|||| | |} n`|rt|||| d| |} n9|rt|||| |} nt|||| |} | ||_ |r t ||||n|j |||S(NR( RRRUtinstrument_collection_classRR&RRRR!Rtpost_configure_attribute( RR RRst useobjectt impl_classtbackrefRR+tfactoryRR&R!((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs*     cCsDt|}t||d|d|}||_|j|||S(NR"R)(RRWRRtinstrument_attribute(RR R"R)RfR+Rb((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRs    cCst|j|dS(N(Rtuninstrument_attribute(RR ((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytunregister_attributescCs%t|}|j}t|||S(saInitialize a collection attribute and return the collection adapter. This function is used to provide direct access to collection internals for a previously unloaded attribute. e.g.:: collection_adapter = init_collection(someobject, 'elements') for elem in values: collection_adapter.append_without_event(elem) For an easier way to do the above, see :func:`~sqlalchemy.orm.attributes.set_committed_value`. obj is an instrumented object instance. An InstanceState is accepted directly for backwards compatibility but this usage is deprecated. (RRtinit_state_collection(RR RIR_((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pytinit_collections  cCs5|j|j}|j||}|j|||S(sDInitialize a collection attribute and return the collection adapter.(R+R!RR(RIR_R RR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyR!scCs:t|t|}}|j|jj|||dS(s[Set the value of an attribute with no history events. Cancels any previous history present. The value should be a scalar value for scalar-holding attributes, or an iterable for any collection-holding attribute. This is the same underlying method used when a lazy loader fires off and loads additional data from the database. In particular, this method can be used by application code which has loaded additional attributes or collections through separate queries, which can then be attached to an instance as though it were part of its original loaded state. N(RRR+R!R(R1R RYRIR_((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyRscCs=t|t|}}|j|jj|||ddS(sNSet the value of an attribute, firing history events. This function may be used regardless of instrumentation applied directly to the class, i.e. no descriptors are required. Custom attribute management schemes will need to make usage of this method to establish attribute state as understood by SQLAlchemy. N(RRR+R!RXRU(R1R RYRIR_((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt set_attributes cCs3t|t|}}|j|jj||S(sZGet the value of an attribute, firing any callables required. This function may be used regardless of instrumentation applied directly to the class, i.e. no descriptors are required. Custom attribute management schemes will need to make usage of this method to make usage of attribute state as understood by SQLAlchemy. (RRR+R!R](R1R RIR_((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt get_attributes cCs7t|t|}}|j|jj||dS(sQDelete the value of an attribute, firing history events. This function may be used regardless of instrumentation applied directly to the class, i.e. no descriptors are required. Custom attribute management schemes will need to make usage of this method to establish attribute state as understood by SQLAlchemy. N(RRR+R!R[(R1R RIR_((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt del_attributes cCsFt|t|}}|j|j}|j||tdtdS(sMark an attribute on an instance as 'modified'. This sets the 'modified' flag on the instance and establishes an unconditional change event for the given attribute. tforceN(RRR+R!RR RS(R1R RIR_R!((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyt flag_modified!s(LRRRvtRRRRRRRR,RRRR R R R R RRRRRRRRRRRRRRRRt_self_inspectst_MappedAttributet_InspectionAttrtPropComparatorRRWRktsymbolRRRtobjectRoRrRRRRR t frozensetRR t namedtupleRRURR0RRHRRRRR R"R!RR#R$R%R'(((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/attributes.pyts` |  U-Jw j