fix ya.make

1 files changed, 0 insertions, 892 deletions

diff --git a/contrib/python/pytest/py3/_pytest/hookspec.py b/contrib/python/pytest/py3/_pytest/hookspec.py
deleted file mode 100644
index a03c0e9ab7..0000000000
--- a/contrib/python/pytest/py3/_pytest/hookspec.py
+++ /dev/null
@@ -1,892 +0,0 @@
-"""Hook specifications for pytest plugins which are invoked by pytest itself
-and by builtin plugins."""
-from pathlib import Path
-from typing import Any
-from typing import Dict
-from typing import List
-from typing import Mapping
-from typing import Optional
-from typing import Sequence
-from typing import Tuple
-from typing import TYPE_CHECKING
-from typing import Union
-
-from pluggy import HookspecMarker
-
-from _pytest.deprecated import WARNING_CMDLINE_PREPARSE_HOOK
-
-if TYPE_CHECKING:
-    import pdb
-    import warnings
-    from typing_extensions import Literal
-
-    from _pytest._code.code import ExceptionRepr
-    from _pytest.code import ExceptionInfo
-    from _pytest.config import Config
-    from _pytest.config import ExitCode
-    from _pytest.config import PytestPluginManager
-    from _pytest.config import _PluggyPlugin
-    from _pytest.config.argparsing import Parser
-    from _pytest.fixtures import FixtureDef
-    from _pytest.fixtures import SubRequest
-    from _pytest.main import Session
-    from _pytest.nodes import Collector
-    from _pytest.nodes import Item
-    from _pytest.outcomes import Exit
-    from _pytest.python import Class
-    from _pytest.python import Function
-    from _pytest.python import Metafunc
-    from _pytest.python import Module
-    from _pytest.reports import CollectReport
-    from _pytest.reports import TestReport
-    from _pytest.runner import CallInfo
-    from _pytest.terminal import TerminalReporter
-    from _pytest.compat import LEGACY_PATH
-
-
-hookspec = HookspecMarker("pytest")
-
-# -------------------------------------------------------------------------
-# Initialization hooks called for every plugin
-# -------------------------------------------------------------------------
-
-
-@hookspec(historic=True)
-def pytest_addhooks(pluginmanager: "PytestPluginManager") -> None:
-    """Called at plugin registration time to allow adding new hooks via a call to
-    ``pluginmanager.add_hookspecs(module_or_class, prefix)``.
-
-    :param pytest.PytestPluginManager pluginmanager: The pytest plugin manager.
-
-    .. note::
-        This hook is incompatible with ``hookwrapper=True``.
-    """
-
-
-@hookspec(historic=True)
-def pytest_plugin_registered(
-    plugin: "_PluggyPlugin", manager: "PytestPluginManager"
-) -> None:
-    """A new pytest plugin got registered.
-
-    :param plugin: The plugin module or instance.
-    :param pytest.PytestPluginManager manager: pytest plugin manager.
-
-    .. note::
-        This hook is incompatible with ``hookwrapper=True``.
-    """
-
-
-@hookspec(historic=True)
-def pytest_addoption(parser: "Parser", pluginmanager: "PytestPluginManager") -> None:
-    """Register 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 <pluginorder>`.
-
-    :param pytest.Parser parser:
-        To add command line options, call
-        :py:func:`parser.addoption(...) <pytest.Parser.addoption>`.
-        To add ini-file values call :py:func:`parser.addini(...)
-        <pytest.Parser.addini>`.
-
-    :param pytest.PytestPluginManager pluginmanager:
-        The pytest plugin manager, which can be used to install :py:func:`hookspec`'s
-        or :py:func:`hookimpl`'s and allow one plugin to call another plugin's hooks
-        to change how command line options are added.
-
-    Options can later be accessed through the
-    :py:class:`config <pytest.Config>` object, respectively:
-
-    - :py:func:`config.getoption(name) <pytest.Config.getoption>` to
-      retrieve the value of a command line option.
-
-    - :py:func:`config.getini(name) <pytest.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.
-
-    .. note::
-        This hook is incompatible with ``hookwrapper=True``.
-    """
-
-
-@hookspec(historic=True)
-def pytest_configure(config: "Config") -> None:
-    """Allow plugins and conftest files to perform initial configuration.
-
-    This hook is called for every plugin and initial conftest file
-    after command line options have been parsed.
-
-    After that, the hook is called for other conftest files as they are
-    imported.
-
-    .. note::
-        This hook is incompatible with ``hookwrapper=True``.
-
-    :param pytest.Config config: The pytest config object.
-    """
-
-
-# -------------------------------------------------------------------------
-# Bootstrapping hooks called for plugins registered early enough:
-# internal and 3rd party plugins.
-# -------------------------------------------------------------------------
-
-
-@hookspec(firstresult=True)
-def pytest_cmdline_parse(
-    pluginmanager: "PytestPluginManager", args: List[str]
-) -> Optional["Config"]:
-    """Return an initialized config object, parsing the specified args.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-
-    .. note::
-        This hook will only be called for plugin classes passed to the
-        ``plugins`` arg when using `pytest.main`_ to perform an in-process
-        test run.
-
-    :param pytest.PytestPluginManager pluginmanager: The pytest plugin manager.
-    :param List[str] args: List of arguments passed on the command line.
-    """
-
-
-@hookspec(warn_on_impl=WARNING_CMDLINE_PREPARSE_HOOK)
-def pytest_cmdline_preparse(config: "Config", args: List[str]) -> None:
-    """(**Deprecated**) modify command line arguments before option parsing.
-
-    This hook is considered deprecated and will be removed in a future pytest version. Consider
-    using :hook:`pytest_load_initial_conftests` instead.
-
-    .. note::
-        This hook will not be called for ``conftest.py`` files, only for setuptools plugins.
-
-    :param pytest.Config config: The pytest config object.
-    :param List[str] args: Arguments passed on the command line.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_cmdline_main(config: "Config") -> Optional[Union["ExitCode", int]]:
-    """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`.
-
-    :param pytest.Config config: The pytest config object.
-    """
-
-
-def pytest_load_initial_conftests(
-    early_config: "Config", parser: "Parser", args: List[str]
-) -> None:
-    """Called to implement the loading of initial conftest files ahead
-    of command line option parsing.
-
-    .. note::
-        This hook will not be called for ``conftest.py`` files, only for setuptools plugins.
-
-    :param pytest.Config early_config: The pytest config object.
-    :param List[str] args: Arguments passed on the command line.
-    :param pytest.Parser parser: To add command line options.
-    """
-
-
-# -------------------------------------------------------------------------
-# collection hooks
-# -------------------------------------------------------------------------
-
-
-@hookspec(firstresult=True)
-def pytest_collection(session: "Session") -> Optional[object]:
-    """Perform the collection phase for the given session.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-    The return value is not used, but only stops further processing.
-
-    The default collection phase is this (see individual hooks for full details):
-
-    1. Starting from ``session`` as the initial collector:
-
-      1. ``pytest_collectstart(collector)``
-      2. ``report = pytest_make_collect_report(collector)``
-      3. ``pytest_exception_interact(collector, call, report)`` if an interactive exception occurred
-      4. For each collected node:
-
-        1. If an item, ``pytest_itemcollected(item)``
-        2. If a collector, recurse into it.
-
-      5. ``pytest_collectreport(report)``
-
-    2. ``pytest_collection_modifyitems(session, config, items)``
-
-      1. ``pytest_deselected(items)`` for any deselected items (may be called multiple times)
-
-    3. ``pytest_collection_finish(session)``
-    4. Set ``session.items`` to the list of collected items
-    5. Set ``session.testscollected`` to the number of collected items
-
-    You can implement this hook to only perform some action before collection,
-    for example the terminal plugin uses it to start displaying the collection
-    counter (and returns `None`).
-
-    :param pytest.Session session: The pytest session object.
-    """
-
-
-def pytest_collection_modifyitems(
-    session: "Session", config: "Config", items: List["Item"]
-) -> None:
-    """Called after collection has been performed. May filter or re-order
-    the items in-place.
-
-    :param pytest.Session session: The pytest session object.
-    :param pytest.Config config: The pytest config object.
-    :param List[pytest.Item] items: List of item objects.
-    """
-
-
-def pytest_collection_finish(session: "Session") -> None:
-    """Called after collection has been performed and modified.
-
-    :param pytest.Session session: The pytest session object.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_ignore_collect(
-    collection_path: Path, path: "LEGACY_PATH", config: "Config"
-) -> Optional[bool]:
-    """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`.
-
-    :param pathlib.Path collection_path : The path to analyze.
-    :param LEGACY_PATH path: The path to analyze (deprecated).
-    :param pytest.Config config: The pytest config object.
-
-    .. versionchanged:: 7.0.0
-        The ``collection_path`` parameter was added as a :class:`pathlib.Path`
-        equivalent of the ``path`` parameter. The ``path`` parameter
-        has been deprecated.
-    """
-
-
-def pytest_collect_file(
-    file_path: Path, path: "LEGACY_PATH", parent: "Collector"
-) -> "Optional[Collector]":
-    """Create a Collector for the given path, or None if not relevant.
-
-    The new node needs to have the specified ``parent`` as a parent.
-
-    :param pathlib.Path file_path: The path to analyze.
-    :param LEGACY_PATH path: The path to collect (deprecated).
-
-    .. versionchanged:: 7.0.0
-        The ``file_path`` parameter was added as a :class:`pathlib.Path`
-        equivalent of the ``path`` parameter. The ``path`` parameter
-        has been deprecated.
-    """
-
-
-# logging hooks for collection
-
-
-def pytest_collectstart(collector: "Collector") -> None:
-    """Collector starts collecting."""
-
-
-def pytest_itemcollected(item: "Item") -> None:
-    """We just collected a test item."""
-
-
-def pytest_collectreport(report: "CollectReport") -> None:
-    """Collector finished collecting."""
-
-
-def pytest_deselected(items: Sequence["Item"]) -> None:
-    """Called for deselected test items, e.g. by keyword.
-
-    May be called multiple times.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_make_collect_report(collector: "Collector") -> "Optional[CollectReport]":
-    """Perform :func:`collector.collect() <pytest.Collector.collect>` and return
-    a :class:`~pytest.CollectReport`.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-    """
-
-
-# -------------------------------------------------------------------------
-# Python test function related hooks
-# -------------------------------------------------------------------------
-
-
-@hookspec(firstresult=True)
-def pytest_pycollect_makemodule(
-    module_path: Path, path: "LEGACY_PATH", parent
-) -> Optional["Module"]:
-    """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`.
-
-    :param pathlib.Path module_path: The path of the module to collect.
-    :param LEGACY_PATH path: The path of the module to collect (deprecated).
-
-    .. versionchanged:: 7.0.0
-        The ``module_path`` parameter was added as a :class:`pathlib.Path`
-        equivalent of the ``path`` parameter.
-
-        The ``path`` parameter has been deprecated in favor of ``fspath``.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_pycollect_makeitem(
-    collector: Union["Module", "Class"], name: str, obj: object
-) -> Union[None, "Item", "Collector", List[Union["Item", "Collector"]]]:
-    """Return a custom item/collector for a Python object in a module, or None.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_pyfunc_call(pyfuncitem: "Function") -> Optional[object]:
-    """Call underlying test function.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-    """
-
-
-def pytest_generate_tests(metafunc: "Metafunc") -> None:
-    """Generate (multiple) parametrized calls to a test function."""
-
-
-@hookspec(firstresult=True)
-def pytest_make_parametrize_id(
-    config: "Config", val: object, argname: str
-) -> Optional[str]:
-    """Return a user-friendly string representation of the given ``val``
-    that will be used by @pytest.mark.parametrize calls, or 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`.
-
-    :param pytest.Config config: The pytest config object.
-    :param val: The parametrized value.
-    :param str argname: The automatic parameter name produced by pytest.
-    """
-
-
-# -------------------------------------------------------------------------
-# runtest related hooks
-# -------------------------------------------------------------------------
-
-
-@hookspec(firstresult=True)
-def pytest_runtestloop(session: "Session") -> Optional[object]:
-    """Perform the main runtest loop (after collection finished).
-
-    The default hook implementation performs the runtest protocol for all items
-    collected in the session (``session.items``), unless the collection failed
-    or the ``collectonly`` pytest option is set.
-
-    If at any point :py:func:`pytest.exit` is called, the loop is
-    terminated immediately.
-
-    If at any point ``session.shouldfail`` or ``session.shouldstop`` are set, the
-    loop is terminated after the runtest protocol for the current item is finished.
-
-    :param pytest.Session session: The pytest session object.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-    The return value is not used, but only stops further processing.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_runtest_protocol(
-    item: "Item", nextitem: "Optional[Item]"
-) -> Optional[object]:
-    """Perform the runtest protocol for a single test item.
-
-    The default runtest protocol is this (see individual hooks for full details):
-
-    - ``pytest_runtest_logstart(nodeid, location)``
-
-    - Setup phase:
-        - ``call = pytest_runtest_setup(item)`` (wrapped in ``CallInfo(when="setup")``)
-        - ``report = pytest_runtest_makereport(item, call)``
-        - ``pytest_runtest_logreport(report)``
-        - ``pytest_exception_interact(call, report)`` if an interactive exception occurred
-
-    - Call phase, if the the setup passed and the ``setuponly`` pytest option is not set:
-        - ``call = pytest_runtest_call(item)`` (wrapped in ``CallInfo(when="call")``)
-        - ``report = pytest_runtest_makereport(item, call)``
-        - ``pytest_runtest_logreport(report)``
-        - ``pytest_exception_interact(call, report)`` if an interactive exception occurred
-
-    - Teardown phase:
-        - ``call = pytest_runtest_teardown(item, nextitem)`` (wrapped in ``CallInfo(when="teardown")``)
-        - ``report = pytest_runtest_makereport(item, call)``
-        - ``pytest_runtest_logreport(report)``
-        - ``pytest_exception_interact(call, report)`` if an interactive exception occurred
-
-    - ``pytest_runtest_logfinish(nodeid, location)``
-
-    :param item: Test item for which the runtest protocol is performed.
-    :param nextitem: The scheduled-to-be-next test item (or None if this is the end my friend).
-
-    Stops at first non-None result, see :ref:`firstresult`.
-    The return value is not used, but only stops further processing.
-    """
-
-
-def pytest_runtest_logstart(
-    nodeid: str, location: Tuple[str, Optional[int], str]
-) -> None:
-    """Called at the start of running the runtest protocol for a single item.
-
-    See :hook:`pytest_runtest_protocol` for a description of the runtest protocol.
-
-    :param str nodeid: Full node ID of the item.
-    :param location: A tuple of ``(filename, lineno, testname)``.
-    """
-
-
-def pytest_runtest_logfinish(
-    nodeid: str, location: Tuple[str, Optional[int], str]
-) -> None:
-    """Called at the end of running the runtest protocol for a single item.
-
-    See :hook:`pytest_runtest_protocol` for a description of the runtest protocol.
-
-    :param str nodeid: Full node ID of the item.
-    :param location: A tuple of ``(filename, lineno, testname)``.
-    """
-
-
-def pytest_runtest_setup(item: "Item") -> None:
-    """Called to perform the setup phase for a test item.
-
-    The default implementation runs ``setup()`` on ``item`` and all of its
-    parents (which haven't been setup yet). This includes obtaining the
-    values of fixtures required by the item (which haven't been obtained
-    yet).
-    """
-
-
-def pytest_runtest_call(item: "Item") -> None:
-    """Called to run the test for test item (the call phase).
-
-    The default implementation calls ``item.runtest()``.
-    """
-
-
-def pytest_runtest_teardown(item: "Item", nextitem: Optional["Item"]) -> None:
-    """Called to perform the teardown phase for a test item.
-
-    The default implementation runs the finalizers and calls ``teardown()``
-    on ``item`` and all of its parents (which need to be torn down). This
-    includes running the teardown phase of fixtures required by the item (if
-    they go out of scope).
-
-    :param nextitem:
-        The scheduled-to-be-next test item (None if no further test item is
-        scheduled). This argument is used to perform exact teardowns, i.e.
-        calling just enough finalizers so that nextitem only needs to call
-        setup functions.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_runtest_makereport(
-    item: "Item", call: "CallInfo[None]"
-) -> Optional["TestReport"]:
-    """Called to create a :class:`~pytest.TestReport` for each of
-    the setup, call and teardown runtest phases of a test item.
-
-    See :hook:`pytest_runtest_protocol` for a description of the runtest protocol.
-
-    :param call: The :class:`~pytest.CallInfo` for the phase.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-    """
-
-
-def pytest_runtest_logreport(report: "TestReport") -> None:
-    """Process the :class:`~pytest.TestReport` produced for each
-    of the setup, call and teardown runtest phases of an item.
-
-    See :hook:`pytest_runtest_protocol` for a description of the runtest protocol.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_report_to_serializable(
-    config: "Config",
-    report: Union["CollectReport", "TestReport"],
-) -> Optional[Dict[str, Any]]:
-    """Serialize the given report object into a data structure suitable for
-    sending over the wire, e.g. converted to JSON."""
-
-
-@hookspec(firstresult=True)
-def pytest_report_from_serializable(
-    config: "Config",
-    data: Dict[str, Any],
-) -> Optional[Union["CollectReport", "TestReport"]]:
-    """Restore a report object previously serialized with
-    :hook:`pytest_report_to_serializable`."""
-
-
-# -------------------------------------------------------------------------
-# Fixture related hooks
-# -------------------------------------------------------------------------
-
-
-@hookspec(firstresult=True)
-def pytest_fixture_setup(
-    fixturedef: "FixtureDef[Any]", request: "SubRequest"
-) -> Optional[object]:
-    """Perform fixture setup execution.
-
-    :returns: The return value of the call to the fixture function.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-
-    .. note::
-        If the fixture function returns None, other implementations of
-        this hook function will continue to be called, according to the
-        behavior of the :ref:`firstresult` option.
-    """
-
-
-def pytest_fixture_post_finalizer(
-    fixturedef: "FixtureDef[Any]", request: "SubRequest"
-) -> None:
-    """Called after fixture teardown, but before the cache is cleared, so
-    the fixture result ``fixturedef.cached_result`` is still available (not
-    ``None``)."""
-
-
-# -------------------------------------------------------------------------
-# test session related hooks
-# -------------------------------------------------------------------------
-
-
-def pytest_sessionstart(session: "Session") -> None:
-    """Called after the ``Session`` object has been created and before performing collection
-    and entering the run test loop.
-
-    :param pytest.Session session: The pytest session object.
-    """
-
-
-def pytest_sessionfinish(
-    session: "Session",
-    exitstatus: Union[int, "ExitCode"],
-) -> None:
-    """Called after whole test run finished, right before returning the exit status to the system.
-
-    :param pytest.Session session: The pytest session object.
-    :param int exitstatus: The status which pytest will return to the system.
-    """
-
-
-def pytest_unconfigure(config: "Config") -> None:
-    """Called before test process is exited.
-
-    :param pytest.Config config: The pytest config object.
-    """
-
-
-# -------------------------------------------------------------------------
-# hooks for customizing the assert methods
-# -------------------------------------------------------------------------
-
-
-def pytest_assertrepr_compare(
-    config: "Config", op: str, left: object, right: object
-) -> Optional[List[str]]:
-    """Return 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.
-
-    :param pytest.Config config: The pytest config object.
-    """
-
-
-def pytest_assertion_pass(item: "Item", lineno: int, orig: str, expl: str) -> None:
-    """Called whenever an assertion passes.
-
-    .. versionadded:: 5.0
-
-    Use this hook to do some processing after a passing assertion.
-    The original assertion information is available in the `orig` string
-    and the pytest introspected assertion information is available in the
-    `expl` string.
-
-    This hook must be explicitly enabled by the ``enable_assertion_pass_hook``
-    ini-file option:
-
-    .. code-block:: ini
-
-        [pytest]
-        enable_assertion_pass_hook=true
-
-    You need to **clean the .pyc** files in your project directory and interpreter libraries
-    when enabling this option, as assertions will require to be re-written.
-
-    :param pytest.Item item: pytest item object of current test.
-    :param int lineno: Line number of the assert statement.
-    :param str orig: String with the original assertion.
-    :param str expl: String with the assert explanation.
-    """
-
-
-# -------------------------------------------------------------------------
-# Hooks for influencing reporting (invoked from _pytest_terminal).
-# -------------------------------------------------------------------------
-
-
-def pytest_report_header(
-    config: "Config", start_path: Path, startdir: "LEGACY_PATH"
-) -> Union[str, List[str]]:
-    """Return a string or list of strings to be displayed as header info for terminal reporting.
-
-    :param pytest.Config config: The pytest config object.
-    :param Path start_path: The starting dir.
-    :param LEGACY_PATH startdir: The starting dir (deprecated).
-
-    .. note::
-
-        Lines returned by a plugin are displayed before those of plugins which
-        ran before it.
-        If you want to have your line(s) displayed first, use
-        :ref:`trylast=True <plugin-hookorder>`.
-
-    .. 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 <pluginorder>`.
-
-    .. versionchanged:: 7.0.0
-        The ``start_path`` parameter was added as a :class:`pathlib.Path`
-        equivalent of the ``startdir`` parameter. The ``startdir`` parameter
-        has been deprecated.
-    """
-
-
-def pytest_report_collectionfinish(
-    config: "Config",
-    start_path: Path,
-    startdir: "LEGACY_PATH",
-    items: Sequence["Item"],
-) -> Union[str, List[str]]:
-    """Return a string or list of strings to be displayed after collection
-    has finished successfully.
-
-    These strings will be displayed after the standard "collected X items" message.
-
-    .. versionadded:: 3.2
-
-    :param pytest.Config config: The pytest config object.
-    :param Path start_path: The starting dir.
-    :param LEGACY_PATH startdir: The starting dir (deprecated).
-    :param items: List of pytest items that are going to be executed; this list should not be modified.
-
-    .. note::
-
-        Lines returned by a plugin are displayed before those of plugins which
-        ran before it.
-        If you want to have your line(s) displayed first, use
-        :ref:`trylast=True <plugin-hookorder>`.
-
-    .. versionchanged:: 7.0.0
-        The ``start_path`` parameter was added as a :class:`pathlib.Path`
-        equivalent of the ``startdir`` parameter. The ``startdir`` parameter
-        has been deprecated.
-    """
-
-
-@hookspec(firstresult=True)
-def pytest_report_teststatus(
-    report: Union["CollectReport", "TestReport"], config: "Config"
-) -> Tuple[str, str, Union[str, Mapping[str, bool]]]:
-    """Return result-category, shortletter and verbose word for status
-    reporting.
-
-    The result-category is a category in which to count the result, for
-    example "passed", "skipped", "error" or the empty string.
-
-    The shortletter is shown as testing progresses, for example ".", "s",
-    "E" or the empty string.
-
-    The verbose word is shown as testing progresses in verbose mode, for
-    example "PASSED", "SKIPPED", "ERROR" or the empty string.
-
-    pytest may style these implicitly according to the report outcome.
-    To provide explicit styling, return a tuple for the verbose word,
-    for example ``"rerun", "R", ("RERUN", {"yellow": True})``.
-
-    :param report: The report object whose status is to be returned.
-    :param config: The pytest config object.
-
-    Stops at first non-None result, see :ref:`firstresult`.
-    """
-
-
-def pytest_terminal_summary(
-    terminalreporter: "TerminalReporter",
-    exitstatus: "ExitCode",
-    config: "Config",
-) -> None:
-    """Add a section to terminal summary reporting.
-
-    :param _pytest.terminal.TerminalReporter terminalreporter: The internal terminal reporter object.
-    :param int exitstatus: The exit status that will be reported back to the OS.
-    :param pytest.Config config: The pytest config object.
-
-    .. versionadded:: 4.2
-        The ``config`` parameter.
-    """
-
-
-@hookspec(historic=True)
-def pytest_warning_recorded(
-    warning_message: "warnings.WarningMessage",
-    when: "Literal['config', 'collect', 'runtest']",
-    nodeid: str,
-    location: Optional[Tuple[str, int, str]],
-) -> None:
-    """Process a warning captured by the internal pytest warnings plugin.
-
-    :param warnings.WarningMessage warning_message:
-        The captured warning. This is the same object produced by :py:func:`warnings.catch_warnings`, and contains
-        the same attributes as the parameters of :py:func:`warnings.showwarning`.
-
-    :param str when:
-        Indicates when the warning was captured. Possible values:
-
-        * ``"config"``: during pytest configuration/initialization stage.
-        * ``"collect"``: during test collection.
-        * ``"runtest"``: during test execution.
-
-    :param str nodeid:
-        Full id of the item.
-
-    :param tuple|None location:
-        When available, holds information about the execution context of the captured
-        warning (filename, linenumber, function). ``function`` evaluates to <module>
-        when the execution context is at the module level.
-
-    .. versionadded:: 6.0
-    """
-
-
-# -------------------------------------------------------------------------
-# Hooks for influencing skipping
-# -------------------------------------------------------------------------
-
-
-def pytest_markeval_namespace(config: "Config") -> Dict[str, Any]:
-    """Called when constructing the globals dictionary used for
-    evaluating string conditions in xfail/skipif markers.
-
-    This is useful when the condition for a marker requires
-    objects that are expensive or impossible to obtain during
-    collection time, which is required by normal boolean
-    conditions.
-
-    .. versionadded:: 6.2
-
-    :param pytest.Config config: The pytest config object.
-    :returns: A dictionary of additional globals to add.
-    """
-
-
-# -------------------------------------------------------------------------
-# error handling and internal debugging hooks
-# -------------------------------------------------------------------------
-
-
-def pytest_internalerror(
-    excrepr: "ExceptionRepr",
-    excinfo: "ExceptionInfo[BaseException]",
-) -> Optional[bool]:
-    """Called for internal errors.
-
-    Return True to suppress the fallback handling of printing an
-    INTERNALERROR message directly to sys.stderr.
-    """
-
-
-def pytest_keyboard_interrupt(
-    excinfo: "ExceptionInfo[Union[KeyboardInterrupt, Exit]]",
-) -> None:
-    """Called for keyboard interrupt."""
-
-
-def pytest_exception_interact(
-    node: Union["Item", "Collector"],
-    call: "CallInfo[Any]",
-    report: Union["CollectReport", "TestReport"],
-) -> None:
-    """Called when an exception was raised which can potentially be
-    interactively handled.
-
-    May be called during collection (see :hook:`pytest_make_collect_report`),
-    in which case ``report`` is a :class:`CollectReport`.
-
-    May be called during runtest of an item (see :hook:`pytest_runtest_protocol`),
-    in which case ``report`` is a :class:`TestReport`.
-
-    This hook is not called if the exception that was raised is an internal
-    exception like ``skip.Exception``.
-    """
-
-
-def pytest_enter_pdb(config: "Config", pdb: "pdb.Pdb") -> None:
-    """Called upon pdb.set_trace().
-
-    Can be used by plugins to take special action just before the python
-    debugger enters interactive mode.
-
-    :param pytest.Config config: The pytest config object.
-    :param pdb.Pdb pdb: The Pdb instance.
-    """
-
-
-def pytest_leave_pdb(config: "Config", pdb: "pdb.Pdb") -> None:
-    """Called when leaving pdb (e.g. with continue after pdb.set_trace()).
-
-    Can be used by plugins to take special action just after the python
-    debugger leaves interactive mode.
-
-    :param pytest.Config config: The pytest config object.
-    :param pdb.Pdb pdb: The Pdb instance.
-    """