o .j#@snddlmZddlZddlZddlZejrddlmZm Z  ddd d Z dddZ dddZ GdddZ dS)) annotationsN)_TYPE_FIELD_VALUE_TYPE_FIELD_VALUE_TUPLEapplication/octet-streamfilename str | NonedefaultstrreturncCs|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)rr rJ/home/thesage/.local/lib/python3.10/site-packages/urllib3_future/fields.pyguess_content_type s rnamevaluerc sttr dtfdddDs1|dd}z|dW|Sttfy0Ynwtj d|dS) 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``. :returns: An RFC-2231-formatted unicode string. .. deprecated:: 2.0.0 Will be removed in urllib3 v2.1.0. This is not valid for ``multipart/form-data`` header parameters. utf-8c3s|]}|vVqdSNr).0chrrr 2sz.format_header_param_rfc2231..z"\ =""asciiz*=) isinstancebytesdecodeanyencodeUnicodeEncodeErrorUnicodeDecodeErroremailutilsencode_rfc2231)rrresultrrrformat_header_param_rfc2231s   r'cCs6t|tr |d}|dddd}|d|dS)a Format and quote a single multipart header parameter. This follows the `WHATWG HTML Standard`_ as of 2021/06/10, matching the behavior of current browser and curl versions. Values are assumed to be UTF-8. The ``\n``, ``\r``, and ``"`` characters are percent encoded. .. _WHATWG HTML Standard: https://html.spec.whatwg.org/multipage/ form-control-infrastructure.html#multipart-form-data :param name: The name of the parameter, an ASCII-only ``str``. :param value: The value of the parameter, a ``str`` or UTF-8 encoded ``bytes``. :returns: A string ``name="value"`` with the escaped value. .. versionchanged:: 2.0.0 Matches the WHATWG HTML Standard as of 2021/06/10. Control characters are no longer percent encoded. .. versionchanged:: 2.0.0 Renamed from ``format_header_param_html5`` and ``format_header_param``. The old names will be removed in urllib3 v2.1.0. rz%0Az%0Dz%22) "rr)rrr translate)rrrrrformat_multipart_header_paramAs  r,c@sdeZdZdZ   d#d$d dZe d%d&ddZd'ddZd(ddZd)ddZ   d#d*d!d"Z 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. .. versionchanged:: 2.0.0 The ``header_formatter`` parameter is deprecated and will be removed in urllib3 v2.1.0. Nrr datarrrheaderstyping.Mapping[str, str] | Noneheader_formatter5typing.Callable[[str, _TYPE_FIELD_VALUE], str] | NonecCsB||_||_||_i|_|rt||_|dur||_dSt|_dSr)_name _filenamer.r/dictr1r,)selfrr.rr/r1rrr__init__ys   zRequestField.__init__ fieldnamerrr 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)rr1) content_type)rtuplelenrmake_multipart)clsr8rr1rr.r: request_paramrrr from_tupless     zRequestField.from_tuplescCs |||S)a Override this method to change how each multipart header parameter is formatted. By default, this calls :func:`format_multipart_header_param`. :param name: The name of the parameter, an ASCII-only ``str``. :param value: The value of the parameter, a ``str`` or UTF-8 encoded ``bytes``. :meta public: )r1)r6rrrrr _render_parts zRequestField._render_part header_parts[dict[str, _TYPE_FIELD_VALUE | None] | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]]cCsNg}t|tr |}n|}|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; )rr5itemsappendrAjoin)r6rBpartsiterablerrrrr _render_partss    zRequestField._render_partscCsg}gd}|D]}|j|dr||d|j|q|jD]\}}||vr8|r8||d|q$|dd|S)z= Renders the headers for this request field. )Content-Disposition Content-TypeContent-LocationFz: z )r/getrFrErG)r6lines sort_keyssort_key header_name header_valuerrrrender_headerss  zRequestField.render_headerscontent_dispositionr:content_locationNonec CsN|pddd|d|jfd|jffg}||jd<||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_disposition: The 'Content-Disposition' of the request body. Defaults to 'form-data' :param content_type: The 'Content-Type' of the request body. :param content_location: The 'Content-Location' of the request body. z form-datarDrrrKrLrMN)rGrJr3r4r/)r6rUr:rVrrrr=s  zRequestField.make_multipart)NNN) rr r.rrrr/r0r1r2r)r8r rrr1r2r r-rr rrr r )rBrCr r )r r )rUrr:rrVrr rW) __name__ __module__ __qualname____doc__r7 classmethodr@rArJrTr=rrrrr-gs   ,  r-)r)rrr r r r rY) __future__r email.utilsr#r typing TYPE_CHECKING_typingrrrr'r,r-rrrrs   &&