Source code for pyramid.encode
from pyramid.compat import (
text_type,
binary_type,
is_nonstr_iter,
url_quote as _url_quote,
url_quote_plus as _quote_plus,
)
def url_quote(val, safe=''): # bw compat api
cls = val.__class__
if cls is text_type:
val = val.encode('utf-8')
elif cls is not binary_type:
val = str(val).encode('utf-8')
return _url_quote(val, safe=safe)
[docs]def urlencode(query, doseq=True):
"""
An alternate implementation of Python's stdlib `urllib.urlencode
function <http://docs.python.org/library/urllib.html>`_ which
accepts unicode keys and values within the ``query``
dict/sequence; all Unicode keys and values are first converted to
UTF-8 before being used to compose the query string.
The value of ``query`` must be a sequence of two-tuples
representing key/value pairs *or* an object (often a dictionary)
with an ``.items()`` method that returns a sequence of two-tuples
representing key/value pairs.
For minimal calling convention backwards compatibility, this
version of urlencode accepts *but ignores* a second argument
conventionally named ``doseq``. The Python stdlib version behaves
differently when ``doseq`` is False and when a sequence is
presented as one of the values. This version always behaves in
the ``doseq=True`` mode, no matter what the value of the second
argument.
See the Python stdlib documentation for ``urllib.urlencode`` for
more information.
.. versionchanged:: 1.5
In a key/value pair, if the value is ``None`` then it will be
dropped from the resulting output.
"""
try:
# presumed to be a dictionary
query = query.items()
except AttributeError:
pass
result = ''
prefix = ''
for (k, v) in query:
k = quote_plus(k)
if is_nonstr_iter(v):
for x in v:
x = quote_plus(x)
result += '%s%s=%s' % (prefix, k, x)
prefix = '&'
elif v is None:
result += '%s%s=' % (prefix, k)
else:
v = quote_plus(v)
result += '%s%s=%s' % (prefix, k, v)
prefix = '&'
return result
# bw compat api (dnr)
def quote_plus(val, safe=''):
cls = val.__class__
if cls is text_type:
val = val.encode('utf-8')
elif cls is not binary_type:
val = str(val).encode('utf-8')
return _quote_plus(val, safe=safe)