diff --git a/AUTHORS b/AUTHORS index 347efad57..558def36d 100644 --- a/AUTHORS +++ b/AUTHORS @@ -70,6 +70,7 @@ Brian Maissy Brian Okken Brianna Laugher Bruno Oliveira +Bryce Gattis Cal Jacobson Cal Leeming Carl Friedrich Bolz diff --git a/changelog/12245.doc.rst b/changelog/12245.doc.rst new file mode 100644 index 000000000..5ac753503 --- /dev/null +++ b/changelog/12245.doc.rst @@ -0,0 +1 @@ +Added paragraph in ``Specifying which tests to run`` documentation to clarify pytest capabilities when trying to run tests for a single module. diff --git a/doc/en/how-to/usage.rst b/doc/en/how-to/usage.rst index fe46fad2d..b6afb1cda 100644 --- a/doc/en/how-to/usage.rst +++ b/doc/en/how-to/usage.rst @@ -26,6 +26,11 @@ Pytest supports several ways to run and select tests from the command-line or fr pytest test_mod.py +When passing a path as a positional argument, pytest does not recursively +search when given a file basename. If you want to pass a path to a file, you +must pass either a relative path or an absolute path. Otherwise, consider the +below keyword expressions instead. + **Run tests in a directory** .. code-block:: bash