a ibf!@sddlmZddlZddlZddlZddlmZdddZdd Z d d d Z e d de ddDddZ ddZeZGdddeZdS))absolute_importN)sixapplication/octet-streamcCs|rt|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)filenamedefaultr W/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/pip/_vendor/urllib3/fields.pyguess_content_type s r c sttjrdtfdddDsbd|f}z|dWnttfy\Yn0|Stjrrdt j dd|ftjrdS)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 ).0chvaluer r +z.format_header_param_rfc2231..z"\ %s="%s"asciiz%s*=%s) isinstancer binary_typedecodeanyencodeUnicodeEncodeErrorUnicodeDecodeErrorPY2emailutilsencode_rfc2231)namerresultr rr format_header_param_rfc2231s       r$z%22z\\)"\cCs&i|]}|dvrt|d|qS))z%{:02X})runichrformat)rccr r r Jsr+ cs:fdd}tdddD}|||}|S)Ncs|dS)Nr)group)matchneedles_and_replacementsr r replacerSsz#_replace_multiple..replacer|cSsg|]}t|qSr )reescape)rneedler r r Wrz%_replace_multiple..)r3compilejoinkeyssub)rr0r1patternr#r r/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"rr r r format_header_param_html5_s   r>c@sReZdZdZddefddZeefddZddZd 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|_|r&t||_||_dSr)_name _filenamedataheadersdictheader_formatter)selfr"rBrrCrEr r r __init__s zRequestField.__init__cCs`t|tr4t|dkr"|\}}}q@|\}}t|}n d}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)rrE) content_type)rtuplelenr make_multipart)cls fieldnamerrErrBrI request_paramr r r 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. )rE)rFr"rr r r _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; )rrDitemsappendrQr8)rF header_partspartsiterabler"rr r r _render_partss   zRequestField._render_partscCsg}gd}|D]*}|j|dr|d||j|fq|jD]&\}}||vrF|rF|d||fqF|dd|S)z= Renders the headers for this request field. )Content-Disposition Content-TypeContent-LocationFz%s: %sz )rCgetrTrSr8)rFlines sort_keyssort_key header_name header_valuer r r 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-datarYrRr"rrZr[N)rCr8rXr@rA)rFcontent_dispositionrIcontent_locationr r r rLs zRequestField.make_multipart)NNN) __name__ __module__ __qualname____doc__r>rG classmethodrPrQrXrbrLr r r r r?~s # r?)r) __future__r email.utilsrrr3packagesrr r$r=updateranger<r>format_header_paramobjectr?r r r r s$   +