관리-도구
편집 파일: _request_methods.cpython-38.pyc
U )�e ' � @ s� d dl mZ d dlZd dlZd dlmZ ddlmZ ddl m Z ddl m Z m Z ddlmZ d gZejejejeejeef f ejeejeef f f ZG d d � d �ZdS ) � )� annotationsN)� urlencode� )� _TYPE_BODY)�HTTPHeaderDict)� _TYPE_FIELDS�encode_multipart_formdata)�BaseHTTPResponse�RequestMethodsc @ s� e Zd ZdZddddhZd"ddd �d d �Zd#d d ddddddd�dd�Zd$d d ddddddd�dd�Zd%d d ddd dd �d d �Zd&d d ddddd dd �d d!�Z dS )'r a� Convenience mixin for classes who implement a :meth:`urlopen` method, such as :class:`urllib3.HTTPConnectionPool` and :class:`urllib3.PoolManager`. Provides behavior for making common types of HTTP request methods and decides which type of request field encoding to use. Specifically, :meth:`.request_encode_url` is for sending requests whose fields are encoded in the URL (such as GET, HEAD, DELETE). :meth:`.request_encode_body` is for sending requests whose fields are encoded in the *body* of the request using multipart or www-form-urlencoded (such as for POST, PUT, PATCH). :meth:`.request` is for making any kind of request, it will look up the appropriate encoding format and use one of the above two methods to make the request. Initializer parameters: :param headers: Headers to include with all requests, unless other headers are given explicitly. �DELETE�GET�HEAD�OPTIONSNz typing.Mapping[str, str] | None�None)�headers�returnc C s |pi | _ d S )N)r )�selfr � r �F/opt/hc_python/lib/python3.8/site-packages/urllib3/_request_methods.py�__init__3 s zRequestMethods.__init__T�strz_TYPE_BODY | None�boolz str | Nonez typing.Anyr )�method�url�bodyr �encode_multipart�multipart_boundary�kwr c K s t d��d S )NzMClasses extending RequestMethods must implement their own ``urlopen`` method.)�NotImplementedError)r r r r r r r r r r r �urlopen6 s �zRequestMethods.urlopenz_TYPE_FIELDS | Noneztyping.Any | None)r r r �fieldsr �json� urlopen_kwr c K s� |� � }|dk r |dk r td��|dk rp|dkr6| j}dttj|�� �krZt|�}d|d< tj |ddd�� d �}|dk r�||d < || j kr�| j ||f||d �|��S | j ||f||d �|��S dS ) a� Make a request using :meth:`urlopen` with the appropriate encoding of ``fields`` based on the ``method`` used. This is a convenience method that requires the least amount of manual effort. It can be used in most situations, while still having the option to drop down to more specific methods when necessary, such as :meth:`request_encode_url`, :meth:`request_encode_body`, or even the lowest level :meth:`urlopen`. :param method: HTTP request method (such as GET, POST, PUT, etc.) :param url: The URL to perform the request on. :param body: Data to send in the request body, either :class:`str`, :class:`bytes`, an iterable of :class:`str`/:class:`bytes`, or a file-like object. :param fields: Data to encode and send in the request body. Values are processed by :func:`urllib.parse.urlencode`. :param headers: Dictionary of custom headers to send, such as User-Agent, If-None-Match, etc. If None, pool headers are used. If provided, these headers completely replace any pool-specific headers. :param json: Data to encode and send as JSON with UTF-encoded in the request body. The ``"Content-Type"`` header will be set to ``"application/json"`` unless specified otherwise. NzUrequest got values for both 'body' and 'json' parameters which are mutually exclusivez content-typezapplication/json� Content-Type)�,�:F)� separators� ensure_asciizutf-8r )r r )�upper� TypeErrorr �mapr �lower�keysr �_json�dumps�encode�_encode_url_methods�request_encode_url�request_encode_body)r r r r r r r! r" r r r �requestE sF ,�� ��� � ��zRequestMethods.requestz _TYPE_ENCODE_URL_FIELDS | None)r r r r r" r c K sD |dkr| j }d|i}|�|� |r4|dt|� 7 }| j||f|�S )a� Make a request using :meth:`urlopen` with the ``fields`` encoded in the url. This is useful for request methods like GET, HEAD, DELETE, etc. :param method: HTTP request method (such as GET, POST, PUT, etc.) :param url: The URL to perform the request on. :param fields: Data to encode and send in the request body. :param headers: Dictionary of custom headers to send, such as User-Agent, If-None-Match, etc. If None, pool headers are used. If provided, these headers completely replace any pool-specific headers. Nr �?)r �updater r )r r r r r r" �extra_kwr r r r1 � s z!RequestMethods.request_encode_url)r r r r r r r" r c K s� |dkr| j }dt|�i}|rjd|kr.td��|rDt||d�\} } nt|�d } } | |d< |d �d| � |�|� | j||f|�S )a� Make a request using :meth:`urlopen` with the ``fields`` encoded in the body. This is useful for request methods like POST, PUT, PATCH, etc. When ``encode_multipart=True`` (default), then :func:`urllib3.encode_multipart_formdata` is used to encode the payload with the appropriate content type. Otherwise :func:`urllib.parse.urlencode` is used with the 'application/x-www-form-urlencoded' content type. Multipart encoding must be used when posting files, and it's reasonably safe to use it in other times too. However, it may break request signing, such as with OAuth. Supports an optional ``fields`` 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:: fields = { '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', } When uploading a file, providing a filename (the first parameter of the tuple) is optional but recommended to best mimic behavior of browsers. Note that if ``headers`` are supplied, the 'Content-Type' header will be overwritten because it depends on the dynamic random boundary string which is used to compose the body of the request. The random boundary string can be explicitly set with the ``multipart_boundary`` parameter. :param method: HTTP request method (such as GET, POST, PUT, etc.) :param url: The URL to perform the request on. :param fields: Data to encode and send in the request body. :param headers: Dictionary of custom headers to send, such as User-Agent, If-None-Match, etc. If None, pool headers are used. If provided, these headers completely replace any pool-specific headers. :param encode_multipart: If True, encode the ``fields`` using the multipart/form-data MIME format. :param multipart_boundary: If not specified, then a random boundary will be generated using :func:`urllib3.filepost.choose_boundary`. Nr r zFrequest got values for both 'fields' and 'body', can only specify one.)�boundaryz!application/x-www-form-urlencodedr# )r r r) r r � setdefaultr5 r ) r r r r r r r r" r6 r � content_typer r r r2 � s( C � � � z"RequestMethods.request_encode_body)N)NNTN)NNNN)NN)NNTN) �__name__� __module__� __qualname__�__doc__r0 r r r3 r1 r2 r r r r r s* � � S �) �)� __future__r r! r- �typing� urllib.parser Z_base_connectionr � _collectionsr �filepostr r �responser �__all__�Union�Sequence�Tupler �bytes�MappingZ_TYPE_ENCODE_URL_FIELDSr r r r r �<module> s ��