Ñò
<0¯Hc @ sº d Z d d k Z d d k Z d d k Z d d k Z d d k l Z d d k l Z e d „ Z
d „ Z d „ Z d e
f d „ ƒ YZ d
e f d „ ƒ YZ d e f d
„ ƒ YZ d S( su Utility functions used by various web helpers
This module is such a mess that no new helpers should be added to it.
iÿÿÿÿN( t DictMixin( t XMLGeneratorc C sŠ d | j o | i d d ƒ } n d | j o | i d d ƒ } n d | j o | i d d ƒ } n | o | i d 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.
t &s &t s >t "s "( t replace( t st quote( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyt
cgi_escape s
c C s‹ | d j o d St | t ƒ p0 t | d ƒ o t | ƒ } qR t | ƒ } n t | t ƒ } t | t ƒ o | i d d ƒ } n | S( sG 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.
t t __unicode__t asciit xmlcharrefreplaceN( t Nonet
isinstancet
basestringt hasattrt unicodet strR t Truet encode( R ( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyt html_escape s
c C s% | d j o | St i | d d ƒ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.
t safes /#%[]=:;$&()+,!?N( R t urllibR ( t iri( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyt
iri_to_uri5 s
t Partialc B s e Z d Z d „ Z d „ Z RS( s+ Partial object, which will be in Python 2.5c O s3 | d } | d | d | | _ | _ | _ d S( Ni i i ( t fnt argst kw( R R t self( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyt __init__N s
c O sX | o* | i o | i i ƒ } | i | ƒ n | p | i } | i | i | | Ž S( N( R t copyt updateR R ( R R R t d( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyt __call__R s
( t __name__t
__module__t __doc__R R$ ( ( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyR J s t SimplerXMLGeneratorc B s e Z d d d „ Z RS( c C sV | d j o
h } n | i | | ƒ | d j o | i | ƒ n | i | ƒ d S( s Add an element with no children.N( R t startElementt
characterst
endElement( R t namet contentst attrs( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyt addQuickElement[ s
N( R% R& R R/ ( ( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyR( Z s t UnicodeMultiDictc B s
e Z d Z d d d e d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z
d „ Z d „ Z d
„ Z
d „ Z d „ Z d
„ Z e Z d „ Z d „ Z d d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z e Z d „ Z d „ Z d „ Z d „ Z RS( 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.
t strictc C sE | | _ | d j o t i ƒ } n | | _ | | _ | | _ d S( N( t multiR t syst getdefaultencodingt encodingt errorst decode_keys( R R2 R5 R6 R7 ( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyR x s
c C s* | i o | i | i | i ƒ } n | S( N( R7 t decodeR5 R6 ( R t key( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyt _decode_key s
c C s¦ t | t i ƒ o] t i | ƒ } | i o" | i i | i | i ƒ | _ n | i i | i | i ƒ | _ n3 y | i | i | i ƒ } Wn t
j
o n X| S( s
Decode the specified (``str`` or `FieldStorage``) value to unicode.
``FieldStorage`` objects are specially handled.
( R t cgit FieldStorageR! R7 R, R8 R5 R6 t filenamet AttributeError( R t value( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyt
_decode_value† s
"" c C s | i | i i | ƒ ƒ S( N( R@ R2 t __getitem__( R R9 ( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyRA š s c C s | i i | | ƒ d S( N( R2 t __setitem__( R R9 R? ( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyRB s c C s | i i | | ƒ d S( s: Add the key and value, not overwriting any previous value.N( R2 t add( R R9 R? ( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyRC s c C s4 g } | i i | ƒ D] } | | i | ƒ q ~ S( sB Return list of all values matching the key (may be an empty list).( R2 t getallR@ ( R R9 t _[1]t v( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyRD ¤ s c C s | i | i i | ƒ ƒ S( sC Return one value matching key. Raise KeyError if multiple matches.( R@ R2 t getone( R R9 ( ( s3 /usr/lib/python2.6/site-packages/webhelpers/util.pyRG ¨ s c C s h } xƒ | i i ƒ i ƒ D]l \ } } t | t ƒ o. g } | D] } | | i | ƒ qC ~ } n | i | ƒ } | | | i | ƒ s