o
    Ee+                     @  s   d dl mZ d dlZd dlZd dlZejeef Z	eje	ej
ee	f ej
ee	ef f Z	ddd	d
ZdddZdddZdddZdddZG dd dZdS )    )annotationsNapplication/octet-streamfilename
str | Nonedefaultstrreturnc                 C  s   | rt | 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)r   r    r   O/var/www/bmteknikk.ddns.net/venv/lib/python3.10/site-packages/urllib3/fields.pyguess_content_type   s   r   namevalue_TYPE_FIELD_VALUEc              	     s   ddl }|jdtdd t tr d t fddd	D s=|  d
  d}z|d W |S  tt	fy<   Y nw t
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    | ]}| v V  qd S Nr   ).0chr   r   r   	<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)r   r   r   resultr   r   r   format_header_param_rfc2231   s&   

r+   c                 C  s6   t |tr
|d}|dddd}|  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.
    r   z%0Az%0Dz%22)
      "   r   r   )r    r!   r"   	translate)r   r   r   r   r   format_multipart_header_paramO   s   

r0   c                 C  "   ddl }|jdtdd 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.r   r   r   r   r   r0   r   r   r   r   r   r   format_header_param_html5u      
r5   c                 C  r1   )r2   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   r3   r4   r   r   r   format_header_param   r6   r7   c                   @  sd   e Zd ZdZ			d#d$ddZe	d%d&ddZd'ddZd(ddZd)ddZ				d#d*d!d"Z
dS )+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.
    Nr   r   datar   r   r   headerstyping.Mapping[str, str] | Noneheader_formatter5typing.Callable[[str, _TYPE_FIELD_VALUE], str] | Nonec                 C  sZ   || _ || _|| _i | _|rt|| _|d ur(dd l}|jdtdd || _d S t	| _d S )Nr   zUThe 'header_formatter' parameter is deprecated and will be removed in urllib3 v2.1.0.r   r   )
_name	_filenamer9   r:   dictr   r   r   r<   r0   )selfr   r9   r   r:   r<   r   r   r   r   __init__   s   


zRequestField.__init__	fieldnamer   _TYPE_FIELD_VALUE_TUPLEr   c                 C  s   t |tr-t|dkrttjtttf |\}}}nttjttf |\}}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)r   r<   )content_type)
r    tuplelentypingcastTupler   r   r   make_multipart)clsrC   r   r<   r   r9   rF   request_paramr   r   r   from_tuples   s"   

zRequestField.from_tuplesc                 C  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<   )rA   r   r   r   r   r   _render_part   s   zRequestField._render_partheader_parts[dict[str, _TYPE_FIELD_VALUE | None] | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]]c                 C  sN   g }t |tr| }n|}|D ]\}}|dur!|| || qd|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)rA   rQ   partsiterabler   r   r   r   r   _render_parts  s   


zRequestField._render_partsc                 C  s   g }g d}|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:   getrU   rT   rV   )rA   lines	sort_keyssort_keyheader_nameheader_valuer   r   r   render_headers'  s   

zRequestField.render_headerscontent_dispositionrF   content_locationNonec              	   C  sN   |pdd d| d| jfd| jffg }|| jd< || jd< || jd< 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    r   r   rZ   r[   r\   N)rV   rY   r>   r?   r:   )rA   rd   rF   re   r   r   r   rL   :  s   

	
zRequestField.make_multipart)NNN)
r   r   r9   r   r   r   r:   r;   r<   r=   r   )rC   r   r   rD   r<   r=   r   r8   r   r   r   r   r   r   )rQ   rR   r   r   )r   r   )rd   r   rF   r   re   r   r   rf   )__name__
__module____qualname____doc__rB   classmethodrO   rP   rY   rc   rL   r   r   r   r   r8      s     
0

r8   )r   )r   r   r   r   r   r   rh   )
__future__r   email.utilsr'   r	   rI   Unionr   r!   r   rK   rD   r   r+   r0   r5   r7   r8   r   r   r   r   <module>   s$    

0
&
