wdf'dZddlZddlmZddlZddlmZddlmZddl m Z ddl m Z dd l mZdd lmZGd d ejjZd ZGddeZGddeZdS)z flask.testing ~~~~~~~~~~~~~ Implements test support helpers. This module is lazily imported and usually not used in production environments. :copyright: 2010 Pallets :license: BSD-3-Clause N)contextmanager) CliRunner)Client) url_parse)_request_ctx_stack) ScriptInfo)dumpsc2eZdZdZ dfd ZdZxZS)EnvironBuilderaAn :class:`~werkzeug.test.EnvironBuilder`, that takes defaults from the application. :param app: The Flask application to configure the environment from. :param path: URL path being requested. :param base_url: Base URL where the app is being served, which ``path`` is relative to. If not given, built from :data:`PREFERRED_URL_SCHEME`, ``subdomain``, :data:`SERVER_NAME`, and :data:`APPLICATION_ROOT`. :param subdomain: Subdomain name to append to :data:`SERVER_NAME`. :param url_scheme: Scheme to use instead of :data:`PREFERRED_URL_SCHEME`. :param json: If given, this is serialized as JSON and passed as ``data``. Also defaults ``content_type`` to ``application/json``. :param args: other positional arguments passed to :class:`~werkzeug.test.EnvironBuilder`. :param kwargs: other keyword arguments passed to :class:`~werkzeug.test.EnvironBuilder`. /NcT|s|s|r!|dut|p|ks Jd||jdpd}|jd} |rd||}| |jd}t |} d| jp|| jp|| d }| j}| j r+t| j trd nd } || | j zz }||_ tt|j||g|Ri|dS) Nz8Cannot pass "subdomain" or "url_scheme" with "base_url". SERVER_NAME localhostAPPLICATION_ROOTz{0}.{1}PREFERRED_URL_SCHEMEz{scheme}://{netloc}/{path}r )schemenetlocpath??)boolconfiggetformatrrrlstriprquery isinstancebytesappsuperr __init__) selfr rbase_url subdomain url_schemeargskwargs http_hostapp_rooturlsep __class__s R/var/www/book.euthymeo.com/html/venv/lib/python3.11/site-packages/flask/testing.pyr"zEnvironBuilder.__init__/s~ F  FZ F D   #  = = =  F = = =   }55DIz"45H C%,,Y BB ! Z(>? D//C3::z/Zz.Y__S));H 8Dy ((E::Cddci',nd##,T8MdMMMfMMMMMc R|d|jt|fi|S)zSerialize ``obj`` to a JSON-formatted string. The serialization will be configured according to the config associated with this EnvironBuilder's ``app``. r ) setdefaultr json_dumps)r#objr(s r.r2zEnvironBuilder.json_dumpsXs2 %***#(((((r/)r NNN)__name__ __module__ __qualname____doc__r"r2 __classcell__r-s@r.r r sk0 'N'N'N'N'N'NR)))))))r/r c\tjtdt|i|S)zCreate a :class:`flask.testing.EnvironBuilder`. .. deprecated: 1.1 Will be removed in 2.0. Construct ``flask.testing.EnvironBuilder`` directly instead. z"make_test_environ_builder()" is deprecated and will be removed in 2.0. Construct "flask.testing.EnvironBuilder" directly instead.)warningswarnDeprecationWarningr )r'r(s r.make_test_environ_builderr>bs? M !   4 *6 * **r/cNeZdZdZdZfdZedZdZdZ dZ xZ S) FlaskClientaDWorks like a regular Werkzeug test client but has some knowledge about how Flask works to defer the cleanup of the request context stack to the end of a ``with`` body when used in a ``with`` statement. For general information about how to use this class refer to :class:`werkzeug.test.Client`. .. versionchanged:: 0.12 `app.test_client()` includes preset default environment, which can be set after instantiation of the `app.test_client()` object in `client.environ_base`. Basic usage is outlined in the :ref:`testing` chapter. Fcvtt|j|i|ddtjzd|_dS)Nz 127.0.0.1z werkzeug/) REMOTE_ADDRHTTP_USER_AGENT)r!r@r"werkzeug __version__ environ_base)r#r'r(r-s r.r"zFlaskClient.__init__sH)k4  )4:6:::&*X-AA  r/c/K|jtd|j}|di}|j|t j}|j|i|5}|j}| ||j }|tdt j | |Vt j n#t j wxYw| } ||s|||| | |j j} |j|j j| ddddS#1swxYwYdS)aWhen used in combination with a ``with`` statement this opens a session transaction. This can be used to modify the session that the test client uses. Once the ``with`` block is left the session is stored back. :: with client.session_transaction() as session: session['value'] = 42 Internally this is implemented by going through a temporary test request context and since session handling could depend on request variables this function accepts the same arguments as :meth:`~flask.Flask.test_request_context` which are directly passed through. Nz:Session transactions only make sense with cookies enabled.environ_overridesz?Session backend did not open a session. Check the configuration) cookie_jar RuntimeError applicationr1 inject_wsgirtoptest_request_contextsession_interface open_sessionrequestpushpopresponse_classis_null_session save_sessionget_wsgi_headersenviron extract_wsgi) r#r'r(r rH outer_reqctxcrOsessrespheaderss r.session_transactionzFlaskClient.session_transactions$ ? "L "--.A2FF ##$5666)- %S %t 6v 6 6 E! # 5 $11#qyAAD|"U  #L 1 1 1 ) "&(((("&((((%%''D$44T:: @!..sD$???++AI,=>>G O ( ():G D D D3 E E E E E E E E E E E E E E E E E Es,)AE32C 6E3 CBE33E7:E7c|dd}|dd}|dd}|st|dkrt|dtjjt fr|j}t|dtjjr.| |d n| |d|j |d<n|j | did<| d |jt |j g|Ri|} | }|n#|wxYwtj||||| S) Nas_tupleFbufferedfollow_redirectsrrzflask._preserve_contextrHrF)rarbrc)rSlenrrDtestr dictrFcopyupdate get_environpreserve_contextr1rKcloseropen)r#r'r(rarbrcrXbuilders r.rlzFlaskClient.opens::j%00::j%00!::&8%@@ D Q47X]%A4$HII',,..G$q'8=#?@@ (tAw22445555tAw'''151FG- . .%   12 6 6)    nd.? @ @ @$T%5GGGGGGG !--//  {  -     s %FF$c@|jrtdd|_|S)NzCannot nest client invocationsT)rjrJr#s r. __enter__zFlaskClient.__enter__s*   A?@@ @ $ r/cld|_ tj}||jr|ndS-)NF)rjrrM preservedrS)r#exc_type exc_valuetbrMs r.__exit__zFlaskClient.__exit__s; %  $(C3=   r/) r4r5r6r7rjr"rr_rlrprvr8r9s@r.r@r@ss       2E2E^2Eh$ $ $ L       r/r@c.eZdZdZfdZdfd ZxZS)FlaskCliRunnerzA :class:`~click.testing.CliRunner` for testing a Flask app's CLI commands. Typically created using :meth:`~flask.Flask.test_cli_runner`. See :ref:`testing-cli`. c V||_tt|jdi|dS)N)r r!rxr")r#r r(r-s r.r"zFlaskCliRunner.__init__s3,nd##,66v66666r/Nc | jj}d|vrtfd|d<ttj||fi|S)acInvokes a CLI command in an isolated environment. See :meth:`CliRunner.invoke ` for full method documentation. See :ref:`testing-cli` for examples. If the ``obj`` argument is not given, passes an instance of :class:`~flask.cli.ScriptInfo` that knows how to load the Flask app being tested. :param cli: Command object to invoke. Default is the app's :attr:`~flask.app.Flask.cli` group. :param args: List of strings to invoke the command with. :return: a :class:`~click.testing.Result` object. Nr3cjS)N)r rosr.z'FlaskCliRunner.invoke..s $(r/) create_app)r clir r!rxinvoke)r#rr'r(r-s` r.rzFlaskCliRunner.invokesd ;(,C   &2B2B2B2BCCCF5M1u^T**1#tFFvFFFr/)NN)r4r5r6r7r"rr8r9s@r.rxrxsj 77777GGGGGGGGGGr/rx)r7r; contextlibr werkzeug.testrD click.testingrr werkzeug.urlsrrrr jsonr r2rer r>r@rxrzr/r.rs\  %%%%%%###### ###### %%%%%%F)F)F)F)F)X]1F)F)F)R+++"FFFFF&FFFRGGGGGYGGGGGr/