Ρς Α£vLc@s‘defd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd „ƒYZd „Zd efd „ƒYZd S(tValuecBsqeZdZd Zd„Zd„Zd d„Zd„Zd„Z d„Z d„Z d„Z d „Z d „ZRS( sJPython descriptor for marshalling GET/POST state into Python variables and back. The descriptor is given a name (see __init__) which it uses to read its state from a dictionary (containing GET/POST variables). The descriptor stores its state within the object from which it is invoked using its own name prefix with an underscore (so if x is a descripor in class Foo, and foo is an instance of Foo, then the actual value of x is stored in foo._x). If its state is missing from its host object (i.e. if _x is not an attribute of foo), the descriptor will return its default value (so foo.x will give a default value). This is a base class which will marshal strings from and to a GET/POST dictionary. How-To Guide for descriptors: http://users.rcn.com/python/download/Descriptor.htm cCs ||_dS(N(tvar_name(tselfR((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyt__init__,scCs d|iS(sžReturn the name that we'll use to store this descriptor's data under in its host object. A decriptor foo will have its data stored under _foo.t_(R(R((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyt _member_name/scCst||iƒ|iƒS(N(tgetattrRt default_value(Rtobjttype((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyt__get__5scCst||iƒ|ƒdS(N(tsetattrR(RRtvalue((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyt__set__8scCst||iƒƒdS(N(tdelattrR(RR((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyt __delete__;scCs=|i|ƒ}||ijo|i|ƒ||iscCs>y$|i||i||iƒƒWntj onXdS(s‹Read the value of this descriptor from the GET/POST dictionary C{params}, decode it and use it to set the descriptor value.N(R t_decodeRtKeyError(RRtparams((s2/var/www/Pootle/local_apps/pootle_app/url_state.pytread_from_paramsFs$cCs|S(N((RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyROscCs|S(N((RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRRscCs d|iS(Ns Value<%s>(R(R((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyt__repr__UsN(t__name__t __module__t__doc__tNoneRRRR R RRRRRR(((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRs        t BooleanValuecBs eZeZd„Zd„ZRS(cCs|djotStSdS(NtTrue(RtFalse(RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR[s cCs|odSdSdS(NRR((RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRas(RRRRRR(((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRXs tIntValuecBs)eZdZd„Zd„Zd„ZRS(s Read a GET/POST variable into an integer. The descriptor's default value is supplied when initializing an IntValue. This value is used when the descriptor has no state stored in its host object or when the GET/POST variable doesn't decode to an integer. >>> class Foo(object): ... bar = IntValue('bar', 1) >>> foo = Foo() >>> foo.bar 1 >>> foo.__class__.bar._decode('10') 10 >>> foo.__class__.bar._decode('a') 1 >>> foo.__class__.bar._encode(20) '20' >>> foo.__class__.bar.read_from_params(foo, {'bar': '5'}) >>> foo.bar 5 >>> get_vars = {} >>> foo.__class__.bar.add_to_dict(foo, get_vars) >>> get_vars {'bar': '5'} cCs#tt|ƒi|ƒ||_dS(N(tsuperRRR(RRR((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR€scCs,yt|ƒSWntj o |iSXdS(N(tintt ValueErrorR(RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR„scCs!t|tƒpt‚t|ƒS(N(t isinstanceR!tAssertionErrortstr(RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRŠs(RRRRRR(((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRgs  t ChoiceValuecBs)eZdZd„Zd„Zd„ZRS(sΞRead a string GET/POST variable ensuring that it matches one of the choices specified when constructing this object. If not, set this descriptor value to the first choice. >>> class Foo(object): ... bar = ChoiceValue('bar', ('chocolate', 'strawberry', 'caramel')) >>> foo = Foo() >>> foo.__class__.bar._decode('strawberry') 'strawberry' >>> foo.__class__.bar._decode('banana') 'chocolate' cCs0tt|ƒi|ƒ|d|_||_dS(Ni(R R&RRt_choices(RRtchoices((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRœs cCs ||ijo|S|iSdS(N(R'R(RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR‘scCs ||ijo|S|iSdS(N(R'R(RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR§s(RRRRRR(((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR&Žs   t ListValuecBs&eZdZgZd„Zd„ZRS(s0Read a comma separated GET/POST variable into a Python list of strings. >>> class Foo(object): ... bar = ListValue('bar') >>> foo = Foo() >>> foo.__class__.bar._decode('a,b,c') ['a', 'b', 'c'] >>> foo.__class__.bar._encode(['a', 'b', 'c']) 'a,b,c' >>> foo.__class__.bar.read_from_params(foo, {'bar': 'x,y,z'}) >>> foo.bar ['x', 'y', 'z'] >>> get_vars = {} >>> foo.__class__.bar.add_to_dict(foo, get_vars) >>> get_vars {'bar': 'x,y,z'} cCs#|djogS|idƒSdS(Ntt,(R*N(Rtsplit(RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRΒs cCsdid„|DƒƒS(NR+cssx|]}t|ƒVqWdS(N(R%(t.0titem((s2/var/www/Pootle/local_apps/pootle_app/url_state.pys Ιs (tjoin(RR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRΘs(RRRRRR(((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR)­s cCshxA|iD]6}||jo#|i|ƒt|||ƒ}q q W|id„|iiƒDƒƒ|S(s™Enumerate a class and all its subclasses in a depth-first post order traversal and collect all the Python descriptors into the list 'descriptors'css-x&|]}t|tƒo |VqqWdS(N(R#R(R-t descriptor((s2/var/www/Pootle/local_apps/pootle_app/url_state.pys Σs (t __bases__taddtget_descriptorstextendt__dict__t itervalues(tclst descriptorstvisitedtbase((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR3Λs    tStatecBs5eZdZd„Zd„Zhd„Zd„ZRS(sΔBase class for classes which, using any of the *Value classes as descriptors, will read GET or POST variables intelligently. To see an example implementation, look for TranslatePageState.cCst|igtƒƒS(sΙReturn a list of all the *Value descriptors (all defined above) that are defined in the class of the current object as well as its superclasses. Thus, if we have the following subclass: >>> class FooState(State): ... bar = IntValue('bar', 0) ... baz = ListValue('baz') >>> state = FooState() >>> sorted(state.get_descriptors()) ['bar', 'baz'] (R3t __class__tset(R((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR3έsccs5x.|iƒD] }|it||iƒfVq WdS(s‘Iterate through all the *Value descriptors returning (descriptor name, descriptor value) pairs. >>> class FooState(State): ... bar = IntValue('bar', 0) ... baz = ListValue('baz') >>> state = FooState(bar=1, baz=['a', 'b', 'c']) >>> sorted(list(state.iter_items())) [('bar', 1), ('baz', ['a', 'b', 'c'])] N(R3RR(Rtmember((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyt iter_itemsνs cKsXx$|iƒD]}|i||ƒq Wx*|iƒD]\}}t|||ƒq4WdS(sInitialize a state object possibly reading initial state from C{data} (which is in raw text) and overriding those values with the keyword parameters C{initial} (these parameters are not raw, so for an IntValue, you'd pass an integer). N(R3Rt iteritemsR (RtdatatinitialR>tkeyR ((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyRόs   cCs1h}x$|iƒD]}|i||ƒqW|S(sMEncode all the state members in this object to a GET/POST dictionary.(R3R(RtresultR>((s2/var/www/Pootle/local_apps/pootle_app/url_state.pytencodes  (RRRR3R?RRE(((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyR;Χs    N(tobjectRRRR&R)R3R;(((s2/var/www/Pootle/local_apps/pootle_app/url_state.pyts B'