U
|
Þ=®d]Ù ã @ s d dl mZ d dlZd dlZd dlZd dlZd dlZd dlm Z d dl
|
m
|
Z
|
d dl m Z d dl mZ d dlmZ d dlmZ d d lmZ d d
|
lmZ d d lmZ d d lmZ d dlmZ d dlmZ d dlmZ d dlmZ d dl m Z d dl m Z d dl m Z d dl m Z d dl m!Z! d dl m"Z" d dl m#Z# d dl$m%Z% d dl$m&Z& d dl$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*m0Z0 d d$l1m2Z2 d d%l1m3Z3 d d&l4m5Z5 d d'l4m6Z6 d d(l7m8Z8 d d)l9m:Z: d d*l;m<Z< d d+l;m=Z= ej>r<d d,l?m@Z@ d d-l?mAZA d dlBZCdWd0d1d2d3d3d4d5d6d7ZDdXd0d3d3d8d9d:d;ZEd0d<d=d>d?ZFejGd@e#dAZHG dBdC dCZIG dDdE dEeJZKG dFdG dGZLdHdHdIdJdKdLZMdYdNdId1dOdPdQdRZNG dSdT dTe:ZOejPG dUdV dVZQdS )Zé )Ú annotationsN)Ú defaultdict)Údatetime)ÚBytesIO)Úchain)Úrandom)Ú TemporaryFile)Útime)Úunquote)Úurlsplit)Ú
|
urlunsplité )Ú _get_environ)Ú_make_encode_wrapper)Ú_wsgi_decoding_dance)Ú_wsgi_encoding_dance)Ú Authorization)Ú CallbackDict)ÚCombinedMultiDict)ÚEnvironHeaders)Ú FileMultiDict)ÚHeaders)Ú MultiDict)Ú dump_cookie)Údump_options_header)Ú parse_cookie)Ú
|
parse_date)Úparse_options_header)ÚData)ÚEpilogue)ÚField)ÚFile)ÚMultipartEncoder)ÚPreamble)Ú
|
_urlencode)Ú
|
iri_to_uri)Úcached_property)Úget_content_type)ÚRequest)ÚResponse)ÚClosingIterator)Úget_current_url)ÚWSGIApplication)ÚWSGIEnvironmentTé Ð zt.Mapping[str, t.Any]ÚboolÚintú
|
str | Nonez tuple[t.IO[bytes], int, str])ÚdataÚ use_tempfileÚ thresholdÚboundaryÚcharsetÚreturnc sê |dk rt jdtdd nd}|dkr8dt t }t dd |rfd d
|
d fd d }nj}t| ¡ }|| t
|
dd¡ t | D ]"\}}t |dd} | dk rpt |dt |dd}
|
t |dd} | dkrò|
|
rît |
|
¡d pðd} |j} | d| fg¡ |
|
dkr*|| t|| d¡ n|| t||
|
| d¡ | d} | sTq¸|| t| dd¡ qBqt|tst|}|| t|t d¡ || t| |¡dd¡ q|| tdd¡ ¡ } d¡ ||fS )a Encode a dict of values (either strings or file descriptors or
|
:class:`FileStorage` objects.) into a multipart encoded string stored
|
in a file descriptor.
|
|
.. versionchanged:: 2.3
|
The ``charset`` parameter is deprecated and will be removed in Werkzeug 3.0
|
NúIThe 'charset' parameter is deprecated and will be removed in Werkzeug 3.0é ©Ú
|
stacklevelúutf-8z ---------------WerkzeugFormPart_r FÚbytesr0 )Úsr7 c st r | ¡S t| }| kr. | ¡ n6t tjt td¡}| ¡ ¡ | | ¡ |d |7 |S d S )Nzwb+T)ÚwriteÚlenÚtÚcastÚIOr= r Úgetvalue)r> ÚlengthZ
|
new_stream©Zon_diskÚstreamr4 Ú total_length© úDd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\werkzeug/test.pyÚ write_binaryY s
|
|
z-stream_encode_multipart.<locals>.write_binaryó )r2 ÚreadÚfilenameÚnameÚ content_typezapplication/octet-streamú Content-Type)rO Úheaders)rO rN rR i @ T)r2 Z more_data)ÚwarningsÚwarnÚDeprecationWarningr r r r? r" ÚencodeZ
|
send_eventr# Ú
|
_iter_dataÚgetattrÚ mimetypesÚ
|
guess_typerR Úupdater r! r Ú
|
isinstanceÚstrr r ÚtellÚseek)r2 r3 r4 r5 r6 rK ÚencoderÚkeyÚvalueÚreaderrN rP rR ÚchunkrE rI rF rJ Ústream_encode_multipart8 sf ý
|
ÿý
|
ÿÿ ÿ
|
re ztuple[str, bytes])Úvaluesr5 r6 r7 c C s" t | d||d\}}}|| ¡ fS )zæLike `stream_encode_multipart` but returns a tuple in the form
|
(``boundary``, ``data``) where data is bytes.
|
|
.. versionchanged:: 2.3
|
The ``charset`` parameter is deprecated and will be removed in Werkzeug 3.0
|
F)r3 r5 r6 )re rM )rf r5 r6 rG rE rI rI rJ Úencode_multipart s ÿ rg z t.Iterator[tuple[str, t.Any]])r2 r7 c c s^ t | tr | jddE dH n<| ¡ D ]2\}}t |trN|D ]}||fV q<q&||fV q&dS )zÏIterate over a mapping that might have a list of values, yielding
|
all key, value pairs. Almost like iter_multi_items but only allows
|
lists, not tuples, of values so tuples can be used for files.
|
T)ZmultiN)r\ r ÚitemsÚlist)r2 ra rb ÚvrI rI rJ rW ® s
|
|
rW Ú_TAnyMultiDict)Úboundc @ sÎ e Zd ZU dZdZdZeZddlZe ej
|
Z [de d< de d < d
|
e d < de d < d e d< deddddd
|
dddddddddddddddd d d Z ed d d d!d"d#Zdd$dd%d&d'Ze ddddd(d)d*Zedd+d,d-Zejddd.d/d-Zedd+d0d1Zejddd.d2d1Zedd+d3d4Zejddd.d5d4Zed6d+d7d8Zedd+d9d:Zejddd.d;d:Zdd<d=d>d?d@ZddAddBdCdDZedAd+dEdFZejdAdd.dGdFZedHd+dIdJZ e jdHdd.dKdJZ ed
|
d+dLdMZ e jd
|
dd.dNdMZ edd+dOdPZ e jddd.dQdPZ edAd+dRdSZ e jddd.dTdSZ edd+dUdVZ edWd+dXdYZ!dd+dZd[Z"dd+d\d]Z#d d+d^d_Z$dfd`dadbdcddZ%dS )gÚEnvironBuilderaP This class can be used to conveniently create a WSGI environment
|
for testing purposes. It can be used to quickly create WSGI environments
|
or request objects from arbitrary data.
|
|
The signature of this class is also used in some other places as of
|
Werkzeug 0.5 (:func:`create_environ`, :meth:`Response.from_values`,
|
:meth:`Client.open`). Because of this most of the functionality is
|
available through the constructor alone.
|
|
Files and regular form data can be manipulated independently of each
|
other with the :attr:`form` and :attr:`files` attributes, but are
|
passed with the same argument to the constructor: `data`.
|
|
`data` can be any of these values:
|
|
- a `str` or `bytes` object: The object is converted into an
|
:attr:`input_stream`, the :attr:`content_length` is set and you have to
|
provide a :attr:`content_type`.
|
- a `dict` or :class:`MultiDict`: The keys have to be strings. The values
|
have to be either any of the following objects, or a list of any of the
|
following objects:
|
|
- a :class:`file`-like object: These are converted into
|
:class:`FileStorage` objects automatically.
|
- a `tuple`: The :meth:`~FileMultiDict.add_file` method is called
|
with the key and the unpacked `tuple` items as positional
|
arguments.
|
- a `str`: The string is set as form data for the associated key.
|
- a file-like object: The object content is loaded in memory and then
|
handled like a regular `str` or a `bytes`.
|
|
:param path: the path of the request. In the WSGI environment this will
|
end up as `PATH_INFO`. If the `query_string` is not defined
|
and there is a question mark in the `path` everything after
|
it is used as query string.
|
:param base_url: the base URL is a URL that is used to extract the WSGI
|
URL scheme, host (server name + server port) and the
|
script root (`SCRIPT_NAME`).
|
:param query_string: an optional string or dict with URL parameters.
|
:param method: the HTTP method to use, defaults to `GET`.
|
:param input_stream: an optional input stream. Do not specify this and
|
`data`. As soon as an input stream is set you can't
|
modify :attr:`args` and :attr:`files` unless you
|
set the :attr:`input_stream` to `None` again.
|
:param content_type: The content type for the request. As of 0.5 you
|
don't have to provide this when specifying files
|
and form data via `data`.
|
:param content_length: The content length for the request. You don't
|
have to specify this when providing data via
|
`data`.
|
:param errors_stream: an optional error stream that is used for
|
`wsgi.errors`. Defaults to :data:`stderr`.
|
:param multithread: controls `wsgi.multithread`. Defaults to `False`.
|
:param multiprocess: controls `wsgi.multiprocess`. Defaults to `False`.
|
:param run_once: controls `wsgi.run_once`. Defaults to `False`.
|
:param headers: an optional list or :class:`Headers` object of headers.
|
:param data: a string or dict of form data or a file-object.
|
See explanation above.
|
:param json: An object to be serialized and assigned to ``data``.
|
Defaults the content type to ``"application/json"``.
|
Serialized with the function assigned to :attr:`json_dumps`.
|
:param environ_base: an optional dict of environment defaults.
|
:param environ_overrides: an optional dict of environment overrides.
|
:param auth: An authorization object to use for the
|
``Authorization`` header value. A ``(username, password)`` tuple
|
is a shortcut for ``Basic`` authorization.
|
|
.. versionchanged:: 2.3
|
The ``charset`` parameter is deprecated and will be removed in Werkzeug 3.0
|
|
.. versionchanged:: 2.1
|
``CONTENT_TYPE`` and ``CONTENT_LENGTH`` are not duplicated as
|
header keys in the environ.
|
|
.. versionchanged:: 2.0
|
``REQUEST_URI`` and ``RAW_URI`` is the full raw URI including
|
the query string, not only the path.
|
|
.. versionchanged:: 2.0
|
The default :attr:`request_class` is ``Request`` instead of
|
``BaseRequest``.
|
|
.. versionadded:: 2.0
|
Added the ``auth`` parameter.
|
|
.. versionadded:: 0.15
|
The ``json`` param and :meth:`json_dumps` method.
|
|
.. versionadded:: 0.15
|
The environ has keys ``REQUEST_URI`` and ``RAW_URI`` containing
|
the path before percent-decoding. This is not part of the WSGI
|
PEP, but many WSGI servers include it.
|
|
.. versionchanged:: 0.6
|
``path`` and ``base_url`` can now be unicode strings that are
|
encoded with :func:`iri_to_uri`.
|
zHTTP/1.1)r r r NzMultiDict | NoneÚ_argsr1 Ú _query_stringzt.IO[bytes] | NoneÚ _input_streamÚ_formzFileMultiDict | NoneÚ_filesú/ÚGETFr] z t.Mapping[str, str] | str | Noneú
|
int | Nonezt.IO[str] | Noner/ z,Headers | t.Iterable[tuple[str, str]] | Nonez:None | (t.IO[bytes] | str | bytes | t.Mapping[str, t.Any])z t.Mapping[str, t.Any] | Nonez&Authorization | tuple[str, str] | NoneÚNone)ÚpathÚbase_urlÚ query_stringÚmethodÚ input_streamrP Úcontent_lengthÚ errors_streamÚ multithreadÚ multiprocessÚrun_oncerR r2 Ú environ_baseÚenviron_overridesr6 ÚmimetypeÚjsonÚauthr7 c C s° t |}|d k r$|d|kr$tdt|}|d krF|d|krF|j}|d k r`tjdtdd nd}|| _t|j | _ || _
|
|d k rt||dkr|nd d}|| _ t |t r´|| _n(|d krÄt }nt |tsÖt|}|| _|| _| d kròt } nt | tst| } | | _|d k r || _|d kr,tj}|| _| | _|
|
| _| | _|| _|| _ || _ || _ d| _ |d k r¢t |t rt!d |d
|
|d d }| j "d | #¡ ¡ |d k rÚ| d k r¾t$d| %|¡} | jd krÚd| _| r|d k ròt$dt&| dr| '¡ } t | t r | (| j¡} t | t)rLt*| | _ | j d krt+| | _ nPt,| D ]F\}}t |t t-fsxt&|dr| .||¡ n| j/ 0|¡ 1|¡ qT|d k r¬|| _2d S )Nú?z6Query string is defined in the path and as an argumentr8 r9 r: r< ©r6 FÚbasicr r )ÚusernameÚpasswordr z can't provide both json and datazapplication/jsonz#can't provide input stream and datarM )3r Ú
|
ValueErrorr ÚqueryrS rT rU r6 r% rw Ú request_urirx r\ r] ry r Úargsrz r rR rP ÚsysÚstderrr} r~ r r r r r{ r| ÚclosedÚtupler ÚsetZ to_headerÚ TypeErrorÚ
|
json_dumpsÚhasattrrM rV r= r r@ rW ÚdictÚ_add_file_from_dataÚformZsetlistdefaultÚappendr )Úselfrw rx ry rz r{ rP r| r} r~ r r rR r2 r r r6 r r r
Zpath_sr ra rb rI rI rJ Ú__init__9 s ü ÿ
|
|
|
|
|
ÿ
|
|
|
|
|
|
zEnvironBuilder.__init__r- út.Any)ÚenvironÚkwargsr7 c K s t t|}t|d | |d | d¡t|d ¡t|d |d |d | dd ¡| d
|
d ¡|d |d |d |d |d }| |¡ | f |S )a- Turn an environ dict back into a builder. Any extra kwargs
|
override the args extracted from the environ.
|
|
.. versionchanged:: 2.0
|
Path and query values are passed through the WSGI decoding
|
dance to avoid double encoding.
|
|
.. versionadded:: 0.15
|
Ú PATH_INFOúwsgi.url_schemeÚHostÚ SCRIPT_NAMEÚ QUERY_STRINGÚREQUEST_METHODú
|
wsgi.inputrQ NúContent-Lengthú wsgi.errorsúwsgi.multithreadúwsgi.multiprocessú wsgi.run_once) rw rx ry rz r{ rP r| r} r~ r r rR )r r r Ú_make_base_urlÚpopr[ )Úclsr r rR ÚoutrI rI rJ Ú from_environª s(
|
|
ý
|
|
|
ð
|
zEnvironBuilder.from_environzDt.IO[bytes] | tuple[t.IO[bytes], str] | tuple[t.IO[bytes], str, str])ra rb r7 c C s0 t |tr | jj|f| n| j ||¡ dS )z=Called in the EnvironBuilder to add files from the data dict.N)r\ r ÚfilesZadd_file)r ra rb rI rI rJ r Ë s
|
z"EnvironBuilder._add_file_from_data)ÚschemeÚhostÚ script_rootr7 c C s t | ||ddf d¡d S )NÚ rs )r Úrstrip)r² r³ r´ rI rI rJ r¬ Ö s z EnvironBuilder._make_base_url©r7 c C s | | j| j| j¡S )z`The base URL is used to extract the URL scheme, host name,
|
port, and root path.
|
)r¬ Ú
|
url_schemer³ r´ ©r rI rI rJ rx Ú s zEnvironBuilder.base_url)rb r7 c C sT |d krd}d}d}n"t |\}}}}}|s0|r8td| d¡| _|| _|| _d S )NÚhttpÚ localhostrµ z4base url must not contain a query string or fragmentrs )r r r¶ r´ r³ r¸ )r rb r² Únetlocr´ ÚqsÚanchorrI rI rJ rx á s c C s6 | j d¡}|dkr2| js2| jr$dS | jr.dS dS |S )z¯The content type for the request. Reflected from and to
|
the :attr:`headers`. Do not set if you set :attr:`files` or
|
:attr:`form` for auto detection.
|
rQ Númultipart/form-dataú!application/x-www-form-urlencoded)rR Úgetrp rr rq ©r ÚctrI rI rJ rP ï s zEnvironBuilder.content_typec C s& |d kr| j dd ¡ n
|
|| j d< d S ©NrQ )rR r ©r rb rI rI rJ rP þ s c C s | j }|r | d¡d ¡ S dS )zYThe mimetype (content type without charset etc.)
|
|
.. versionadded:: 0.14
|
ú;r N)rP ÚsplitÚstripr rI rI rJ r s zEnvironBuilder.mimetypec C s t || j| _d S ©N)r' r6 rP rÅ rI rI rJ r s zt.Mapping[str, str]c s4 ddd fdd }t j dd¡d }t||S ) zÈThe mimetype parameters as dict. For example if the
|
content type is ``text/html; charset=utf-8`` the params would be
|
``{'charset': 'utf-8'}``.
|
|
.. versionadded:: 0.14
|
r rv )Údr7 c s t j| jd< d S rÄ )r r rR )rÊ r¹ rI rJ Ú on_update s z1EnvironBuilder.mimetype_params.<locals>.on_updatez content-typerµ r )r rR rÁ r )r rË rÊ rI r¹ rJ Úmimetype_params s z EnvironBuilder.mimetype_paramsc C s | j jdtdS )z¬The content length as integer. Reflected from and to the
|
:attr:`headers`. Do not set if you set :attr:`files` or
|
:attr:`form` for auto detection.
|
r§ )Útype)rR rÁ r0 r¹ rI rI rJ r| ! s z EnvironBuilder.content_lengthc C s* |d kr| j dd ¡ nt|| j d< d S )Nr§ )rR r r] rÅ rI rI rJ r| ) s ztype[_TAnyMultiDict]rk )rO Ústorager7 c C s: | j dk rtdt| |}|dkr6| }t| || |S )zÑCommon behavior for getting the :attr:`form` and
|
:attr:`files` properties.
|
|
:param name: Name of the internal cached attribute.
|
:param storage: Storage class used for the data.
|
Nzan input stream is defined)r{ ÚAttributeErrorrX Úsetattr)r rO rÎ ÚrvrI rI rJ Ú _get_form0 s
|
|
zEnvironBuilder._get_formr )rO rb r7 c C s d| _ t| || dS )zÐCommon behavior for setting the :attr:`form` and
|
:attr:`files` properties.
|
|
:param name: Name of the internal cached attribute.
|
:param value: Value to assign to the attribute.
|
N)rp rÐ )r rO rb rI rI rJ Ú _set_formB s zEnvironBuilder._set_formc C s | dt¡S )z$A :class:`MultiDict` of form values.rq )rÒ r r¹ rI rI rJ r L s zEnvironBuilder.formc C s | d|¡ d S )Nrq ©rÓ rÅ rI rI rJ r Q s r c C s | dt¡S )zrA :class:`FileMultiDict` of uploaded files. Use
|
:meth:`~FileMultiDict.add_file` to add new files.
|
rr )rÒ r r¹ rI rI rJ r± U s zEnvironBuilder.filesc C s | d|¡ d S )Nrr rÔ rÅ rI rI rJ r± \ s c C s | j S )zôAn optional input stream. This is mutually exclusive with
|
setting :attr:`form` and :attr:`files`, setting it will clear
|
those. Do not provide this if the method is not ``POST`` or
|
another method that has a body.
|
)rp r¹ rI rI rJ r{ ` s zEnvironBuilder.input_streamc C s || _ d | _d | _d S rÉ )rp rq rr rÅ rI rI rJ r{ i s c C s. | j dkr(| jdk r$t| j| jdS dS | j S )ziThe query string. If you set this to a string
|
:attr:`args` will no longer be available.
|
N©Úencodingrµ )ro rn r$ r6 r¹ rI rI rJ ry o s
|
|
|
zEnvironBuilder.query_stringc C s || _ d | _d S rÉ ©ro rn rÅ rI rI rJ ry z s c C s* | j dk rtd| jdkr$t | _| jS )z(The URL arguments as :class:`MultiDict`.Nza query string is defined)ro rÏ rn r r¹ rI rI rJ r s
|
|
|
zEnvironBuilder.argsc C s d | _ || _d S rÉ r× rÅ rI rI rJ r s c C s | j dd¡d S )z4The server name (read-only, use :attr:`host` to set)ú:r r )r³ rÇ r¹ rI rI rJ Ú server_name s zEnvironBuilder.server_namer0 c C sP | j dd¡}t|dkr>zt|d W S tk
|
r< Y nX | jdkrLdS dS )z?The server port as integer (read-only, use :attr:`host` to set)rØ r r9 Úhttpsi» éP )r³ rÇ r@ r0 r r¸ )r ÚpiecesrI rI rJ Ú server_port s
|
zEnvironBuilder.server_portc C s& z | ¡ W n tk
|
r Y nX d S rÉ )ÚcloseÚ Exceptionr¹ rI rI rJ Ú__del__¡ s zEnvironBuilder.__del__c C sh | j r
|
dS z| j ¡ }W n tk
|
r0 d}Y nX |D ]&}z | ¡ W q6 tk
|
rZ Y q6X q6d| _ dS )z±Closes all files. If you put real :class:`file` objects into the
|
:attr:`files` dict you can call this method to automatically close
|
them all in one go.
|
NrI T)r r± rf rÏ rÞ rß )r r± ÚfrI rI rJ rÞ § s
|
zEnvironBuilder.closec s$ j } j} j} j}|dk rP| ¡ }| dd¡ | ¡ }| |¡ || }n|dkr jdkrh jnd}tt j j
|
g|d\}}}| d| d}n6|d krÌt j jd
|
d ¡} t | }t| }nt }i }
|
jrè|
|
j¡ d d d fdd } t j j} |
|
j| j| jt j j| | jt j j j j j | j j j j!d¡ j" #¡ } | $d¡ | $d¡ |dk r||
|
d< |dk r®t||
|
d< t%t&}| '¡ D ]*\}}|d| (¡ )dd¡ *|¡ q¾| +¡ D ]\}}d ,|¡|
|
|< qò j-r |
|
j-¡ |
|
S )zÝReturn the built environ.
|
|
.. versionchanged:: 0.15
|
The content type and length headers are set based on
|
input stream detection. Previously this only set the WSGI
|
keys.
|
Nr r9 r¿ r< r z ; boundary="ú"rÀ rÕ Úasciir] )Úxr7 c s t t| jd jS )NrÕ )r r
|
r6 )rä r¹ rI rJ Ú _path_encodeÞ s z0EnvironBuilder.get_environ.<locals>._path_encode)r¥ r£ r r¤ Z REQUEST_URIZRAW_URIZ SERVER_NAMEZ SERVER_PORTZ HTTP_HOSTZSERVER_PROTOCOLz wsgi.versionr¡ r¦ r¨ r© rª r« rQ r§ Ú CONTENT_TYPEÚCONTENT_LENGTHZHTTP_ú-Ú_ú, ).r{ r| r rP r^ r_ r6 re r r r± r$ rV r@ r r r[ r r rz r´ rw ry rÙ r] rÝ r³ Úserver_protocolÚ wsgi_versionr¸ r} r~ r r rR ÚcopyÚremover ri Z to_wsgi_listÚupperÚreplacer rh Újoinr )r r{ r| r rP Z start_posZend_posr6 r5 Z form_encodedÚresultrå Zraw_urirR Zcombined_headersra rb rf rI r¹ rJ Ú get_environ¹ s|
|
|
ÿ
|
íÿ
|
|
|
|
|
$ zEnvironBuilder.get_environztype[Request] | Noner( )r® r7 c C s |dkr| j }|| ¡ S )z¨Returns a request with the data. If the request class is not
|
specified :attr:`request_class` is used.
|
|
:param cls: The request wrapper to use.
|
N)Ú request_classró )r r® rI rI rJ Ú get_request s zEnvironBuilder.get_request)rs NNrt NNNNFFFNNNNNNNN)N)&Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__rë rì r( rô r Ú staticmethodÚdumpsr Ú__annotations__r Ú classmethodr° r r¬ Úpropertyrx ÚsetterrP r rÌ r| rÒ rÓ r r± r{ ry r rÙ rÝ rà rÞ ró rõ rI rI rI rJ rm Á sª
|
c
|
ì6q
|
|
Yrm c @ s e Zd ZdZdS )ÚClientRedirectErrorzIf a redirect loop is detected when using follow_redirects=True with
|
the :cls:`Client`, then this exception is raised.
|
N)rö r÷ rø rù rI rI rI rJ r s r c @ s e Zd ZdZdHdddddd d
|
d Zed d ddZdIdddddddZdJddddddddddddddd Zddd ddddddd d d Z d!dd"d#d$Z
|
ddd%dd&d'd(Z dKd!dd)d*d+d,Z dLd-dd-d.d/d0Z ddd1ddddd-d2d3d4Zddd-d5d6d7Zddd-d5d8d9Zddd-d5d:d;Zddd-d5d<d=Zddd-d5d>d?Zddd-d5d@dAZddd-d5dBdCZddd-d5dDdEZdd dFdGZdS )MÚClienta± Simulate sending requests to a WSGI application without running a WSGI or HTTP
|
server.
|
|
:param application: The WSGI application to make requests to.
|
:param response_wrapper: A :class:`.Response` class to wrap response data with.
|
Defaults to :class:`.TestResponse`. If it's not a subclass of ``TestResponse``,
|
one will be created.
|
:param use_cookies: Persist cookies from ``Set-Cookie`` response headers to the
|
``Cookie`` header in subsequent requests. Domain and path matching is supported,
|
but other cookie parameters are ignored.
|
:param allow_subdomain_redirects: Allow requests to follow redirects to subdomains.
|
Enable this if the application handles subdomains and redirects between them.
|
|
.. versionchanged:: 2.3
|
Simplify cookie implementation, support domain and path matching.
|
|
.. versionchanged:: 2.1
|
All data is available as properties on the returned response object. The
|
response cannot be returned as a tuple.
|
|
.. versionchanged:: 2.0
|
``response_wrapper`` is always a subclass of :class:``TestResponse``.
|
|
.. versionchanged:: 0.5
|
Added the ``use_cookies`` parameter.
|
NTFr, ztype[Response] | Noner/ rv )Ú applicationÚresponse_wrapperÚ use_cookiesÚallow_subdomain_redirectsr7 c C sb || _ |d thkrt}nt|ts2tdt|fi }t tjd |¡| _|rRi | _ nd | _ || _
|
d S )NZWrapperTestResponseÚ TestResponse) r r) r r\ rÍ rA rB ÚTyper Ú_cookiesr )r r r r r rI rI rJ r @ s
|
ýzClient.__init__zt.Iterable[Cookie] | Noner· c C s( t jdtdd | jd kr d S | j ¡ S )NzuThe 'cookie_jar' attribute is a private API and will be removed in Werkzeug 3.0. Use the 'get_cookie' method instead.r9 r: )rS rT rU r rf r¹ rI rI rJ Ú
|
cookie_jar[ s ü
|
zClient.cookie_jarr» rs r] z Cookie | None)ra Údomainrw r7 c C s$ | j dkrtd| j |||f¡S )aD Return a :class:`.Cookie` if it exists. Cookies are uniquely identified by
|
``(domain, path, key)``.
|
|
:param key: The decoded form of the key for the cookie.
|
:param domain: The domain the cookie was set for.
|
:param path: The path the cookie was set for.
|
|
.. versionadded:: 2.3
|
Nú>Cookies are disabled. Create a client with 'use_cookies=True'.)r r rÁ )r ra r
|
rw rI rI rJ Ú
|
get_cookiei s
|
|
ÿzClient.get_cookierµ )r
|
Ú origin_onlyrw r )ra rb r r
|
r rw r r7 c O s | j dkrtd|r6tjdtdd |}|}|d }t |dt||f||d|¡}||_|j rv| j
|
|j d¡ n || j |j < dS ) a· Set a cookie to be sent in subsequent requests.
|
|
This is a convenience to skip making a test request to a route that would set
|
the cookie. To test the cookie, make a test request to a route that uses the
|
cookie value.
|
|
The client uses ``domain``, ``origin_only``, and ``path`` to determine which
|
cookies to send with a request. It does not use other cookie parameters that
|
browsers use, since they're not applicable in tests.
|
|
:param key: The key part of the cookie.
|
:param value: The value part of the cookie.
|
:param domain: Send this cookie with requests that match this domain. If
|
``origin_only`` is true, it must be an exact match, otherwise it may be a
|
suffix match.
|
:param origin_only: Whether the domain must be an exact match to the request.
|
:param path: Send this cookie with requests that match this path either exactly
|
or as a prefix.
|
:param kwargs: Passed to :func:`.dump_cookie`.
|
|
.. versionchanged:: 2.3
|
The ``origin_only`` parameter was added.
|
|
.. versionchanged:: 2.3
|
The ``domain`` parameter defaults to ``localhost``.
|
|
.. versionchanged:: 2.3
|
The first parameter ``server_name`` is deprecated and will be removed in
|
Werkzeug 3.0. The first parameter is ``key``. Use the ``domain`` and
|
``origin_only`` parameters instead.
|
Nr zÁThe first parameter 'server_name' is no longer used, and will be removed in Werkzeug 3.0. The positional parameters are 'key' and 'value'. Use the 'domain' and 'origin_only' parameters instead.r9 r: r rs ©r
|
rw ) r r rS rT rU ÚCookieÚ_from_response_headerr r Ú_should_deleter Ú _storage_key) r ra rb r
|
r rw r r ÚcookierI rI rJ Ú
|
set_cookie| s, )
|
ÿû ÿzClient.set_cookier )ra r r
|
rw r r7 c O s | j dkrtd|r2tjdtdd |}|d }|r|d dd |D ¡}t|d
|
krZd nd }tjd | d| dtdd | j |||fd¡ dS )a Delete a cookie if it exists. Cookies are uniquely identified by
|
``(domain, path, key)``.
|
|
:param key: The decoded form of the key for the cookie.
|
:param domain: The domain the cookie was set for.
|
:param path: The path the cookie was set for.
|
|
.. versionchanged:: 2.3
|
The ``domain`` parameter defaults to ``localhost``.
|
|
.. versionchanged:: 2.3
|
The first parameter ``server_name`` is deprecated and will be removed in
|
Werkzeug 3.0. The first parameter is ``key``. Use the ``domain`` parameter
|
instead.
|
|
.. versionchanged:: 2.3
|
The ``secure``, ``httponly`` and ``samesite`` parameters are deprecated and
|
will be removed in Werkzeug 2.4.
|
Nr zThe first parameter 'server_name' is no longer used, and will be removed in Werkzeug 2.4. The first parameter is 'key'. Use the 'domain' parameter instead.r9 r: r rê c s s | ]}d | d V qdS )ú'NrI )Ú.0ÚkrI rI rJ Ú <genexpr>ì s z'Client.delete_cookie.<locals>.<genexpr>r zparameters arez parameter iszThe ú z0 deprecated and will be removed in Werkzeug 2.4.)r r rS rT rU rñ r@ r )r ra r
|
rw r r Z kwargs_keysÚpluralrI rI rJ Ú delete_cookieÀ s*
|
ÿûüzClient.delete_cookier- )r r7 c sb | j dkrdS tt|jp"d d fdd| j ¡ D ¡}|rR||d< n | dd¡ dS )zÉIf cookies are enabled, set the ``Cookie`` header in the environ to the
|
cookies that are applicable to the request host and path.
|
|
:meta private:
|
|
.. versionadded:: 2.3
|
Nr» z; c 3 s$ | ] }| j¡r| ¡ V qd S rÉ )Ú_matches_requestrw Ú_to_request_header)r Úc©rÙ ÚurlrI rJ r s þz.Client._add_cookies_to_wsgi.<locals>.<genexpr>Z HTTP_COOKIE)r r r+ Úhostnamerñ rf r )r r rb rI r rJ Ú_add_cookies_to_wsgi÷ s
|
|
þ
|
zClient._add_cookies_to_wsgiz list[str])rÙ rw rR r7 c C sN | j dkrdS |D ]6}t |||¡}|jr<| j |jd¡ q|| j |j< qdS )zªIf cookies are enabled, update the stored cookies from any ``Set-Cookie``
|
headers in the response.
|
|
:meta private:
|
|
.. versionadded:: 2.3
|
N)r r r r r r )r rÙ rw rR Úheaderr rI rI rJ Ú _update_cookies_from_response s
|
|
z$Client._update_cookies_from_responseú&tuple[t.Iterable[bytes], str, Headers])r Úbufferedr7 c C sJ | |¡ t| j||d}tt|}| |jp2d|j|d d¡¡ |S )zVRuns the wrapped WSGI app with the given environment.
|
|
:meta private:
|
©r& r» r9 z
|
Set-Cookie) r" Ú run_wsgi_appr r r+ r$ r! rw Úgetlist)r r r& rÑ r rI rI rJ r( $ s
|
ÿzClient.run_wsgi_appr )Úresponser& r7 c C sJ t |j\}}}}}tj|jj||d}| dd¡d d¡} |j d¡}
|
| dgkrb||_||_ n|
|
} | |
|
kr| t
|
|
|
d
|
|
kr| j st dnt d | d
|
¡} |j d
|
¡} | dt
|
|
| krÜ|t
|
|j d
|_n ||_d|_ |jd kr<|jd krd |_|jdk r"|j ¡ d|_d|_d|_|j dd¡ | j||dS )zPerform a new request to the location given by the redirect
|
response to the previous request.
|
|
:meta private:
|
)rw ry rØ r r Ú.rµ Nz-Following subdomain redirects is not enabled.z.Following external redirects is not supported.rs > é3 é4 ÚHEADrt zTransfer-Encodingr' )r Úlocationrm r° Úrequestr rÇ rÙ r¸ r³ r@ r Ú RuntimeErrorr´ rw Ú status_coderz r{ rÞ rP r| rR r Úopen) r r* r& r² r¼ rw r½ r¾ ÚbuilderZ to_name_partsZfrom_name_partsÚ
|
path_partsZ
|
root_partsrI rI rJ Úresolve_redirect3 sB ÿ
|
|
|
|
zClient.resolve_redirect)r& Úfollow_redirects)r r& r7 r r7 c O sN d}|sXt |dkrX|d }t|tr0| ¡ }n(t|trJt |¡ ¡ }nt|trX|}|dkrt||}z | ¡ }W 5 | ¡ X | j|j |d}| j
|
|d|i}t } g }
|
|s´|S |j dkr2|sÔ| ¡ | ¡ |j|j f} | | krtd|j d|j d | | ¡ t|
|
|_|
|
|¡ | j||d}q´t|
|
|_| |jj¡ |S )
|
a| Generate an environ dict from the given arguments, make a
|
request to the application using it, and return the response.
|
|
:param args: Passed to :class:`EnvironBuilder` to create the
|
environ for the request. If a single arg is passed, it can
|
be an existing :class:`EnvironBuilder` or an environ dict.
|
:param buffered: Convert the iterator returned by the app into
|
a list. If the iterator has a ``close()`` method, it is
|
called automatically.
|
:param follow_redirects: Make additional requests to follow HTTP
|
redirects until a non-redirect status is returned.
|
:attr:`TestResponse.history` lists the intermediate
|
responses.
|
|
.. versionchanged:: 2.1
|
Removed the ``as_tuple`` parameter.
|
|
.. versionchanged:: 2.0
|
The request input stream is closed when calling
|
``response.close()``. Input streams for redirects are
|
automatically closed.
|
|
.. versionchanged:: 0.5
|
If a dict is provided as file in the dict for the ``data``
|
parameter the content type has to be called ``content_type``
|
instead of ``mimetype``. This change was made for
|
consistency with :class:`werkzeug.FileWrapper`.
|
|
.. versionchanged:: 0.5
|
Added the ``follow_redirects`` parameter.
|
Nr r r' r0 > é- é. é/ é1 r, r- zLoop detected: A z redirect to z was already made.)r@ r\ rm rõ r r° r( rÞ r( r r r r2 Z make_sequencer/ r Úaddr Úhistoryr r6 Z call_on_closer{ ) r r& r7 r r r0 Úargr4 r* Z redirectsr= Znew_redirect_entryrI rI rJ r3 r sH &
|
|
|
|
|
|
|
|
ÿ
|
|
|
|
z Client.open)r Úkwr7 c O s d|d< | j ||S )z1Call :meth:`open` with ``method`` set to ``GET``.rt rz ©r3 ©r r r? rI rI rJ rÁ × s z
|
Client.getc O s d|d< | j ||S )z2Call :meth:`open` with ``method`` set to ``POST``.ÚPOSTrz r@ rA rI rI rJ ÚpostÜ s z Client.postc O s d|d< | j ||S )z1Call :meth:`open` with ``method`` set to ``PUT``.ÚPUTrz r@ rA rI rI rJ Úputá s z
|
Client.putc O s d|d< | j ||S )z4Call :meth:`open` with ``method`` set to ``DELETE``.ÚDELETErz r@ rA rI rI rJ Údeleteæ s z Client.deletec O s d|d< | j ||S )z3Call :meth:`open` with ``method`` set to ``PATCH``.ÚPATCHrz r@ rA rI rI rJ Úpatchë s z Client.patchc O s d|d< | j ||S )z5Call :meth:`open` with ``method`` set to ``OPTIONS``.ÚOPTIONSrz r@ rA rI rI rJ Úoptionsð s zClient.optionsc O s d|d< | j ||S )z2Call :meth:`open` with ``method`` set to ``HEAD``.r. rz r@ rA rI rI rJ Úheadõ s z Client.headc O s d|d< | j ||S )z3Call :meth:`open` with ``method`` set to ``TRACE``.ÚTRACErz r@ rA rI rI rJ Útraceú s z Client.tracec C s dt | j d| jdS )Nú<r ú>)rÍ rö r r¹ rI rI rJ Ú__repr__ÿ s zClient.__repr__)NTF)r» rs )rµ )F)F)rö r÷ rø rù r rþ r r r r r" r$ r( r6 r3 rÁ rC rE rG rI rK rL rN rQ rI rI rI rJ r $ sJ û ÿ ýù Hû 7 ÿ ÿBüer r r- )r r r7 c O s& t | |}z | ¡ W ¢S | ¡ X dS )a Create a new WSGI environ dict based on the values passed. The first
|
parameter should be the path of the request which defaults to '/'. The
|
second one can either be an absolute path (in that case the host is
|
localhost:80) or a full path to the request with scheme, netloc port and
|
the path to the script.
|
|
This accepts the same arguments as the :class:`EnvironBuilder`
|
constructor.
|
|
.. versionchanged:: 0.5
|
This function is now a thin wrapper over :class:`EnvironBuilder` which
|
was added in 0.5. The `headers`, `environ_base`, `environ_overrides`
|
and `charset` parameters were added.
|
N)rm rÞ ró )r r r4 rI rI rJ Úcreate_environ s
|
rR Fr, r% )Úappr r& r7 c
|
sÄ t | ¡ }dg d fdd }| ||}t|dd}t|}|rfz t|}W 5 |dk rb| X nH|D ]} |¡ dk rj qqj rt |}|dk r®||k r®t||}\}} ||t| fS )a Return a tuple in the form (app_iter, status, headers) of the
|
application output. This works best if you pass it an application that
|
returns an iterator all the time.
|
|
Sometimes applications may use the `write()` callable returned
|
by the `start_response` function. This tries to resolve such edge
|
cases automatically. But if you don't get the expected output you
|
should set `buffered` to `True` which enforces buffering.
|
|
If passed an invalid WSGI application the behavior of this function is
|
undefined. Never pass non-conforming WSGI applications to this function.
|
|
:param app: the application to execute.
|
:param buffered: set to `True` to enforce buffering.
|
:return: tuple in the form ``(app_iter, status, headers)``
|
Nc s0 |r"z|d |d ¡W 5 d }X | |f jS )Nr r9 )Úwith_tracebackr )ÚstatusrR Úexc_info©Úbufferr* rI rJ Ústart_response4 s z$run_wsgi_app.<locals>.start_responserÞ )N) r rí rX Úiterri r r r* r )
|
rS r r& rY Zapp_rvZ
|
close_funcZapp_iterÚitemrU rR rI rW rJ r( s,
|
|
|
|
|
r( c s` e Zd ZU dZdZded< ded< dZdd d
|
d dd d dd fdd Zed
|
dddZ Z
|
S )r a= :class:`~werkzeug.wrappers.Response` subclass that provides extra
|
information about requests made with the test :class:`Client`.
|
|
Test client requests will always return an instance of this class.
|
If a custom response class is passed to the client, it is
|
subclassed along with this to support test information.
|
|
If the test request included large files, or if the application is
|
serving a file, call :meth:`close` to close any open files and
|
prevent Python showing a ``ResourceWarning``.
|
|
.. versionchanged:: 2.2
|
Set the ``default_mimetype`` to None to prevent a mimetype being
|
assumed if missing.
|
|
.. versionchanged:: 2.1
|
Response instances cannot be treated as tuples.
|
|
.. versionadded:: 2.0
|
Test client methods always return instances of this class.
|
Nr( r0 ztuple[TestResponse, ...]r= FrI zt.Iterable[bytes]r] r ztuple[TestResponse]r rv )r* rU rR r0 r= r r7 c s0 t j|||f| || _|| _|||f| _d S rÉ )Úsuperr r0 r= Z _compat_tuple)r r* rU rR r0 r= r ©Ú __class__rI rJ r s zTestResponse.__init__r· c C s | j ddS )z~The response data as text. A shortcut for
|
``response.get_data(as_text=True)``.
|
|
.. versionadded:: 2.1
|
T)Zas_text)Úget_datar¹ rI rI rJ Útext s zTestResponse.text)rI ) rö r÷ rø rù Zdefault_mimetyperü Z__test__r r& r` Ú __classcell__rI rI r] rJ r b s
|
ú r c @ sÎ e Zd ZU dZded< ded< ded< ded< ded< d ed
|
< ded < d ed < ded< ded< ded< ded< ddd dddZddddZedddddd d Ze d dd d Z
|
e d dd!d"Z d#S )$r zÆA cookie key, value, and parameters.
|
|
The class itself is not a public API. Its attributes are documented for inspection
|
with :meth:`.Client.get_cookie` only.
|
|
.. versionadded:: 2.3
|
r] ra rb Ú decoded_keyÚ decoded_valuezdatetime | NoneÚexpiresru Úmax_ager
|
r/ r rw z bool | NoneÚsecureÚ http_onlyr1 Ú same_site)rÙ rw r7 c C sr || j ks8| j op| | j ¡op|d t| j
d¡op|| jkpp| | j¡op|t| j| j d¡ d
d¡S )Nr+ rs )r
|
r Úendswithr@ rw Ú
|
startswith)r rÙ rw rI rI rJ r Ó s
|
|
ÿû
|
"õzCookie._matches_requestr· c C s | j d| j S )Nú=)ra rb r¹ rI rI rJ r ã s zCookie._to_request_headerzte.Self)rÙ rw r# r7 c C sò | d¡\}}}| d¡\}}}tt| ¡ \}} i }
|
| d¡D ]0} | d¡\} } }| rb| ¡ nd |
|
| ¡ ¡ < qB| | ¡ | ¡ || t|
|
d¡d|
|
krªt |
|
d p¦dnd |
|
d¡p¸|d|
|
k|
|
d¡pØ|
|
d¡d pØdd |
|
kd
|
|
|
k|
|
d ¡d S ) NrÆ rk rd zmax-ager r
|
rw rs rf ÚhttponlyÚsamesite) ra rb rb rc rd re r
|
r rw rf rg rh ) Ú partitionÚnextr rh rÇ rÈ Úlowerr rÁ r0 Ú
|
rpartition)r® rÙ rw r# ré Zparameters_strra rb rb rc Úparamsr[ r Úseprj rI rI rJ r æ s* ôz Cookie._from_response_headerztuple[str, str, str]c C s | j | j| jfS rÉ )r
|
rw rb r¹ rI rI rJ r s zCookie._storage_keyc C s" | j dkp | jd k o | j ¡ dkS )Nr )re rd Ú timestampr¹ rI rI rJ r s
|
ÿzCookie._should_deleteN) rö r÷ rø rù rü r r rý r rþ r r rI rI rI rJ r ¡ s*
|
r )Tr. NN)NN)F)RÚ
|
__future__r Z dataclassesrY r ÚtypingrA rS Ú collectionsr r Úior Ú itertoolsr r Útempfiler r Ú urllib.parser
|
r r Ú _internalr r r r Zdatastructuresr r r r r r r rº r r r r r Zsansio.multipartr r r r! r" r# Úurlsr$ r% Úutilsr& r' Zwrappers.requestr( Zwrappers.responser) Zwsgir* r+ Ú TYPE_CHECKINGZ_typeshed.wsgir, r- Ztyping_extensionsÚtere rg rW ÚTypeVarrk rm rß r r rR r( r Z dataclassr rI rI rI rJ Ú<module> s ûg ý a b ÿH?
|
