2
# Copyright 2008-2013 Andrey Petrov and contributors (see CONTRIBUTORS.txt)
4
# This module is part of urllib3 and is released under
5
# the MIT License: http://www.opensource.org/licenses/mit-license.php
10
from uuid import uuid4
11
from io import BytesIO
13
from .packages import six
14
from .packages.six import b
15
from .fields import RequestField
17
writer = codecs.lookup('utf-8')[3]
20
def choose_boundary():
22
Our embarassingly-simple replacement for mimetools.choose_boundary.
27
def iter_field_objects(fields):
31
Supports list of (k, v) tuples and dicts, and lists of
32
:class:`~urllib3.fields.RequestField`.
35
if isinstance(fields, dict):
36
i = six.iteritems(fields)
41
if isinstance(field, RequestField):
44
yield RequestField.from_tuples(*field)
47
def iter_fields(fields):
53
The addition of :class:`~urllib3.fields.RequestField` makes this function
54
obsolete. Instead, use :func:`iter_field_objects`, which returns
55
:class:`~urllib3.fields.RequestField` objects.
57
Supports list of (k, v) tuples and dicts.
59
if isinstance(fields, dict):
60
return ((k, v) for k, v in six.iteritems(fields))
62
return ((k, v) for k, v in fields)
65
def encode_multipart_formdata(fields, boundary=None):
67
Encode a dictionary of ``fields`` using the multipart/form-data MIME format.
70
Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).
73
If not specified, then a random boundary will be generated using
74
:func:`mimetools.choose_boundary`.
78
boundary = choose_boundary()
80
for field in iter_field_objects(fields):
81
body.write(b('--%s\r\n' % (boundary)))
83
writer(body).write(field.render_headers())
86
if isinstance(data, int):
87
data = str(data) # Backwards compatibility
89
if isinstance(data, six.text_type):
90
writer(body).write(data)
96
body.write(b('--%s--\r\n' % (boundary)))
98
content_type = str('multipart/form-data; boundary=%s' % boundary)
100
return body.getvalue(), content_type