ó U&^Kc@sÍdZddlmZeeƒZdefd„ƒYZdefd„ƒYZdefd„ƒYZd fd „ƒYZ d fd „ƒYZ d efd„ƒYZ defd„ƒYZ dfd„ƒYZ dS(s Properties classes. iÿÿÿÿ(t getLoggert AutoLinkercBseZdZd„ZRS(s¢ Base class, provides interface for I{automatic} link management between a L{Properties} object and the L{Properties} contained within I{values}. cCsdS(sÞ Notification that a values was updated and the linkage between the I{properties} contained with I{prev} need to be relinked to the L{Properties} contained within the I{next} value. N((tselft propertiestprevtnext((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pytupdated s(t__name__t __module__t__doc__R(((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRstLinkcBs)eZdZd„Zd„Zd„ZRS(s| Property link object. @ivar endpoints: A tuple of the (2) endpoints of the link. @type endpoints: tuple(2) cCsat||ƒ}t||ƒ}||f|_|j||ƒ|jj|ƒ|jj|ƒdS(s“ @param a: Property (A) to link. @type a: L{Property} @param b: Property (B) to link. @type b: L{Property} N(tEndpointt endpointstvalidatetlinkstappend(RtatbtpAtpB((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt__init__0s c Cs||jks||jkr*td‚n|jƒ}|jƒ}x*|D]"}||krItd|‚qIqIWx*|D]"}||krvtd|‚qvqvW|jƒ}|jƒ}x*|D]"}||kr»td|‚q»q»Wx*|D]"}||krètd|‚qèqèW|S(sý Validate that the two properties may be linked. @param pA: Endpoint (A) to link. @type pA: L{Endpoint} @param pB: Endpoint (B) to link. @type pB: L{Endpoint} @return: self @rtype: L{Link} sAlready linkedsDuplicate domain "%s" foundsDuplicate key %s found(Rt Exceptiontdomainstkeys( RRRtdAtdBtdtkAtkBtk((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR >s(              cCsW|j\}}||jkr1|jj|ƒn||jkrS|jj|ƒn|S(s‘ Teardown the link. Removes endpoints from properties I{links} collection. @return: self @rtype: L{Link} (R Rtremove(RRR((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pytteardown]s (RRR RR R(((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR *s  R cBs;eZdZd„Zd„Zd„Zd„Zd„ZRS(s¦ Link endpoint (wrapper). @ivar link: The associated link. @type link: L{Link} @ivar target: The properties object. @type target: L{Property} cCs||_||_dS(N(tlinkttarget(RR R!((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRts cCs |jjƒS(N(R R(R((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRxscCs |j|kS(N(R!(Rtrhs((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt__eq__{scCs t|jƒS(N(thashR!(R((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt__hash__~scCst|j|ƒS(N(tgetattrR!(Rtname((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt __getattr__s(RRR RRR#R%R((((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR ls     t DefinitioncBsDeZdZeƒd„Zdd„Zd„Zd„Zd„Z RS(sà Property definition. @ivar name: The property name. @type name: str @ivar classes: The (class) list of permitted values @type classes: tuple @ivar default: The default value. @ivar type: any cCsIt|ttfƒs!|f}n||_||_||_||_dS(sé @param name: The property name. @type name: str @param classes: The (class) list of permitted values @type classes: tuple @param default: The default value. @type default: any N(t isinstancetlistttupleR'tclassestdefaulttlinker(RR'R-R.R/((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRs     cCs|dkr|jS|SdS(så Convert the I{value} into the default when I{None}. @param value: The proposed value. @type value: any @return: The I{default} when I{value} is I{None}, else I{value}. @rtype: any N(tNoneR.(Rtvalue((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pytnvlŸs cCsX|dkrdSt|jƒrTt||jƒ rTd|j|jf}t|‚ndS(s¿ Validate the I{value} is of the correct class. @param value: The value to validate. @type value: any @raise AttributeError: When I{value} is invalid. Ns"%s" must be: %s(R0tlenR-R*R'tAttributeError(RR1tmsg((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR ¬s  cCsd|jt|ƒfS(Ns%s: %s(R'tstr(R((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt__repr__»scCsfg}t|jƒr2|jdt|jƒƒn |jdƒ|jdt|jƒƒdj|ƒS(Ns classes=%ss classes=*s default=%ss, (R3R-RR6R.tjoin(Rts((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt__str__¾s  N( RRR RRR0R2R R7R:(((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR)…s    t PropertiescBsÂeZdZd„Zd„Zd„Zd„Zd„Zd„Zd„Z d„Z d „Z dd „Z dd „Zdd „Zd „Zd„Zd„Zd„Zd„Zd„Zd„ZRS(sö Represents basic application properties. Provides basic type validation, default values and link/synchronization behavior. @ivar domain: The domain name. @type domain: str @ivar definitions: A table of property definitions. @type definitions: {name: L{Definition}} @ivar links: A list of linked property objects used to create a network of properties. @type links: [L{Property},..] @ivar defined: A dict of property values. @type defined: dict cCsli|_x|D]}||j|jtitemsR?(Rtothertntv((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRBøs  cCs|j|ƒj|ƒdS(sà Get whether a property has never been set by I{name}. @param name: A property name. @type name: str @return: True if never been set. @rtype: bool N(tprovidert_Properties__notset(RR'((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pytnotsetscCs|j|ƒj||ƒ|S(sc Set the I{value} of a property by I{name}. The value is validated against the definition and set to the default when I{value} is None. @param name: The property name. @type name: str @param value: The new property value. @type value: any @return: self @rtype: L{Properties} (RJt_Properties__set(RR'R1((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR?s cCs|j|ƒj|dƒ|S(s  Unset a property by I{name}. @param name: A property name. @type name: str @return: self @rtype: L{Properties} N(RJRMR0(RR'((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pytunsetscGs|j|ƒj||ŒS(s: Get the value of a property by I{name}. @param name: The property name. @type name: str @param df: An optional value to be returned when the value is not set @type df: [1]. @return: The stored value, or I{df[0]} if not set. @rtype: any (RJt_Properties__get(RR'tdf((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRD*s cCst||ƒ|S(s Link (associate) this object with anI{other} properties object to create a network of properties. Links are bidirectional. @param other: The object to link. @type other: L{Properties} @return: self @rtype: L{Properties} (R (RRG((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR 7s cGsKt|ƒs|j}nx+|jD]}||kr$|jƒq$q$W|S(sö Unlink (disassociate) the specified properties object. @param others: The list object to unlink. Unspecified means unlink all. @type others: [L{Properties},..] @return: self @rtype: L{Properties} (R3RR(Rtotherstp((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pytunlinkCs    cCsž|dkrg}n|j|ƒ||jkr5|SxE|jD]:}||krWq?n|j||ƒ}|dk r?|Sq?W|j|ƒt|ƒršdS|S(s• Find the provider of the property by I{name}. @param name: The property name. @type name: str @param history: A history of nodes checked to prevent circular hunting. @type history: [L{Properties},..] @return: The provider when found. Otherwise, None (when nested) and I{self} when not nested. @rtype: L{Properties} N(R0RR<RRJRR3(RR'thistorytxRJ((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRJRs       cCsŽ|dkrg}n|j|ƒtƒ}|j|jjƒƒx9|jD].}||krcqKn|j|j|ƒƒqKW|j|ƒ|S(sü Get the set of I{all} property names. @param history: A history of nodes checked to prevent circular hunting. @type history: [L{Properties},..] @return: A set of property names. @rtype: list N(R0RR?RBR<RRR(RRTRRU((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRns      cCsˆ|dkrg}n|j|ƒtƒ}|j|jƒx9|jD].}||kr]qEn|j|j|ƒƒqEW|j|ƒ|S(sø Get the set of I{all} domain names. @param history: A history of nodes checked to prevent circular hunting. @type history: [L{Properties},..] @return: A set of domain names. @rtype: list N( R0RR?taddR=RRBRR(RRTRRU((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRƒs      cCs1x*|jjƒD]}|j|j|jR'(RR((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRA˜scCs ||jkS(N(R@(RR'((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt__notset£scCso|j|ƒ}|j|ƒ|j|ƒ}|j|}||j|<|jj|ƒ|jj|||ƒdS(N(RER R2R>R@RVR/R(RR'R1RR((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt__set¦s   cGsM|j|ƒ}|jj|ƒ}||jkrIt|ƒrI|d}n|S(Ni(RER>RDR.R3(RR'RPRR1((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyt__get¯s  cCsïg}|jdƒx.|jjƒD]}|jdt|ƒƒq#W|jdƒx.|jjƒD]}|jdt|ƒƒqaW||krâ|j|ƒ|jdƒx'|jD]}|j|j|ƒƒq²W|j|ƒndj |ƒS(Ns Definitions:s %ssContent:sLinked:s ( RR<RWtreprR>RFR6RRR8(RRTR9RRU((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR6¶s     cCs t|ƒS(N(R6(R((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR7ÆscCs |jgƒS(N(R6(R((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR:ÉsN(RRR RRERBRLR?RNRDR RSR0RJRRRARKRMROR6R7R:(((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyR;Ès(            tSkincBs;eZdZd„Zd„Zd„Zd„Zd„ZRS(s The meta-programming I{skin} around the L{Properties} object. @ivar __pts__: The wrapped object. @type __pts__: L{Properties}. cCst|||ƒ|_dS(N(R;t__pts__(RR=R<RC((sI/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/suds/properties.pyRÓscCsL|jdƒo|jdƒ}|r5||j|s BCÿ