diff --git a/AUTHORS b/AUTHORS index b9879804a..577c4dcd1 100644 --- a/AUTHORS +++ b/AUTHORS @@ -59,6 +59,7 @@ Christopher Gilling Christopher Dignam CrazyMerlyn Cyrus Maden +Damian Skrzypczak Dhiren Serai Daniel Grana Daniel Hahler diff --git a/changelog/5171.doc.rst b/changelog/5171.doc.rst new file mode 100644 index 000000000..7cdbad0f5 --- /dev/null +++ b/changelog/5171.doc.rst @@ -0,0 +1 @@ +Doc: ``pytest_ignore_collect``, ``pytest_collect_directory``, ``pytest_collect_file`` and ``pytest_pycollect_makemodule`` hooks's 'path' parameter documented type is now ``py.path.local`` diff --git a/src/_pytest/hookspec.py b/src/_pytest/hookspec.py index 5a3eb282d..02b1b4524 100644 --- a/src/_pytest/hookspec.py +++ b/src/_pytest/hookspec.py @@ -188,7 +188,7 @@ def pytest_ignore_collect(path, config): Stops at first non-None result, see :ref:`firstresult` - :param str path: the path to analyze + :param path: a :py:class:`py.path.local` - the path to analyze :param _pytest.config.Config config: pytest config object """ @@ -199,7 +199,7 @@ def pytest_collect_directory(path, parent): Stops at first non-None result, see :ref:`firstresult` - :param str path: the path to analyze + :param path: a :py:class:`py.path.local` - the path to analyze """ @@ -207,7 +207,7 @@ def pytest_collect_file(path, parent): """ return collection Node or None for the given path. Any new node needs to have the specified ``parent`` as a parent. - :param str path: the path to collect + :param path: a :py:class:`py.path.local` - the path to collect """ @@ -249,7 +249,10 @@ def pytest_pycollect_makemodule(path, parent): 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` """ + Stops at first non-None result, see :ref:`firstresult` + + :param path: a :py:class:`py.path.local` - the path of module to collect + """ @hookspec(firstresult=True)