a
lj! @ s d dl mZ d dlZd dlZd dlZddlmZ dddZdd Z 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.9/site-packages/pip/_vendor/urllib3/fields.pyguess_content_type
s r c s t tjr d t fdddD sbd| f }z|d W n ttfy\ Y n0 |S tjrr 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 | ]}| v V qd S Nr ).0Zchvaluer r
+ 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\\)"\c C s& i | ] }|d vrt |d|qS )) z%{:02X})r Zunichrformat)r Zccr r r
J s r$ c s: fdd}t ddd D }||| }|S )Nc s | d S )Nr )group)matchneedles_and_replacementsr r
replacerS s z#_replace_multiple..replacer|c S s g | ]}t |qS r )reescape)r Zneedler r r
W r z%_replace_multiple..)r, compilejoinkeyssub)r r) r* patternr r r( r
_replace_multipleR s r4 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 r4 _HTML5_REPLACEMENTS)r r r r r
format_header_param_html5_ s
r6 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 r: 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 r: rA 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 ]"\}}|dur || || 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< itemsappendrG r0 )r> Z header_partspartsiterabler r r r r
_render_parts s
zRequestField._render_partsc C s g }g d}|D ]*}| j |dr|d|| j | f q| j D ]&\}}||vrF|rF|d||f qF|d d|S )z=
Renders the headers for this request field.
)Content-Disposition Content-TypeContent-LocationFz%s: %sz
)r; getrJ rI r0 )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-datarN rH r r rO rP N)r; r0 rM r8 r9 )r> Zcontent_dispositionrA Zcontent_locationr r r
rD s
zRequestField.make_multipart)NNN) __name__
__module__ __qualname____doc__r6 r? classmethodrF rG rM rS rD r r r r
r7 ~ s
#
r7 )r )Z
__future__r Z email.utilsr r r, Zpackagesr r r r5 updateranger4 r6 Zformat_header_paramobjectr7 r r r r
s$
+