3
�P\� � @ sD d Z ddlmZ ddlmZ d
Zdd� Zdd� Zdd � Zd
d � Zd S )z8Implementation of nested form-data encoding function(s).� )�
basestring)� urlencoder c sd t ttf� t| �}tdd� |D ��s,td��|}x"t� fdd�|D ��rRt|�}q2W t|f|�|�S )aT Handle nested form-data queries and serialize them appropriately.
There are times when a website expects a nested form data query to be sent
but, the standard library's urlencode function does not appropriately
handle the nested structures. In that case, you need this function which
will flatten the structure first and then properly encode it for you.
When using this to send data in the body of a request, make sure you
specify the appropriate Content-Type header for the request.
.. code-block:: python
import requests
from requests_toolbelt.utils import formdata
query = {
'my_dict': {
'foo': 'bar',
'biz': 'baz",
},
'a': 'b',
}
resp = requests.get(url, params=formdata.urlencode(query))
# or
resp = requests.post(
url,
data=formdata.urlencode(query),
headers={
'Content-Type': 'application/x-www-form-urlencoded'
},
)
Similarly, you can specify a list of nested tuples, e.g.,
.. code-block:: python
import requests
from requests_toolbelt.utils import formdata
query = [
('my_list', [
('foo', 'bar'),
('biz', 'baz'),
]),
('a', 'b'),
]
resp = requests.get(url, params=formdata.urlencode(query))
# or
resp = requests.post(
url,
data=formdata.urlencode(query),
headers={
'Content-Type': 'application/x-www-form-urlencoded'
},
)
For additional parameter and return information, see the official
`urlencode`_ documentation.
.. _urlencode:
https://docs.python.org/3/library/urllib.parse.html#urllib.parse.urlencode
c s s | ]}t |�V qd S )N)�
_is_two_tuple)�.0�i� r � /usr/lib/python3.6/formdata.py� <genexpr>N s z urlencode.<locals>.<genexpr>zQExpected query to be able to be converted to a list comprised of length 2 tuples.c 3 s | ]\}}t |� �V qd S )N)�
isinstance)r �_�v)�expand_classesr r r S s ) �dict�list�tuple� _to_kv_list�all�
ValueError�any�_expand_query_values�
_urlencode)Zquery�args�kwargs�original_query_list�
query_listr )r
r r
s A
c C s t | d�rt| j� �S | S )N�items)�hasattrr r )Z dict_or_listr r r r Y s
r c C s t | ttf�ot| �dkS )Nr )r
r r �len)�itemr r r r _ s r c s\ g }xR| D ]J\}}t |t�r,|j||f� q
|d � t|�}|j� fdd�|D �� q
W |S )Nz[%s]c 3 s | ]\}}� | |fV qd S )Nr )r �kr )�key_fmtr r r k s z'_expand_query_values.<locals>.<genexpr>)r
r �appendr �extend)r r �key�valueZ
value_listr )r r r c s
r N)r ) �__doc__Z_compatr r r �__all__r r r r r r r �<module> s O