floraachy
/
pytest2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs changes about limitations with hook function ordering

This commit is contained in:
Leeds9z 2023-11-24 11:03:01 -05:00
parent acab13fcc9
commit 62c2488058
1 changed files with 5 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/en/how-to/writing_hook_functions.rst
View File

@ -117,6 +117,10 @@ Hook function ordering / call example
For any given hook specification there may be more than one For any given hook specification there may be more than one
implementation and we thus generally view ``hook`` execution as a implementation and we thus generally view ``hook`` execution as a
``1:N`` function call where ``N`` is the number of registered functions. ``1:N`` function call where ``N`` is the number of registered functions.
There are certain limitations about hooks starting with ``_pytest``. For
more information, consult :ref:`Declaring new hooks <new-hooks>`.
There are ways to influence if a hook implementation comes before or There are ways to influence if a hook implementation comes before or
after others, i.e. the position in the ``N``-sized list of functions: after others, i.e. the position in the ``N``-sized list of functions:
@ -165,6 +169,7 @@ Here is the order of execution:
It's possible to use ``tryfirst`` and ``trylast`` also on hook wrappers It's possible to use ``tryfirst`` and ``trylast`` also on hook wrappers
in which case it will influence the ordering of hook wrappers among each other. in which case it will influence the ordering of hook wrappers among each other.
.. _`new-hooks`:
Declaring new hooks Declaring new hooks
------------------------ ------------------------