U
.ei! @ s d dl mZ d dlZd dlZd dlZddlmZ dddZdd Z d
d d d Z
e
d
d e d dD dd Z
dd ZeZG dd deZdS ) )absolute_importN )sixapplication/octet-streamc 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 ) mimetypesZ
guess_type)filenamedefault r >/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/fields.pyguess_content_type s r c s t tjr d t fdddD sdd| f }z|d W n ttfk
r^ Y nX |S tjrt d t j
d d| f tjr 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.
: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``.
:ret:
An RFC-2231-formatted unicode string.
utf-8c 3 s | ]}| kV qd S Nr ).0Zchvaluer r
) s z.format_header_param_rfc2231..z"\
%s="%s"asciiz%s*=%s)
isinstancer binary_typedecodeanyencodeUnicodeEncodeErrorUnicodeDecodeErrorZPY2emailZutilsZencode_rfc2231)namer resultr r r
format_header_param_rfc2231 s
r z%22z\\)"\r c C s& i | ] }|d krt |d|qS )) z%{:02X})r Zunichrformat)r Zccr r r
I s r# c s: fdd}t ddd D }||| }|S )Nc s | d S )Nr )group)matchneedles_and_replacementsr r
replacerR s z#_replace_multiple..replacer|c S s g | ]}t |qS r )reescape)r Zneedler r r
V s z%_replace_multiple..)r+ compilejoinkeyssub)r r( r) patternr r r' r
_replace_multipleQ s r3 c C s, t |tjr|d}t|t}d| |f S )a
Helper function to format and quote a single header parameter using the
HTML5 strategy.
Particularly useful for header parameters which might contain
non-ASCII values, like file names. This follows the `HTML5 Working Draft
Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.
.. _HTML5 Working Draft Section 4.10.22.7:
https://w3c.github.io/html/sec-forms.html#multipart-form-data
: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``.
:ret:
A unicode string, stripped of troublesome characters.
r r )r r r r r3 _HTML5_REPLACEMENTS)r r r r r
format_header_param_html5^ s
r5 c @ sR e Zd ZdZddefddZeefddZdd Zd d
Z d d Z
dd
dZ 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.
:param header_formatter:
An optional callable that is used to encode and format the headers. By
default, this is :func:`format_header_param_html5`.
Nc C s0 || _ || _|| _i | _|r&t|| _|| _d S r
)_name _filenamedataheadersdictheader_formatter)selfr r9 r r: r< r r r
__init__ s
zRequestField.__init__c C s` t |tr4t|dkr"|\}}}q@|\}}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 tuplelenr make_multipart)clsZ fieldnamer r< r r9 r@ Z
request_paramr r r
from_tuples s
zRequestField.from_tuplesc C s | ||S )aI
Overridable helper function to format a single header parameter. By
default, this calls ``self.header_formatter``.
:param name:
The name of the parameter, a string expected to be ASCII only.
:param value:
The value of the parameter, provided as a unicode string.
)r< )r= r r r r r
_render_part s zRequestField._render_partc C sL g }|}t |tr| }|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; itemsappendrF r/ )r= Z header_partspartsiterabler r r r r
_render_parts s
zRequestField._render_partsc C s g }dddg}|D ]*}| j |dr|d|| j | f q| j D ]&\}}||krH|rH|d||f qH|d d|S )z=
Renders the headers for this request field.
Content-Disposition Content-TypeContent-LocationFz%s: %sz
)r: getrI rH r/ )r= linesZ sort_keysZsort_keyZ header_nameZ header_valuer r r
render_headers s
zRequestField.render_headersc C sX |pd| j d< | j d dd| d| jfd| jffg7 < || 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_type:
The 'Content-Type' of the request body.
:param content_location:
The 'Content-Location' of the request body.
z form-datarM rG r r rN rO N)r: r/ rL r7 r8 )r= Zcontent_dispositionr@ Zcontent_locationr r r
rC s
zRequestField.make_multipart)NNN) __name__
__module__ __qualname____doc__r5 r> classmethodrE rF rL rR rC r r r r
r6 } s
#
r6 )r )Z
__future__r Z email.utilsr r r+ Zpackagesr r r r4 updateranger3 r5 Zformat_header_paramobjectr6 r r r r
s&
*