^Yc@s)dZddlmZedZededZededZededZededZeded Z ed ed Z d Z ed ed Z dZ ed edZdZdZed edZed edZdZdZdZdZdZed edZed edZed edZed edZdZed edZed edZd Zed ed!Z d"Z!d#Z"d$Z#d%Z$ed ed&Z%d'Z&ed ed(Z'd)Z(d*Z)d+Z*d,Z+d-Z,d.Z-ed ed/Z.d0Z/eded1Z0ed ed2Z1d3Z2d4Z3d5Z4d6Z5d7S(8sT hook specifications for pytest plugins, invoked from main.py and builtin plugins. i(tHookspecMarkertpytestthistoriccCsdS(scalled at plugin registration time to allow adding new hooks via a call to pluginmanager.add_hookspecs(module_or_class, prefix).N((t pluginmanager((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_addhooks scCsdS(s DEPRECATED: this hook causes direct monkeypatching on pytest, its use is strongly discouraged return dict of name->object to be made globally available in the pytest namespace. This hook is called at plugin registration time. N((((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_namespacescCsdS(s% a new pytest plugin got registered. N((tplugintmanager((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_plugin_registeredscCsdS(szregister argparse-style options and ini-style config values, called once at the beginning of a test run. .. note:: This function should be implemented only in plugins or ``conftest.py`` files situated at the tests root directory due to how pytest :ref:`discovers plugins during startup `. :arg parser: To add command line options, call :py:func:`parser.addoption(...) <_pytest.config.Parser.addoption>`. To add ini-file values call :py:func:`parser.addini(...) <_pytest.config.Parser.addini>`. Options can later be accessed through the :py:class:`config <_pytest.config.Config>` object, respectively: - :py:func:`config.getoption(name) <_pytest.config.Config.getoption>` to retrieve the value of a command line option. - :py:func:`config.getini(name) <_pytest.config.Config.getini>` to retrieve a value read from an ini-style file. The config object is passed around on many internal objects via the ``.config`` attribute or can be retrieved as the ``pytestconfig`` fixture or accessed via (deprecated) ``pytest.config``. N((tparser((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_addoptionscCsdS(s called after command line options have been parsed and all plugins and initial conftest files been loaded. This hook is called for every plugin. N((tconfig((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_configure=st firstresultcCsdS(szreturn initialized config object, parsing the specified args. Stops at first non-None result, see :ref:`firstresult` N((Rtargs((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_cmdline_parseJscCsdS(sB(deprecated) modify command line arguments before option parsing. N((R R((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_cmdline_preparsePscCsdS(s called for performing the main command line action. The default implementation will invoke the configure hooks and runtest_mainloop. Stops at first non-None result, see :ref:`firstresult` N((R ((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_cmdline_mainSscCsdS(s\ implements the loading of initial conftest files ahead of command line option parsing. N((t early_configR R((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_load_initial_conftestsZscCsdS(st perform the collection protocol for the given session. Stops at first non-None result, see :ref:`firstresult` N((tsession((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_collectioncscCsdS(s[ called after collection has been performed, may filter or re-order the items in-place.N((RR titems((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_collection_modifyitemsiscCsdS(s: called after collection has been performed and modified. N((R((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_collection_finishmscCsdS(s return True to prevent considering this path for collection. This hook is consulted for all files and directories prior to calling more specific hooks. Stops at first non-None result, see :ref:`firstresult` N((tpathR ((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_ignore_collectpscCsdS(sx called before traversing a directory for collection files. Stops at first non-None result, see :ref:`firstresult` N((Rtparent((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_collect_directoryyscCsdS(sx return collection Node or None for the given path. Any new node needs to have the specified ``parent`` as a parent.N((RR((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_collect_filescCsdS(s collector starts collecting. N((t collector((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_collectstartscCsdS(s we just collected a test item. N((titem((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_itemcollectedscCsdS(s collector finished collecting. N((treport((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_collectreportscCsdS(s. called for test items deselected by keyword. N((R((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_deselectedscCsdS(sy perform ``collector.collect()`` and return a CollectReport. Stops at first non-None result, see :ref:`firstresult` N((R((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_make_collect_reportscCsdS(s; return a Module collector or None for the given path. This hook will be called for each matching test module path. The pytest_collect_file hook needs to be used if you want to create test modules for files that do not match as a test module. Stops at first non-None result, see :ref:`firstresult` N((RR((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_pycollect_makemodulescCsdS(s return custom item/collector for a python object in a module, or None. Stops at first non-None result, see :ref:`firstresult` N((Rtnametobj((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_pycollect_makeitemscCsdS(s\ call underlying test function. Stops at first non-None result, see :ref:`firstresult` N((t pyfuncitem((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_pyfunc_callscCsdS(s; generate (multiple) parametrized calls to a test function.N((tmetafunc((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_generate_testsscCsdS(s,Return a user-friendly string representation of the given ``val`` that will be used by @pytest.mark.parametrize calls. Return None if the hook doesn't know about ``val``. The parameter name is available as ``argname``, if required. Stops at first non-None result, see :ref:`firstresult` N((R tvaltargname((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_make_parametrize_idscCsdS(s called for performing the main runtest loop (after collection finished). Stops at first non-None result, see :ref:`firstresult` N((R((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_runtestloopscCsdS(s, (deprecated, use pytest_runtest_logstart). N((R tnode((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_itemstartscCsdS(s/ implements the runtest_setup/call/teardown protocol for the given test item, including capturing exceptions and calling reporting hooks. :arg item: test item for which the runtest protocol is performed. :arg nextitem: the scheduled-to-be-next test item (or None if this is the end my friend). This argument is passed on to :py:func:`pytest_runtest_teardown`. :return boolean: True if no further hook implementations should be invoked. Stops at first non-None result, see :ref:`firstresult` N((R tnextitem((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_runtest_protocolscCsdS(s1 signal the start of running a single test item. N((tnodeidtlocation((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_runtest_logstartscCsdS(s. called before ``pytest_runtest_call(item)``. N((R ((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_runtest_setupscCsdS(s& called to execute the test ``item``. N((R ((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_runtest_callscCsdS(sX called after ``pytest_runtest_call``. :arg nextitem: the scheduled-to-be-next test item (None if no further test item is scheduled). This argument can be used to perform exact teardowns, i.e. calling just enough finalizers so that nextitem only needs to call setup-functions. N((R R4((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_runtest_teardownscCsdS(s return a :py:class:`_pytest.runner.TestReport` object for the given :py:class:`pytest.Item <_pytest.main.Item>` and :py:class:`_pytest.runner.CallInfo`. Stops at first non-None result, see :ref:`firstresult` N((R tcall((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_runtest_makereportscCsdS(se process a test setup/call/teardown report relating to the respective phase of executing a test. N((R"((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_runtest_logreportscCsdS(s_ performs fixture setup execution. Stops at first non-None result, see :ref:`firstresult` N((t fixturedeftrequest((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_fixture_setupscCsdS(s called after fixture teardown, but before the cache is cleared so the fixture result cache ``fixturedef.cached_result`` can still be accessed.N((R?((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_fixture_post_finalizerscCsdS(s" before session.main() is called. N((R((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_sessionstart scCsdS(s whole test run finishes. N((Rt exitstatus((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_sessionfinish scCsdS(s( called before test process is exited. N((R ((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_unconfigurescCsdS(slreturn explanation for comparisons in failing assert expressions. Return None for no custom explanation, otherwise return a list of strings. The strings will be joined by newlines but any newlines *in* a string will be escaped. Note that all but the first line will be indented slightly, the intention is for the first line to be a summary. N((R toptlefttright((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_assertrepr_comparescCsdS(s/ return a string to be displayed as header info for terminal reporting. .. note:: This function should be implemented only in plugins or ``conftest.py`` files situated at the tests root directory due to how pytest :ref:`discovers plugins during startup `. N((R tstartdir((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_report_header%scCsdS(s return result-category, shortletter and verbose word for reporting. Stops at first non-None result, see :ref:`firstresult` N((R"((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_report_teststatus/scCsdS(s8 add additional section in terminal summary reporting. N((tterminalreporterRD((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_terminal_summary5scCsdS(s process a warning specified by a message, a code string, a nodeid and fslocation (both of which may be None if the warning is not tied to a partilar node/location).N((tmessagetcodeR6t fslocation((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_logwarning9scCsdS(sj return processed content for a given doctest Stops at first non-None result, see :ref:`firstresult` N((tcontent((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_doctest_prepare_contentCscCsdS(s called for internal errors. N((texcreprtexcinfo((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_internalerrorMscCsdS(s called for keyboard interrupt. N((RW((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_keyboard_interruptPscCsdS(scalled when an exception was raised which can potentially be interactively handled. This hook is only called if an exception was raised that is not an internal exception like ``skip.Exception``. N((R2R<R"((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_exception_interactSscCsdS(s called upon pdb.set_trace(), can be used by plugins to take special action just before the python debugger enters in interactive mode. :arg config: pytest config object :type config: _pytest.config.Config N((R ((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytpytest_enter_pdb[sN(6t__doc__t_pytest._pluggyRthookspectTrueRRRR R RRRRRRRRRRRR!R#R$R%R&R)R+R-R0R1R3R5R8R9R:R;R=R>RARBRCRERFRJRLRMRORSRURXRYRZR[(((s0/tmp/pip-build-hU8Cw8/pytest/_pytest/hookspec.pytsf