o
ai! @ 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 | r t | 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)filenamedefault r
/builddir/build/BUILDROOT/alt-python310-pip-21.3.1-5.el8.x86_64/opt/alt/python310/lib/python3.10/site-packages/pip/_vendor/urllib3/fields.pyguess_content_type
s r c s t tjr d t fdddD s0d| f }z|d W |S ttfy/ Y nw tjr8 d t j
d d| f tjrM 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
).0chvaluer
r + s z.format_header_param_rfc2231..z"\
%s="%s"asciiz%s*=%s)
isinstancer binary_typedecodeanyencodeUnicodeEncodeErrorUnicodeDecodeErrorPY2emailutilsencode_rfc2231)namer resultr
r r format_header_param_rfc2231 s"
r# z%22z\\)"\c C s& i | ]}|d vrt |d|qS )) z%{:02X})r unichrformat)r ccr
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 needler
r
r
W s z%_replace_multiple..)r2 compilejoinkeyssub)r r/ r0 patternr" r
r. r _replace_multipleR s r; 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 r; _HTML5_REPLACEMENTS)r! r r
r
r format_header_param_html5_ s
r= c @ sT 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 | _|rt|| _|| _d S r )_name _filenamedataheadersdictheader_formatter)selfr! rA r rB rD r
r
r __init__ s
zRequestField.__init__c C s` t |trt|dkr|\}}}n|\}}t|}nd}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 rD ) content_type)r tuplelenr make_multipart)cls fieldnamer rD r rA rH
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.
)rD )rE r! r r
r
r _render_part s zRequestField._render_partc C sL g }|}t |tr
| }|D ]\}}|dur || || qd|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 rC itemsappendrP r7 )rE 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 ]\}}||vr6|r6|d||f q#|d d|S )z=
Renders the headers for this request field.
)Content-Disposition Content-TypeContent-LocationFz%s: %sz
)rB getrS rR r7 )rE lines sort_keyssort_key header_name 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-datarX rQ r! r rY rZ N)rB r7 rW r? r@ )rE content_dispositionrH content_locationr
r
r rK s
zRequestField.make_multipart)NNN) __name__
__module__ __qualname____doc__r= rF classmethodrO rP rW ra rK r
r
r
r r> ~ s
#
r> )r )
__future__r email.utilsr r r2 packagesr r r# r< updateranger; r= format_header_paramobjectr> r
r
r
r s&
+