Clarify pytest_ignore_collect docs

Fixes #12383
This commit is contained in:
Bruno Oliveira 2024-05-28 13:14:58 -03:00 committed by GitHub
parent 48cb8a2b32
commit df2fccdd4b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 6 additions and 1 deletions

View File

@ -311,7 +311,12 @@ def pytest_collection_finish(session: "Session") -> None:
def pytest_ignore_collect( def pytest_ignore_collect(
collection_path: Path, path: "LEGACY_PATH", config: "Config" collection_path: Path, path: "LEGACY_PATH", config: "Config"
) -> Optional[bool]: ) -> Optional[bool]:
"""Return True to prevent considering this path for collection. """Return ``True`` to prevent considering this path for collection.
Return ``None`` to let other plugins ignore the path for collection.
Returning ``False`` will forcefully consider this path to be considered
for collection, without giving a chance of other plugins to ignore this file.
This hook is consulted for all files and directories prior to calling This hook is consulted for all files and directories prior to calling
more specific hooks. more specific hooks.