Merge pull request #974 from nicoddemus/addoption-conftest

Add warning about implementing pytest_addoption in conftest files
This commit is contained in:
Floris Bruynooghe 2015-09-21 11:28:31 +01:00
commit 80897f62a6
1 changed files with 9 additions and 2 deletions

View File

@ -30,8 +30,15 @@ def pytest_plugin_registered(plugin, manager):
def pytest_addoption(parser):
"""register argparse-style options and ini-style config values.
This function must be implemented in a :ref:`plugin <pluginorder>` and is
called once at the beginning of a test run.
.. warning::
This function must be implemented in a :ref:`plugin <pluginorder>`
and is called once at the beginning of a test run.
Implementing this hook from ``conftest.py`` files is **strongly**
discouraged because ``conftest.py`` files are lazily loaded and
may give strange *unknown option* errors depending on the directory
``py.test`` is invoked from.
:arg parser: To add command line options, call
:py:func:`parser.addoption(...) <_pytest.config.Parser.addoption>`.