1 from __future__ import absolute_import
7 from .packages import six
8 from .packages.six import b
9 from .fields import RequestField
11 writer = codecs.lookup('utf-8')[3]
14 def choose_boundary():
16 Our embarassingly-simple replacement for mimetools.choose_boundary.
21 def iter_field_objects(fields):
25 Supports list of (k, v) tuples and dicts, and lists of
26 :class:`~urllib3.fields.RequestField`.
29 if isinstance(fields, dict):
30 i = six.iteritems(fields)
35 if isinstance(field, RequestField):
38 yield RequestField.from_tuples(*field)
41 def iter_fields(fields):
47 The addition of :class:`~urllib3.fields.RequestField` makes this function
48 obsolete. Instead, use :func:`iter_field_objects`, which returns
49 :class:`~urllib3.fields.RequestField` objects.
51 Supports list of (k, v) tuples and dicts.
53 if isinstance(fields, dict):
54 return ((k, v) for k, v in six.iteritems(fields))
56 return ((k, v) for k, v in fields)
59 def encode_multipart_formdata(fields, boundary=None):
61 Encode a dictionary of ``fields`` using the multipart/form-data MIME format.
64 Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).
67 If not specified, then a random boundary will be generated using
68 :func:`mimetools.choose_boundary`.
72 boundary = choose_boundary()
74 for field in iter_field_objects(fields):
75 body.write(b('--%s\r\n' % (boundary)))
77 writer(body).write(field.render_headers())
80 if isinstance(data, int):
81 data = str(data) # Backwards compatibility
83 if isinstance(data, six.text_type):
84 writer(body).write(data)
90 body.write(b('--%s--\r\n' % (boundary)))
92 content_type = str('multipart/form-data; boundary=%s' % boundary)
94 return body.getvalue(), content_type