3
Z'íc! ã @ s d dl mZ d dlZd dlZd dlZddlmZ dddZdd Z d
d d Z
e
j d
d e d dD dd Z
dd ZeZG dd deZdS )é )Úabsolute_importNé )Úsixúapplication/octet-streamc C s | rt j| 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)ÚfilenameÚdefault© r
ú1/tmp/pip-build-gk9425m9/urllib3/urllib3/fields.pyÚguess_content_type
s r c s¢ t tjr jd t fdddD sdd| f }y|jd W n ttfk
r^ Y nX |S tjrt jd t j
j d d| f tjr jd 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``.
:ret:
An RFC-2231-formatted unicode string.
zutf-8c 3 s | ]}| kV qd S )Nr
)Ú.0Úch)Úvaluer
r ú <genexpr>+ s z.format_header_param_rfc2231.<locals>.<genexpr>z"\
z%s="%s"Úasciiz%s*=%s) Ú
isinstancer Ú binary_typeÚdecodeÚanyÚencodeÚUnicodeEncodeErrorÚUnicodeDecodeErrorÚPY2ÚemailÚutilsÚencode_rfc2231)Únamer Úresultr
)r r Úformat_header_param_rfc2231 s
r z%22z\\)ú"ú\c C s& i | ] }|dkrdj |tj|qS )é z%{:02X})r" )Úformatr Úunichr)r
Úccr
r
r ú
<dictcomp>J s r& é c s: fdd}t jdjdd j D }|j|| }|S )Nc s | j d S )Nr )Úgroup)Úmatch)Úneedles_and_replacementsr
r ÚreplacerS s z#_replace_multiple.<locals>.replacerú|c S s g | ]}t j|qS r
)ÚreÚescape)r
Zneedler
r
r ú
<listcomp>W s z%_replace_multiple.<locals>.<listcomp>)r- ÚcompileÚjoinÚkeysÚsub)r r* r+ Úpatternr r
)r* r Ú_replace_multipleR s
r5 c C s, t |tjr|jd}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.
zutf-8z%s="%s")r r r r r5 Ú_HTML5_REPLACEMENTS)r r r
r
r Úformat_header_param_html5_ s
r7 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 )N)Ú_nameÚ _filenameÚdataÚheadersÚdictÚheader_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 ÚtupleÚlenr Úmake_multipart)ÚclsÚ fieldnamer r> r r; rB Ú
request_paramr
r
r Ú from_tuples s
zRequestField.from_tuplesc C s | j ||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 sP g }|}t |tr|j }x*|D ]"\}}|dk r |j| j|| q W dj|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"; ...`.
Nz; )r r= ÚitemsÚappendrJ r1 )r? Ú header_partsÚpartsÚiterabler r r
r
r Ú
_render_partsÐ s
zRequestField._render_partsc C s g }dddg}x2|D ]*}| j j|dr|jd|| j | f qW x4| j j D ]&\}}||krN|rN|jd||f qNW |jd dj|S )z=
Renders the headers for this request field.
zContent-Dispositionz Content-TypezContent-LocationFz%s: %sz
)r< ÚgetrL rK r1 )r? ÚlinesÚ sort_keysÚsort_keyÚ header_nameÚ header_valuer
r
r Úrender_headersæ s
zRequestField.render_headersc C sX |pd| j d< | j d djd| jd| 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-datazContent-Dispositionz; Ú r r z Content-TypezContent-LocationN)r< r1 rP r9 r: )r? Úcontent_dispositionrB Úcontent_locationr
r
r rE ù s
zRequestField.make_multipart)NNN) Ú__name__Ú
__module__Ú __qualname__Ú__doc__r7 r@ Ú classmethodrI rJ rP rW rE r
r
r
r r8 ~ s
#
r8 )r é )Ú
__future__r Ú email.utilsr r r- Úpackagesr r r r6 ÚupdateÚranger5 r7 Úformat_header_paramÚobjectr8 r
r
r
r Ú<module> s
+