관리-도구
편집 파일: fields.cpython-38.pyc
U )�e+ � @ s� d dl mZ d dlZd dlZd dlZejeef Z eje ej ee f ej ee ef f Z ddddd�dd�Z dd dd �d d �Z dd dd �d d�Zdd dd �dd�Zdd dd �dd�ZG dd� d�ZdS )� )� annotationsN�application/octet-stream� str | None�str)�filename�default�returnc C 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)r r � r �</opt/hc_python/lib/python3.8/site-packages/urllib3/fields.py�guess_content_type s r �_TYPE_FIELD_VALUE��name�valuer c s� ddl }|jdtdd� t� t�r,� �d�� t� fdd�d D ��s~| � d � � d �}z|�d � W n tt fk rx Y nX |S 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 | ]}|� kV qd 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�}|�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 r r r � format_multipart_header_paramO s r0 c C s" ddl }|jdtdd� 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 s �r4 c C s" ddl }|jdtdd� t| |�S )r1 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 r2 r3 r r r �format_header_param� s �r5 c @ s� e Zd ZdZd dddddd�d d �Zed dd dd d �d d��Zdddd�dd�Zddd�dd�Zdd�dd�Z d ddddd�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. Nr r r z typing.Mapping[str, str] | Nonez5typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None)r �datar �headers�header_formatterc C sX || _ || _|| _i | _|r&t|�| _|d k rNdd l}|jdtdd� || _nt | _d S )Nr zUThe 'header_formatter' parameter is deprecated and will be removed in urllib3 v2.1.0.r r ) �_name� _filenamer7 r8 �dictr r r r9 r0 )�selfr r7 r r8 r9 r r r r �__init__� s �zRequestField.__init__�_TYPE_FIELD_VALUE_TUPLE)� fieldnamer r9 r c C s� t |t�rZt|�dkr6t�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)r r9 )� content_type) r �tuple�len�typing�cast�Tupler r r �make_multipart)�clsr@ r r9 r r7 rB � request_paramr r r � from_tuples� s, � � � zRequestField.from_tuplesr c 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: )r9 )r= r r r r r � _render_part� s zRequestField._render_partz[dict[str, _TYPE_FIELD_VALUE | None] | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]])� header_partsr c C sN g }t |t�r|�� }n|}|D ]"\}}|dk 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�appendrL �join)r= rM �parts�iterabler r r r r � _render_parts s zRequestField._render_parts)r c C s� g }dddg}|D ],}| j �|d�r|�|� d| j | � �� q| j �� D ](\}}||krJ|rJ|�|� d|� �� qJ|�d� d�|�S )z= Renders the headers for this request field. �Content-Disposition� Content-Type�Content-LocationFz: z )r8 �getrP rO rQ )r= �lines� sort_keys�sort_key� header_name� header_valuer r r �render_headers' s zRequestField.render_headers�None)�content_dispositionrB �content_locationr c C sN |pdd� 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-datarN � r r rU rV rW N)rQ rT r: r; r8 )r= r` rB ra r r r rH : s ��� zRequestField.make_multipart)NNN)N)NNN) �__name__� __module__� __qualname__�__doc__r> � classmethodrK rL rT r^ rH r r r r r6 � s � �0 �r6 )r )� __future__r � email.utilsr' r rE �Unionr r! r rG r? r r+ r0 r4 r5 r6 r r r r �<module> s" �� �0&