ó ¹×-]c@sãdZddlZddlmZddlZddlmZddlmZddl m Z ddl m Z dd l mZdd lmZd ejjfd „ƒYZd „Zdefd„ƒYZdefd„ƒYZdS(sÙ 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 iÿÿÿÿN(tcontextmanager(t CliRunner(tClient(t url_parsei(t_request_ctx_stack(t ScriptInfo(tdumpstEnvironBuildercBs,eZdZddddd„Zd„ZRS(s½An :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`. t/c Os]|p|p| s=|dk t|p(|ƒks=tdƒ‚|dkr1|jjdƒp^d}|jd} |r‰dj||ƒ}n|dkr¥|jd}nt|ƒ} djd| jpÆ|d | jpÕ|d | j d ƒƒ}| j }| j r1t | j t ƒrd nd } || | j 7}q1n||_tt|ƒj||||ŽdS( Ns8Cannot pass "subdomain" or "url_scheme" with "base_url".t SERVER_NAMEt localhosttAPPLICATION_ROOTs{0}.{1}tPREFERRED_URL_SCHEMEs{scheme}://{netloc}/{path}tschemetnetloctpathRt?(tNonetbooltAssertionErrortconfigtgettformatRR RtlstripRtqueryt isinstancetbytestapptsuperRt__init__( tselfRRtbase_urlt subdomaint url_schemetargstkwargst http_hosttapp_rootturltsep((s,lib/python2.7/site-packages/flask/testing.pyR/s.           cKs |jd|jƒt||S(s³Serialize ``obj`` to a JSON-formatted string. The serialization will be configured according to the config associated with this EnvironBuilder's ``app``. R(t setdefaultRt json_dumps(RtobjR#((s,lib/python2.7/site-packages/flask/testing.pyR)XsN(t__name__t __module__t__doc__RRR)(((s,lib/python2.7/site-packages/flask/testing.pyRs  #cOs tjtdƒƒt||ŽS(s±Create a :class:`flask.testing.EnvironBuilder`. .. deprecated: 1.1 Will be removed in 1.2. Construct ``flask.testing.EnvironBuilder`` directly instead. s‚"make_test_environ_builder()" is deprecated and will be removed in 1.2. Construct "flask.testing.EnvironBuilder" directly instead.(twarningstwarntDeprecationWarningR(R"R#((s,lib/python2.7/site-packages/flask/testing.pytmake_test_environ_builderbs t FlaskClientcBsGeZdZeZd„Zed„ƒZd„Zd„Z d„Z RS(sDWorks 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. cOs;tt|ƒj||Židd6dtjd6|_dS(Ns 127.0.0.1t REMOTE_ADDRs werkzeug/tHTTP_USER_AGENT(RR2Rtwerkzeugt __version__t environ_base(RR"R#((s,lib/python2.7/site-packages/flask/testing.pyR„sc os-|jdkrtdƒ‚n|j}|jdiƒ}|jj|ƒtj}|j||ŽÃ}|j }|j ||j ƒ}|dkr tdƒ‚ntj |ƒz |VWdtj ƒX|jƒ} |j|ƒsõ|j||| ƒn| j|j jƒ} |jj|j j| ƒWdQXdS(s’When 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. s:Session transactions only make sense with cookies enabled.tenviron_overridess?Session backend did not open a session. Check the configurationN(t cookie_jarRt RuntimeErrort applicationR(t inject_wsgiRttopttest_request_contexttsession_interfacet open_sessiontrequesttpushtpoptresponse_classtis_null_sessiont save_sessiontget_wsgi_headerstenviront extract_wsgi( RR"R#RR8t outer_reqctxtcR?tsesstresptheaders((s,lib/python2.7/site-packages/flask/testing.pytsession_transaction‹s,         c OsR|jdtƒ}|jdtƒ}|jdtƒ}| rÑt|ƒdkrÑt|dtjjtfƒrÑ|jj ƒ}t|dtjjƒr°|j |dj ƒƒn|j |dƒ|j |d` 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. R*t create_appcsˆjS(N(R((R(s,lib/python2.7/site-packages/flask/testing.pyttN(RRtcliRRRetinvoke(RRiR"R#((Rs,lib/python2.7/site-packages/flask/testing.pyRjs   N(R+R,R-RRRj(((s,lib/python2.7/site-packages/flask/testing.pyReüs (R-R.t contextlibRt werkzeug.testR5t click.testingRRt werkzeug.urlsRRhRRiRtjsonRR)RURR1R2Re(((s,lib/python2.7/site-packages/flask/testing.pyt s  I ‰