o

we+�@
s�dd
lm
Z

ddlZddlZddlZejeefZ	eje	ej
ee	fej
ee	effZ	ddd	d
�Zddd�Z
ddd�Zddd�Zddd�ZGdd�d�ZdS)�)
�annotationsN�application/octet-stream�filename�
str | None�default�str�returncC
s|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�G/home/arjun/projects/env/lib/python3.10/site-packages/urllib3/fields.py�guess_content_types

r
�name�value�_TYPE_FIELD_VALUEc	
s�d
dl}|j
dtdd�
t�t�r��d�
�t�f
dd�d	D�
�
s=|�d
��d�}z|�d�

W|Stt	fy<


Yn
wt
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.��
�
stacklevel�utf-8c
3
s�|]}
|
�vV
qdS�
Nr)�.0�ch�
rrr�	<genexpr>@s�z.format_header_param_rfc2231.<locals>.<genexpr>z"\
�="�
"�asciiz*=)
�warnings�warn�DeprecationWarning�
isinstance�bytes�decode�any�encode�UnicodeEncodeError�UnicodeDecodeError�email�utils�encode_rfc2231)rrr�resultrrr�format_header_param_rfc2231s&

�





�
�
r+cC
s6t|
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.
    rz%0Az%0Dz%22)�
�
�"rr)r r!r"�	translate)rrrrr�format_multipart_header_paramOs



r0cC
�"d
dl}|j
dtdd�
t||
�S)��
    .. 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.rr�rrrr0�rrrrrr�format_header_param_html5u�

�
r5cC
r1)r2r
Nzz'format_header_param' has been renamed to 'format_multipart_header_param'. The old name will be removed in urllib3 v2.1.0.rrr3r4rrr�format_header_param�r6r7c@
sdeZ
dZd
Z			d#d$d
d�Ze	d%d&dd��
Zd'dd�Zd(dd�Zd)dd�Z				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�datarrr�headers�typing.Mapping[str, str] | None�header_formatter�5typing.Callable[[str, _TYPE_FIELD_VALUE], str] | NonecC
sZ|
|_||_
||_i|_|rt|�
|_|du
r(d
dl}|jdtdd�
||_dSt	|_dS)Nr
zUThe 'header_formatter' parameter is deprecated and will be removed in urllib3 v2.1.0.rr)
�_name�	_filenamer9r:�dictrrrr<r0)�selfrr9rr:r<rrrr�__init__�s








�

zRequestField.__init__�	fieldnamer�_TYPE_FIELD_VALUE_TUPLErcC
s�t|t
�r-t|�
d
krt�tjtttf|�\}}}nt�tjttf|�\}}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)rr<)
�content_type)
r �tuple�len�typing�cast�Tuplerrr
�make_multipart)�clsrCrr<rr9rF�
request_paramrrr�from_tuples�s"



�
�



�zRequestField.from_tuplescC
s|�|
|�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:
        )
r<)rArrrrr�_render_part�szRequestField._render_part�header_parts�[dict[str, _TYPE_FIELD_VALUE | None] | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]]cC
sNg}t|
t
�r|
��}n|
}|D]\}}|d
u
r!|�|�||��

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�; )r r@�items�appendrP�join)rArQ�parts�iterablerrrrr�
_render_parts
s





�
zRequestField._render_partsc
C
s�g}
gd
�
}|D]}|j�
|d�r|
�|�d|j|���

q|j��D]\}}||v
r8|r8|
�|�d|���

q$|
�d�

d�|
�
S)z=
        Renders the headers for this request field.
        )�Content-Disposition�Content-Type�Content-LocationFz: z
)r:�getrUrTrV)rA�lines�	sort_keys�sort_key�header_name�header_valuerrr�render_headers'
s


�


�


zRequestField.render_headers�content_dispositionrF�content_location�Nonec	C
sN|
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-datarS�rrrZr[r\N)rVrYr>r?r:)rArdrFrerrrrL:
s


���
	


zRequestField.make_multipart)NNN)
rrr9rrrr:r;r<r=r)rCrrrDr<r=rr8�rrrrrr)rQrRrr)rr)rdrrFrrerrrf)�__name__�
__module__�__qualname__�__doc__rB�classmethodrOrPrYrcrLrrrrr8�s 


��
0



�r8)
r)rrrrrrrh)�
__future__r�email.utilsr'r	rI�Unionrr!rrKrDr
r+r0r5r7r8rrrr�<module>
s$





���

0
&