a !f(&@sddlmZddlZddlmZddlmZddlmZddlm Z ddl m Z ddl Z ddlmZdd l mZdd lmZd d lmZd d lmZejrddl mZd dlmZGddde jjZGdddeZGdddeZdS)) annotationsN)contextmanager) ExitStack)copy) TracebackType)urlsplit) CliRunner)Client)Request) ScriptInfo) SessionMixin) TestResponse)Flaskc sHeZdZdZdddddddddd fd d Zdddd d dZZS)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`. /Nrstrz str | Nonet.AnyNone)apppathbase_url subdomain url_schemeargskwargsreturnc s|s |s |r(|dut|p|ks(Jd|dur|jdp>d}|jd} |r\|d|}|durn|jd}t|} | jp~|d| jp|d| d}| j}| jrt | jt rd nd } || | j7}||_ t j ||g|Ri|dS) Nz8Cannot pass "subdomain" or "url_scheme" with "base_url".Z SERVER_NAME localhostZAPPLICATION_ROOT.ZPREFERRED_URL_SCHEMEz://r??)boolconfiggetrschemenetloclstriprquery isinstancebytesrsuper__init__) selfrrrrrrrZ http_hostZapp_rooturlsep __class__N/var/www/html/python-backend/venv/lib/python3.9/site-packages/flask/testing.pyr+.s4   zEnvironBuilder.__init__)objrrcKs|jjj|fi|S)zSerialize ``obj`` to a JSON-formatted string. The serialization will be configured according to the config associated with this EnvironBuilder's ``app``. )rjsondumps)r,r3rr1r1r2 json_dumpsVszEnvironBuilder.json_dumps)rNNN)__name__ __module__ __qualname____doc__r+r6 __classcell__r1r1r/r2rs"(rcseZdZUdZded<ddddfdd Zeddd dd d Zd d ZddZ dddddddddfddZ ddddZ dddddddZ Z S) FlaskClientaWorks like a regular Werkzeug test client but has knowledge about Flask's contexts to defer the cleanup of the request context until the end of a ``with`` block. 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 :doc:`/testing` chapter. r applicationrr)rrrcs>tj|i|d|_g|_t|_ddtjd|_dS)NFz 127.0.0.1z werkzeug/)Z REMOTE_ADDRZHTTP_USER_AGENT) r*r+preserve_context _new_contextsr_context_stackwerkzeug __version__ environ_base)r,rrr/r1r2r+os zFlaskClient.__init__z%t.Generator[SessionMixin, None, None]cos|jdurtd|j}|j|i|}||jj| |j||j}Wdn1s`0Y|durzt d|V| }|j |rdS| |j |||Wdn1s0Y| |jjdd|jj|jddS)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>Cookies are disabled. Create a client with 'use_cookies=True'.z'Session backend did not open a session.:rz Set-Cookie)_cookies TypeErrorr=Ztest_request_contextZ_add_cookies_to_wsgirequestenvironZsession_interfaceZ open_session RuntimeErrorresponse_classZis_null_sessionZ save_sessionZ_update_cookies_from_responsehost partitionrheadersgetlist)r,rrrctxsessrespr1r1r2session_transactionys, . . zFlaskClient.session_transactioncCs$i|j|}|jr |jj|d<|S)Nzwerkzeug.debug.preserve_context)rCr>r?append)r,otheroutr1r1r2 _copy_environs zFlaskClient._copy_environcCsP||di|d<t|jg|Ri|}z|W|S|0dS)NrC)rVr#rr= get_requestclose)r,rrbuilderr1r1r2_request_from_builder_argssz&FlaskClient._request_from_builder_argsFbufferedfollow_redirectsr!r)rr\r]rrc s|rt|dtjjttfrt|dtjjrVt|d}||jpFi|_| }qt|dtrtj |d|j |id }qt|d}||j |_ n | ||}|jtj|||d}|j j|_|jr|j}|j|q|S)Nr)rrCr[)r(rAtestrdict BaseRequestrrVrCrWZ from_environr=rHrZr@rXr*openr4Z json_moduler?pop enter_context) r,r\r]rrrYrGresponsecmr/r1r2ras2        zFlaskClient.open)rcCs|jrtdd|_|S)NzCannot nest client invocationsT)r>rIr,r1r1r2 __enter__szFlaskClient.__enter__z type | NonezBaseException | NonezTracebackType | None)exc_type exc_valuetbrcCsd|_|jdS)NF)r>r@rX)r,rhrirjr1r1r2__exit__szFlaskClient.__exit__)r7r8r9r:__annotations__r+rrRrVrZrargrkr;r1r1r/r2r<_s   1 -r<csDeZdZdZddddfdd Zd ddddd fd d ZZS) 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`. rrr)rrrc s||_tjfi|dSN)rr*r+)r,rrr/r1r2r+szFlaskCliRunner.__init__N)clirrrc sD|durjj}d|vr.tfddd|d<tj||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. Nr3csjSrn)rr1rfr1r2z'FlaskCliRunner.invoke..)Z create_app)rror r*invoke)r,rorrr/rfr2rrs zFlaskCliRunner.invoke)NN)r7r8r9r:r+rrr;r1r1r/r2rmsrm) __future__rtypingt contextlibrrrtypesr urllib.parserZ werkzeug.testrAZ click.testingrr Zwerkzeug.wrappersr r`ror sessionsr TYPE_CHECKINGrrrr^rr<rmr1r1r1r2s&             G