File: //lib/python2.7/site-packages/werkzeug/formparser.pyc
�
o�Dac @ s d Z d d l Z d d l Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m
Z
d d l m Z d d
l m
Z
d d l m Z d d l m Z d d
l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z y d d l m Z Wn' e k
r[d d l m Z d Z n Xe d � Z e j! d � Z" e# d d g � Z$ d d � Z% d d d d d d e& d � Z' d � Z( d e) f d � � YZ* d! � Z+ d" � Z, d# � Z- d$ Z. d% Z/ d& Z0 d' Z1 d( e) f d) � � YZ2 d S(* s�
werkzeug.formparser
~~~~~~~~~~~~~~~~~~~
This module implements the form parsing. It supports url-encoded forms
as well as non-nested multipart uploads.
:copyright: 2007 Pallets
:license: BSD-3-Clause
i����N( t update_wrapper( t chain( t repeat( t teei ( t
exceptions( t BytesIO( t text_type( t to_native( t FileStorage( t Headers( t MultiDict( t parse_options_header( t url_decode_stream( t get_content_length( t get_input_stream( t make_line_iter( t SpooledTemporaryFile( t
TemporaryFilet s ^[ -~]{0,200}[!-~]$t base64s quoted-printablec C sN d } t d k r% t d | d d � S| d k s= | | k rG t d � St � S( s, The stream factory that is used per default.i i� t max_sizet modes wb+i � N( R t NoneR R ( t total_content_lengtht filenamet content_typet content_lengthR ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt default_stream_factory5 s
s utf-8t replacec C s% t | | | | | | | � j | � S( s Parse the form data in the environ and return it as tuple in the form
``(stream, form, files)``. You should only call this method if the
transport method is `POST`, `PUT`, or `PATCH`.
If the mimetype of the data transmitted is `multipart/form-data` the
files multidict will be filled with `FileStorage` objects. If the
mimetype is unknown the input stream is wrapped and returned as first
argument, else the stream is empty.
This is a shortcut for the common usage of :class:`FormDataParser`.
Have a look at :ref:`dealing-with-request-data` for more details.
.. versionadded:: 0.5
The `max_form_memory_size`, `max_content_length` and
`cls` parameters were added.
.. versionadded:: 0.5.1
The optional `silent` flag was added.
:param environ: the WSGI environment to be used for parsing.
:param stream_factory: An optional callable that returns a new read and
writeable file descriptor. This callable works
the same as :meth:`~BaseResponse._get_file_stream`.
:param charset: The character set for URL and url encoded form data.
:param errors: The encoding error behavior.
:param max_form_memory_size: the maximum number of bytes to be accepted for
in-memory stored form data. If the data
exceeds the value specified an
:exc:`~exceptions.RequestEntityTooLarge`
exception is raised.
:param max_content_length: If this is provided and the transmitted data
is longer than this value an
:exc:`~exceptions.RequestEntityTooLarge`
exception is raised.
:param cls: an optional dict class to use. If this is not specified
or `None` the default :class:`MultiDict` is used.
:param silent: If set to False parsing errors will not be caught.
:return: A tuple in the form ``(stream, form, files)``.
( t FormDataParsert parse_from_environ( t environt stream_factoryt charsett errorst max_form_memory_sizet max_content_lengtht clst silent( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt parse_form_dataA s 2 c s � f d � } t | � � S( s@ Helper decorator for methods that exhausts the stream on return.c sg z � | | | | � SWd t | d d � } | d k rB | � n x | j d � } | sE PqE qE WXd S( Nt exhausti i@ i ( t getattrR t read( t selft streamt argst kwargsR( t chunk( t f( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt wrapper� s
( R ( R0 R1 ( ( R0 s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt exhaust_stream~ s
R c B s� e Z d Z d d d d d d e d � Z d � Z d � Z d d � Z e d � � Z
e d � � Z i e
d 6e d
6e d 6Z RS(
s� This class implements parsing of form data for Werkzeug. By itself
it can parse multipart and url encoded form data. It can be subclassed
and extended but for most mimetypes it is a better idea to use the
untouched stream and expose it as separate attributes on a request
object.
.. versionadded:: 0.8
:param stream_factory: An optional callable that returns a new read and
writeable file descriptor. This callable works
the same as :meth:`~BaseResponse._get_file_stream`.
:param charset: The character set for URL and url encoded form data.
:param errors: The encoding error behavior.
:param max_form_memory_size: the maximum number of bytes to be accepted for
in-memory stored form data. If the data
exceeds the value specified an
:exc:`~exceptions.RequestEntityTooLarge`
exception is raised.
:param max_content_length: If this is provided and the transmitted data
is longer than this value an
:exc:`~exceptions.RequestEntityTooLarge`
exception is raised.
:param cls: an optional dict class to use. If this is not specified
or `None` the default :class:`MultiDict` is used.
:param silent: If set to False parsing errors will not be caught.
s utf-8R c C sm | d k r t } n | | _ | | _ | | _ | | _ | | _ | d k rW t } n | | _ | | _ d S( N(
R R R R! R" R# R$ R
R% R& ( R+ R R! R" R# R$ R% R& ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt __init__� s
c C s | j j | � S( N( t parse_functionst get( R+ t mimetypet options( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt get_parse_func� s c C sL | j d d � } t | � } t | � \ } } | j t | � | | | � S( s� Parses the information from the environment as form data.
:param environ: the WSGI environment to be used for parsing.
:return: A tuple in the form ``(stream, form, files)``.
t CONTENT_TYPER ( R5 R
R t parseR ( R+ R R R R6 R7 ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyR � s c C s� | j d k r9 | d k r9 | | j k r9 t j � � n | d k rN i } n | j | | � } | d k r� y | | | | | | � SWq� t k
r� | j s� � q� q� Xn | | j � | j � f S( s� Parses the information from the given stream, mimetype,
content length and mimetype parameters.
:param stream: an input stream
:param mimetype: the mimetype of the data
:param content_length: the content length of the incoming data
:param options: optional mimetype parameters (used for
the multipart boundary for instance)
:return: A tuple in the form ``(stream, form, files)``.
N( R$ R R t RequestEntityTooLargeR8 t
ValueErrorR& R% ( R+ R, R6 R R7 t
parse_func( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyR: � s
c C s� t | j | j | j d | j d | j �} | j d � } | d k rW t d � � n t | t
� rx | j d � } n | j | | | � \ } } | | | f S( NR# R% t boundarys Missing boundaryt ascii(
t MultiPartParserR R! R" R# R% R5 R R< t
isinstanceR t encodeR: ( R+ R, R6 R R7 t parserR> t formt files( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt _parse_multipart� s c C sp | j d k r9 | d k r9 | | j k r9 t j � � n t | | j d | j d | j �} | | | j � f S( NR" R% ( R# R R R; R R! R" R% ( R+ R, R6 R R7 RD ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt _parse_urlencoded s $s multipart/form-datas! application/x-www-form-urlencodeds application/x-url-encodedN(
t __name__t
__module__t __doc__R t TrueR3 R8 R R: R2 RF RG R4 ( ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyR � s" c C s t j | � d k S( s9 Checks if the string given is a valid multipart boundary.N( t _multipart_boundary_ret matchR ( R> ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt is_valid_multipart_boundary s c C sF | d d k r | d t f S| d d k r< | d t f S| t f S( s_ Removes line ending characters and returns a tuple (`stripped_line`,
`is_terminated`).
i����s
i����s
s
( s
s
( s
s
s
s
( RK t False( t line( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt _line_parse s
c C s� g } x� | D]� } t | � } t | � \ } } | sF t d � � n | sP Pq
| d d k r� | r� | d \ } } | | d | d f | d <q
| j d d � } t | � d k r
| j | d j � | d j � f � q
q
Wt | � S( sB Parses multipart headers from an iterable that yields lines (including
the trailing newline symbol). The iterable has to be newline terminated.
The iterable will stop at the line where the headers ended so it can be
further consumed.
:param iterable: iterable of strings that are newline terminated
s* unexpected end of line in multipart headeri s i����s
i t :i ( R RQ R< t splitt lent appendt stripR ( t iterablet resultRP t line_terminatedt keyt valuet parts( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt parse_multipart_headers# s
.t
begin_formt
begin_filet contt endR@ c B s� e Z d d d d d d d � Z d � Z d � Z d � Z d � Z d � Z d
� Z d � Z
d � Z e d
� Z
d � Z d � Z RS( s utf-8R i@ i c C s� | | _ | | _ | | _ | d k r- t n | | _ | d k rH t n | | _ | d d k sm t d � � | d k s� t d � � | | _ d S( Ni i s$ buffer size has to be divisible by 4i s" buffer size has to be at least 1KB(
R! R" R# R R R R
R% t AssertionErrort buffer_size( R+ R R! R" R# R% Rc ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyR3 H s c C s8 | d d !d k s# | d d k r4 | j d � d S| S( s� Internet Explorer 6 transmits the full file name if a file is
uploaded. This function strips the full path if it thinks the
filename is Windows-like absolute.
i i s :\i s \\s \i����( RS ( R+ R ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt _fix_ie_filenameb s #c C s5 x. | D]& } | s Pn | j � } | r | Sq Wd S( s� The terminator might have some additional newlines before it.
There is at least one application that sends additional newlines
before headers (the python setuptools package).
R ( RV ( R+ t iteratorRP ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt _find_terminatork s
c C s t | � � d S( N( R< ( R+ t message( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt failx s c C s/ | j d � } | d k r+ | t k r+ | Sd S( Ns content-transfer-encoding( R5 R t _supported_multipart_encodings( R+ t headerst transfer_encoding( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt get_part_encoding{ s c C sA | j d � } | r: t | � \ } } | j d | j � S| j S( Ns content-typeR! ( R5 R R! ( R+ Rj R R6 t ct_params( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt get_part_charset� s
c C s� t | t � r* | j | j | j � } n | j | � } | j d � } y t | d � } Wn t t f k
r{ d } n X| j
d | d | d | d | � } | | f S( Ns content-types content-lengthi R R R R ( RA t bytest decodeR! R" Rd R5 t intt KeyErrorR< R ( R+ R Rj R R R t container( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt start_file_streaming� s
c C s t j � � d S( N( R R; ( R+ Ro ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt in_memory_threshold_reached� s c C s_ | s | j d � n t | � s6 | j d | � n t | � | j k r[ | j d � n d S( Ns Missing boundarys Invalid boundary: %ss Boundary longer than buffer size( Rh RN RT Rc ( R+ R> ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt validate_boundary� s c c s� d | } | d } t t | d | d | j d | �t � } | j | � } | | k r] d S| | k ry | j d � n x | | k r{t | � } | j d � }
|
d k r� | j d � n t |
� \ }
} | j
| � } | j d � }
| j d
� } | d k r t | |
f f Vn t | |
| f f Vd } x| D]} | s[| j d � n | d
d k r�| j
� } | | | f k r�Pq�n | d k r�| d k r�d } n y t j | | � } Wq�t k
r�| j d � q�Xn | rt | f Vd } n | d d k r$d } d } n | d } d } t | | f Vq?Wt d � � | d k rmt | f Vn t d f Vq| Wd S( s, Generate parts of
``('begin_form', (headers, name))``
``('begin_file', (headers, name, filename))``
``('cont', bytestring)``
``('end', None)``
Always obeys the grammar
parts = ( begin_form cont* end |
begin_file cont* end )*
s --t limitRc t
cap_at_bufferNs, Expected boundary at start of multipart datas content-dispositions" Missing Content-Disposition headert nameR R s unexpected end of streami R t base64_codecs' could not decode transfer encoded chunki����s
i����s unexpected end of parts
s
( R s
s
s
( R R Rc t _empty_string_iterRf Rh R] R5 R R Rl t _begin_formt _begin_filet rstript codecsRp t Exceptiont _contR< t _end( R+ t fileR> R Rx t next_partt last_partRe t
terminatorRj t dispositiont extraRk Ry R t bufRP t cutoff( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt parse_lines� sl
c c s� d } x�| j | | | � D]j\ } } | t k rv | \ } } } t }
t } | j | | | � \ } } | j }
q | t k r� | \ } } t }
g } | j }
| j d k } q | t
k r|
| � | r�| t | � 7} | | j k r| j | � qq�q | t
k r |
rK| j d � d | t | | | d | �f f Vq�| j | � } d | d j | � j | | j � f f Vq q Wd S( sX Generate ``('file', (name, val))`` and
``('form', (name, val))`` parts.
i R� Rj RD R N( R� R} RK RO Rt t writeR| RU R# R R� RT Ru R� t seekR Rn t joinRp R" ( R+ R� R> R t in_memoryt elltt ellRj Ry R t is_filet guard_memoryRs t _writet part_charset( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt parse_parts s: "
#c C s` t | j | | | � d � \ } } d � | D� } d � | D� } | j | � | j | � f S( Ni c s s) | ] } | d d k r | d Vq d S( i RD i N( ( t .0t p( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pys <genexpr>F s c s s) | ] } | d d k r | d Vq d S( i R� i N( ( R� R� ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pys <genexpr>G s ( R R� R% ( R+ R� R> R t
formstreamt
filestreamRD RE ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyR: B s
!Ni ( RH RI R R3 Rd Rf Rh Rl Rn Rt Ru Rv RK R� R� R: ( ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyR@ G s"
h /(3 RJ R t ret functoolsR t itertoolsR R R R R t _compatR R R t datastructuresR R R
t httpR t urlsR t wsgiR
R R t tempfileR t ImportErrorR R R{ t compileRL t frozensetRi R RK R' R2 t objectR RN RQ R] R| R} R� R� R@ ( ( ( s5 /tmp/pip-build-W6Gm0N/Werkzeug/werkzeug/formparser.pyt <module> sX
5 �