pytest-8.1.0 (Python module)

[Bruce Dubbs]

New minor version. Seems to be a lot of releases lately.

[Xi Ruoyao]

Features

• ​#11475: Added the new consider_namespace_packages configuration option, defaulting to False.

If set to True, pytest will attempt to identify modules that are part of ​namespace packages when importing modules.

• ​#11653: Added the new verbosity_test_cases configuration option for fine-grained control of test execution verbosity. See pytest.fine_grained_verbosity for more details.

Improvements

• ​#10865: pytest.warns now validates that warnings.warn was called with a str or a Warning. Currently in Python it is possible to use other types, however this causes an exception when warnings.filterwarnings is used to filter those warnings (see ​CPython #103577 for a discussion). While this can be considered a bug in CPython, we decided to put guards in pytest as the error message produced without this check in place is confusing.
• ​#11311 When using --override-ini for paths in invocations without a configuration file defined, the current working directory is used as the relative directory.

Previoulsy this would raise an AssertionError.

• ​#11475: --import-mode=importlib now tries to import modules using the standard import mechanism (but still without changing sys.path), falling back to importing modules directly only if that fails.

This means that installed packages will be imported under their canonical name if possible first, for example app.core.models, instead of having the module name always be derived from their path (for example .env310.lib.site_packages.app.core.models).

• ​#11801: Added the iter_parents() helper method on nodes. It is similar to listchain, but goes from bottom to top, and returns an iterator, not a list.
• ​#11850: Added support for sys.last_exc for post-mortem debugging on Python>=3.12.
• ​#11962: In case no other suitable candidates for configuration file are found, a pyproject.toml (even without a [tool.pytest.ini_options] table) will be considered as the configuration file and define the rootdir.
• ​#11978: Add --log-file-mode option to the logging plugin, enabling appending to log-files. This option accepts either "w" or "a" and defaults to "w".

Previously, the mode was hard-coded to be "w" which truncates the file before logging.

• ​#12047: When multiple finalizers of a fixture raise an exception, now all exceptions are reported as an exception group. Previously, only the first exception was reported.

Bug Fixes

• ​#11904: Fixed a regression in pytest 8.0.0 that would cause test collection to fail due to permission errors when using --pyargs.

This change improves the collection tree for tests specified using --pyargs, see ​#12043 for a comparison with pytest 8.0 and <8.

• ​#12011: Fixed a regression in 8.0.1 whereby setup_module xunit-style fixtures are not executed when --doctest-modules is passed.
• ​#12014: Fix the stacklevel used when warning about marks used on fixtures.
• ​#12039: Fixed a regression in 8.0.2 where tests created using tmp_path have been collected multiple times in CI under Windows.

Improved Documentation

• ​#11790: Documented the retention of temporary directories created using the tmp_path fixture in more detail.

Trivial/Internal Changes

• ​#11785: Some changes were made to private functions which may affect plugins which access them:
  • FixtureManager._getautousenames() now takes a Node itself instead of the nodeid.
  • FixtureManager.getfixturedefs() now takes the Node itself instead of the nodeid.
  • The _pytest.nodes.iterparentnodeids() function is removed without replacement. Prefer to traverse the node hierarchy itself instead. If you really need to, copy the function from the previous pytest release.

[Douglas R. Reno]

Fixed at 383c5a2af5021c38b13f1af8d0352bebd7e24073