�
�S�gM* � �� � d dl mZ d dlZd dlZd dlZej eef Z ej e e
ee f e
ee ef f Z d
d d�Z d d�Z
d d�Zd d�Zd d�Z G d� d � Zy)
� )� annotationsNc �B � | r t j | � d xs |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)�filename�defaults �~/build/snapcraft-certbot-29b1212f749eeba2f1dece1adfe9a83a/parts/certbot/install/lib/python3.12/site-packages/urllib3/fields.py�guess_content_typer
s' � � ��#�#�H�-�a�0�;�G�;� �N� c �Z �� ddl }|j dt d�� t �t � r�j d� �t
�fd�dD � � s | � d �� d
�} |j d � |S t j j �d� �| � d �� ���S # t t f$ r Y �:w xY w)
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 �& �K � | ] }|�v �� �
y �w�N� )�.0�ch�values �r � <genexpr>z.format_header_param_rfc2231.<locals>.<genexpr>@ s �� �� �/�r�r�U�{�/�s �z"\
�="�"�asciiz*=)
�warnings�warn�DeprecationWarning�
isinstance�bytes�decode�any�encode�UnicodeEncodeError�UnicodeDecodeError�email�utils�encode_rfc2231)�namer r �results ` r �format_header_param_rfc2231r* s� �� �( � �M�M� 1� �� � � �%�� �� � �W�%�� �/�Y�/� /��6��E�7�!�$�� � �M�M�'� "� �M� �K�K� &� &�u�g� 6�E��f�B�u�g� �E� �L�� #�$6�7� � � �s � B �B*�)B*c �~ � t |t � r|j d� }|j 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.
r z%0Az%0Dz%22)�
�
�" r r )r r r � translate)r( r s r � format_multipart_header_paramr0 O sF � �< �%�� �� � �W�%��
�O�O��E�u� =� >�E��V�2�e�W�A� � r c �R � ddl }|j dt 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 s r �format_header_param_html5r5 u �4 � � � �M�M� %� �� � � )��u� 5�5r c �R � ddl }|j dt d�� t | |� S )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 s r �format_header_paramr8 � r6 r c � � e Zd ZdZ d d
d�Ze d d d�� Zd
d�Z dd�Zdd�Z d dd�Z
y)� 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.
Nc �� � || _ || _ || _ i | _ |rt |� | _ |�$dd l}|j
dt d�� || _ y t | _ y )Nr zUThe 'header_formatter' parameter is deprecated and will be removed in urllib3 v2.1.0.r
r )
�_name� _filename�data�headers�dictr r r �header_formatterr0 )�selfr( r> r r? rA r s r �__init__zRequestField.__init__� se � � ��
�!����� �.0�� � � ��=�D�L� � '� � �M�M�5�"� �
�
� %5�D� !�$A�D� !r c � � t |t � r&t |� dk( r|\ }}}n|\ }}t |� }nd}d}|} | ||||�� }|j |�� |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 rA )� content_type)r �tuple�lenr
�make_multipart)�cls� fieldnamer rA r r> rF �
request_params r � from_tupleszRequestField.from_tuples� st � �6 �e�U� #��5�z�Q��/4�,��$� �!&���$� 1�(� ;� ��H� �L��D�� �t�h�AQ�
�
� �$�$�,�$�?� � r c �& � | j ||� 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:
)rA )rB r( r s r � _render_partzRequestField._render_part� s � � �$�$�T�5�1�1r c �� � g }t |t � r|j � }n|}|D ]) \ }}|�� |j | j ||� � �+ dj |� 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"; ...`.
�; )r r@ �items�appendrO �join)rB � header_parts�parts�iterabler( r s r �
_render_partszRequestField._render_parts si � �& �� �l�D� )�#�)�)�+�H�#�H�#� =�K�D�%�� �� � �T� .� .�t�U� ;�<� =� �y�y�� � r c �` � g }g d�}|D ]B }| j j |d� s� |j |� d| j | � �� �D | j j � D ]# \ }}||vs� |s�|j |� d|� �� �% |j d� dj |� S )z=
Renders the headers for this request field.
)�Content-Disposition� Content-Type�Content-LocationFz: z
)r? �getrS rR rT )rB �lines� sort_keys�sort_key� header_name� header_values r �render_headerszRequestField.render_headers# s� � � ��O� �!� F�H��|�|� � ��%�0�� � ��z��D�L�L��,B�+C� D�E� F� *.� � �);�);�)=� C� %�K� ��)�+� ��L�L�K�=��<�.�!A�B� C�
� � �V� ��{�{�5�!�!r c �� � |xs ddj d| j d| j fd| j ff� g� z }|| j d< || j d< || j d< y )
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-datarQ � r( r rZ r[ r\ N)rT rX r< r= r? )rB �content_dispositionrF �content_locations r rI zRequestField.make_multipart6 s � �( 3� A�k�T�Y�Y���"�"� �d�j�j�)�J����+G�H��
�F
�
�� /B�� � �*�+�'3�� � �^�$�+;�� � �'�(r )NNN)
r( �strr> �_TYPE_FIELD_VALUEr �
str | Noner? z typing.Mapping[str, str] | NonerA �5typing.Callable[[str, _TYPE_FIELD_VALUE], str] | Noner )rK rh r �_TYPE_FIELD_VALUE_TUPLErA rk �returnr: �r( rh r ri rm rh )rU z[dict[str, _TYPE_FIELD_VALUE | None] | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]]rm rh )rm rh )rf rj rF rj rg rj rm �None) �__name__�
__module__� __qualname__�__doc__rC � classmethodrM rO rX rc rI r r r r: r: � s� � ��* $�37�RV�
B��B� �B� � B�
1� B� P�
B�8 �
SW� * ��* � '�* � P� * �
� * � �* �X2� �
D� �
�
�>"�* +/�#'�'+� <� '� <� !� <� %� <�
� <r r: )zapplication/octet-stream)r rj r rh rm rh rn )�
__future__r � email.utilsr% r �typing�Unionrh r ri rG rl r
r* r0 r5 r8 r: r r r �<module>ry s� �� "� � �
��L�L��e��,� � �,�,�� �#� �
�!� �#� �#�
%�&�(�� � *D�
��
�#&�
��
� -�`# �L6�$6�$|<� |<r |