o jt!@sddlmZddlZddlZddlZddlZdddZddZdd d Z e d d e dd DddZ ddZ e ZGdddeZdS))absolute_importNapplication/octet-streamcCs|r t|dp |S|S)z Guess the "Content-Type" of a file. :param filename: The filename to guess the "Content-Type" of using :mod:`mimetypes`. :param default: If no "Content-Type" can be guessed, default to `default`. r) mimetypes guess_type)filenamedefaultr0/usr/lib/python3/dist-packages/urllib3/fields.pyguess_content_type s r c sttjr dtfdddDs0d|f}z|dW|Sttfy/Ynwtjr8dt j dd|ftjrMdS)a! Helper function to format and quote a single header parameter using the strategy defined in RFC 2231. Particularly useful for header parameters which might contain non-ASCII values, like file names. This follows `RFC 2388 Section 4.4 `_. :param name: The name of the parameter, a string expected to be ASCII only. :param value: The value of the parameter, provided as ``bytes`` or `str``. :ret: An RFC-2231-formatted unicode string. utf-8c3s|]}|vVqdSNr).0chvaluerr +sz.format_header_param_rfc2231..z"\ %s="%s"asciiz%s*=%s) isinstancesix binary_typedecodeanyencodeUnicodeEncodeErrorUnicodeDecodeErrorPY2emailutilsencode_rfc2231)namerresultrrr format_header_param_rfc2231s"       r"z%22z\\)"\cCs&i|]}|dvrt|d|qS))z%{:02X})runichrformat)r ccrrr Js r) cs:fdd}tdddD}|||}|S)Ncs|dS)Nr)group)matchneedles_and_replacementsrr replacerSsz#_replace_multiple..replacer|cSsg|]}t|qSr)reescape)r needlerrr Wsz%_replace_multiple..)r1compilejoinkeyssub)rr.r/patternr!rr-r _replace_multipleRs  r:cCs,t|tjr |d}t|t}d||fS)a Helper function to format and quote a single header parameter using the HTML5 strategy. Particularly useful for header parameters which might contain non-ASCII values, like file names. This follows the `HTML5 Working Draft Section 4.10.22.7`_ and matches the behavior of curl and modern browsers. .. _HTML5 Working Draft Section 4.10.22.7: https://w3c.github.io/html/sec-forms.html#multipart-form-data :param name: The name of the parameter, a string expected to be ASCII only. :param value: The value of the parameter, provided as ``bytes`` or `str``. :ret: A unicode string, stripped of troublesome characters. r r)rrrrr:_HTML5_REPLACEMENTS)r rrrr format_header_param_html5_s    r<c@sTeZdZdZddefddZeefddZddZd d Z d d Z dd dZ dS) RequestFielda A data container for request body parameters. :param name: The name of this request field. Must be unicode. :param data: The data/value body. :param filename: An optional filename of the request field. Must be unicode. :param headers: An optional dict-like object of headers to initially use for the field. :param header_formatter: An optional callable that is used to encode and format the headers. By default, this is :func:`format_header_param_html5`. NcCs0||_||_||_i|_|rt||_||_dSr )_name _filenamedataheadersdictheader_formatter)selfr r@rrArCrrr __init__s  zRequestField.__init__cCs`t|trt|dkr|\}}}n|\}}t|}nd}d}|}|||||d}|j|d|S)a A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters. Supports constructing :class:`~urllib3.fields.RequestField` from parameter of key/value strings AND key/filetuple. A filetuple is a (filename, data, MIME type) tuple where the MIME type is optional. For example:: 'foo': 'bar', 'fakefile': ('foofile.txt', 'contents of foofile'), 'realfile': ('barfile.txt', open('realfile').read()), 'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'), 'nonamefile': 'contents of nonamefile field', Field names and filenames must be unicode. N)rrC) content_type)rtuplelenr make_multipart)cls fieldnamerrCrr@rG request_paramrrr from_tupless     zRequestField.from_tuplescCs |||S)aI Overridable helper function to format a single header parameter. By default, this calls ``self.header_formatter``. :param name: The name of the parameter, a string expected to be ASCII only. :param value: The value of the parameter, provided as a unicode string. )rC)rDr rrrr _render_parts zRequestField._render_partcCsLg}|}t|tr |}|D]\}}|dur ||||qd|S)aO Helper function to format and quote a single header. Useful for single headers that are composed of multiple items. E.g., 'Content-Disposition' fields. :param header_parts: A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format as `k1="v1"; k2="v2"; ...`. N; )rrBitemsappendrOr6)rD header_partspartsiterabler rrrr _render_partss    zRequestField._render_partscCsg}gd}|D]}|j|dr|d||j|fq|jD]\}}||vr6|r6|d||fq#|dd|S)z= Renders the headers for this request field. )Content-Disposition Content-TypeContent-LocationFz%s: %sz )rAgetrRrQr6)rDlines sort_keyssort_key header_name header_valuerrr render_headerss  zRequestField.render_headersc CsX|pd|jd<|jddd|d|jfd|jffg7<||jd<||jd<d S) a| Makes this request field into a multipart request field. This method overrides "Content-Disposition", "Content-Type" and "Content-Location" headers to the request parameter. :param content_type: The 'Content-Type' of the request body. :param content_location: The 'Content-Location' of the request body. z form-datarWrPr rrXrYN)rAr6rVr>r?)rDcontent_dispositionrGcontent_locationrrr rJs zRequestField.make_multipart)NNN) __name__ __module__ __qualname____doc__r<rE classmethodrNrOrVr`rJrrrr r=~s # r=)r) __future__r email.utilsrrr1rr r"r;updateranger:r<format_header_paramobjectr=rrrr s&  +