³ò Je|Mc@s dZddkZddkZddkZddkZddkZddklZddkl Z yddkl Z Wn#e j oddkl Z nXe d„Z e d„Zd„Zd „Zd efd „ƒYZd e fd „ƒYZdefd„ƒYZdS(sUtility functions used by various web helpers. This module contains support functions used by other helpers, and functions for URL manipulation. Most of these helpers predate the 0.6 reorganization; they would have been put in other subpackages if they have been created later. iÿÿÿÿN(t DictMixin(t XMLGenerator(tparse_qsc Ksti|ƒ\}}d|jo(|iddƒ\}}t|ƒ}nh}xM|iƒD]?\}}|dj o|||>> update_params("foo", new1="NEW1") 'foo?new1=NEW1' >>> update_params("foo?p=1", p="2") 'foo?p=2' >>> update_params("foo?p=1", p=None) 'foo' >>> update_params("http://example.com/foo?new1=OLD1#myfrag", new1="NEW1") 'http://example.com/foo?new1=NEW1#myfrag' >>> update_params("http://example.com/foo?new1=OLD1#myfrag", new1="NEW1", _debug=True) ('http://example.com/foo', {'new1': 'NEW1'}, 'myfrag') >>> update_params("http://www.mau.de?foo=2", brrr=3) 'http://www.mau.de?foo=2&brrr=3' >>> update_params("http://www.mau.de?foo=A&foo=B", foo=["C", "D"]) 'http://www.mau.de?foo=C&foo=D' t?it#s%s%s%sN( turlparset urldefragtsplitRt iteritemstNoneturllibt urlencodetTrue( t_urlt_debugtparamsturltfragmenttqstquerytkeytvalue((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyt update_paramss&#    cCsœd|jo|iddƒ}nd|jo|iddƒ}nd|jo|iddƒ}n|o(|iddƒ}|id d ƒ}n|S( sÀReplace special characters '&', '<' and '>' by SGML entities. This is a slightly more efficient version of the cgi.escape by using 'in' membership to test if the replace is needed. This function returns a plain string. Programs using the HTML builder should call ``webhelpers.html.builder.escape()`` instead of this to prevent double-escaping. Changed in WebHelpers 1.2: escape single-quote as well as double-quote. t&s&ts>t"s"t's'(treplace(tstquote((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyt cgi_escapeLs   cCsŽ|djodSnt|tƒp0t|dƒot|ƒ}qUt|ƒ}nt|tƒ}t|tƒo|iddƒ}n|S(sÚHTML-escape a string or object. This converts any non-string objects passed into it to strings (actually, using ``unicode()``). All values returned are non-unicode strings (using ``&#num;`` entities for all non-ASCII characters). None is treated specially, and returns the empty string. This function returns a plain string. Programs using the HTML builder should wrap the result in ``literal()`` to prevent double-escaping. tt __unicode__tasciitxmlcharrefreplaceN( R t isinstancet basestringthasattrtunicodetstrRR tencode(R((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyt html_escapeds cCs(|djo|Snti|ddƒS(s Convert an IRI portion to a URI portion suitable for inclusion in a URL. (An IRI is an Internationalized Resource Identifier.) This is the algorithm from section 3.1 of RFC 3987. However, since we are assuming input is either UTF-8 or unicode already, we can simplify things a little from the full method. Returns an ASCII string containing the encoded result. tsafes/#%[]=:;$&()+,!?N(R R R(tiri((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyt iri_to_uris tPartialcBs eZdZd„Zd„ZRS(so A partial function object. Equivalent to functools.partial, which was introduced in Python 2.5. cOs3|d}|d|d||_|_|_dS(Niii(tfntargstkw(R0R1tself((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyt__init__Ÿs cOsX|o*|io |iiƒ}|i|ƒn|p|i}|i|i||ŽS(N(R1tcopytupdateR/R0(R2R0R1td((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyt__call__£s (t__name__t __module__t__doc__R3R7(((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyR.–s tSimplerXMLGeneratorcBseZdZddd„ZRS(s(A subclass of Python's SAX XMLGenerator.cCsV|djo h}n|i||ƒ|dj o|i|ƒn|i|ƒdS(s Add an element with no children.N(R t startElementt characterst endElement(R2tnametcontentstattrs((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pytaddQuickElement°s    N(R8R9R:R RB(((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyR;«stUnicodeMultiDictcBs eZdZddded„Zd„Zd„Zd„Zd„Z d„Z d„Z d „Z d „Z d „Zd „Zd „ZeZd„Zd„Zdd„Zd„Zd„Zd„Zd„Zd„Zd„ZeZd„Zd„Zd„Zd„ZRS(s' A MultiDict wrapper that decodes returned values to unicode on the fly. Decoding is not applied to assigned values. The key/value contents are assumed to be ``str``/``strs`` or ``str``/``FieldStorages`` (as is returned by the :func:`paste.request.parse` functions). Can optionally also decode keys when the ``decode_keys`` argument is True. ``FieldStorage`` instances are cloned, and the clone's ``filename`` variable is decoded. Its ``name`` variable is decoded when ``decode_keys`` is enabled. tstrictcCsE||_|djotiƒ}n||_||_||_dS(N(tmultiR tsystgetdefaultencodingtencodingterrorst decode_keys(R2RERHRIRJ((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyR3Ís     cCs*|io|i|i|iƒ}n|S(N(RJtdecodeRHRI(R2R((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyt _decode_keyÖs cCs¦t|tiƒo]ti|ƒ}|io"|ii|i|iƒ|_n|i i|i|iƒ|_ n3y|i|i|iƒ}Wnt j onX|S(s  Decode the specified (``str`` or `FieldStorage``) value to unicode. ``FieldStorage`` objects are specially handled. ( R$tcgit FieldStorageR4RJR?RKRHRItfilenametAttributeError(R2R((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyt _decode_valueÛs ""cCs|i|ii|ƒƒS(N(RQREt __getitem__(R2R((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRRïscCs|ii||ƒdS(N(REt __setitem__(R2RR((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRSòscCs|ii||ƒdS(s:Add the key and value, not overwriting any previous value.N(REtadd(R2RR((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRTõscCs4g}|ii|ƒD]}||i|ƒq~S(sBReturn list of all values matching the key (may be an empty list).(REtgetallRQ(R2Rt_[1]tv((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRUùscCs|i|ii|ƒƒS(sCReturn one value matching key. Raise KeyError if multiple matches.(RQREtgetone(R2R((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRXýscCsh}xƒ|iiƒiƒD]l\}}t|tƒo.g}|D]}||i|ƒqC~}n|i|ƒ}|||i|ƒsccs,x%|iiƒD]}|i|ƒVqWdS(N(RERkRL(R2Re((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRkAscCsFg}|iiƒD]+\}}||i|ƒ|i|ƒfq~S(N(RERRLRQ(R2RVReRW((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRgGsccsAx:|iiƒD])\}}|i|ƒ|i|ƒfVqWdS(N(RERRLRQ(R2ReRW((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRKs cCs1g}|iiƒD]}||i|ƒq~S(N(REt itervaluesRQ(R2RVRW((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pytvaluesOsccs,x%|iiƒD]}|i|ƒVqWdS(N(RERmRQ(R2RW((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRmRsN( R8R9R:R tFalseR3RLRQRRRSRTRURXRYR\R^R_thas_keyR`R4RaRcRdRiRjRlRkt__iter__RgRRnRm(((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyRC¹s:                         (R:RMR4RFR RtUserDictRtxml.sax.saxutilsRRt ImportErrorRoRRR*R-tobjectR.R;RC(((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/util.pyss$      7