B

���g+�@s�dd
lm
Z

ddlZddlZddlZejeefZ	eje	ej
ee	fej
ee	effZddddd�dd�Zdd	dd
�dd�Z
dd	dd
�d
d�Zdd	dd
�dd�Zdd	dd
�dd�ZGdd�d�ZdS)�)
�annotationsN�application/octet-streamz
str | None�str)�filename�default�returncCs|rt�
|�
d
p|
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�r
�8/usr/local/lib/python3.7/site-packages/urllib3/fields.py�guess_content_types

r�_TYPE_FIELD_VALUE)�name�valuerc	s�d
dl}|j
dtdd�
t�t�r,��d�
�t�f
dd�d	D�
�
s~|�d
��d�}y|�d�

Wntt	fk
rx


YnX|St
j��d��|�d
�����S)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 <https://tools.ietf.org/html/rfc2388#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.
    r
Nz�'format_header_param_rfc2231' is deprecated and will be removed in urllib3 v2.1.0. This is not valid for multipart/form-data header parameters.�)
�
stacklevelzutf-8c
3s|]}
|
�kV
qdS)
Nr
)�.0�ch)
rr
r�	<genexpr>@sz.format_header_param_rfc2231.<locals>.<genexpr>z"\
z="�
"�asciiz*=)
�warnings�warn�DeprecationWarning�
isinstance�bytes�decode�any�encode�UnicodeEncodeError�UnicodeDecodeError�email�utils�encode_rfc2231)rrr�resultr
)
rr�format_header_param_rfc2231s"










r%cCs6t|
t
�r|
�d
�
}
|
�dddd��
}
|�d|
�d�S)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.
    zutf-8z%0Az%0Dz%22)�
�
�"z="r)rrr�	translate)rrr
r
r�format_multipart_header_paramOs



r*cCs"d
dl}|j
dtdd�
t||
�S)z�
    .. deprecated:: 2.0.0
        Renamed to :func:`format_multipart_header_param`. Will be
        removed in urllib3 v2.1.0.
    r
Nz�'format_header_param_html5' has been renamed to 'format_multipart_header_param'. The old name will be removed in urllib3 v2.1.0.r)
r)rrrr*)rrrr
r
r�format_header_param_html5us

r+cCs"d
dl}|j
dtdd�
t||
�S)z�
    .. deprecated:: 2.0.0
        Renamed to :func:`format_multipart_header_param`. Will be
        removed in urllib3 v2.1.0.
    r
Nzz'format_header_param' has been renamed to 'format_multipart_header_param'. The old name will be removed in urllib3 v2.1.0.r)
r)rrrr*)rrrr
r
r�format_header_param�s

r,c@s�eZ
dZd
Zddddddd�d	d
�Zedddddd�d
d��
Zdddd�dd�Zddd�dd�Zdd�
dd�Z	dddddd�dd�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
z
str | Noneztyping.Mapping[str, str] | Nonez5typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None)r�datar�headers�header_formattercCsX|
|_||_
||_i|_|r&t|�
|_|dk	rNd
dl}|jdtdd�
||_nt	|_dS)Nr
zUThe 'header_formatter' parameter is deprecated and will be removed in urllib3 v2.1.0.r)
r)
�_name�	_filenamer.r/�dictrrrr0r*)�selfrr.rr/r0rr
r
r�__init__�s








zRequestField.__init__�_TYPE_FIELD_VALUE_TUPLE)�	fieldnamerr0rcCs�t|t
�rZt|�
d
kr6t�tjtttf|�\}}}qft�tjttf|�\}}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)rr0)
�content_type)
r�tuple�len�typing�cast�Tuplerr
r�make_multipart)�clsr7rr0rr.r9�
request_paramr
r
r�from_tuples�s








zRequestField.from_tuples)rrrcCs|�|
|�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:
        )
r0)r4rrr
r
r�_render_part�szRequestField._render_partz[dict[str, _TYPE_FIELD_VALUE | None] | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]])�header_partsrcCsRg}t|
t
�r|
��}n|
}x*|D]"\}}|d
k	r"|�|�||��

q"Wd�|�
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"; ...`.
        Nz; )rr3�items�appendrC�join)r4rD�parts�iterablerrr
r
r�
_render_parts
s





zRequestField._render_parts)
rc
Cs�g}
d
ddg}x4|D],}|j�
|d�r|
�|�d|j|���

qWx6|j��D](\}}||krP|rP|
�|�d|���

qPW|
�d�

d�|
�
S)z=
        Renders the headers for this request field.
        zContent-DispositionzContent-TypezContent-LocationFz: z
)r/�getrFrErG)r4�lines�	sort_keys�sort_key�header_name�header_valuer
r
r�render_headers'
s









zRequestField.render_headers�None)�content_dispositionr9�content_locationrc	CsN|
pd
d�d|�
d|jfd|jff�
g�
}
|
|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-dataz; �rrzContent-DispositionzContent-TypezContent-LocationN)rGrJr1r2r/)r4rSr9rTr
r
rr?:
s






zRequestField.make_multipart)NNN)
N)NNN)�__name__�
__module__�__qualname__�__doc__r5�classmethodrBrCrJrQr?r
r
r
rr-�s

,

r-)
r)�
__future__r�email.utilsr!rr<�Unionrrr
r>r6rr%r*r+r,r-r
r
r
r�<module>
s





0&