The pytest framework makes it easy to write small tests, yet scales to support complex functional testing
sys.stderr
{.interpreted-text role="data"} and sys.__stderr__
{.interpreted-text role="data"} might already be closed when faulthandler
{.interpreted-text role="ref"} is tearing down.__iter__
methods. Now they are treated un-iterable instead.--junitxml
with --junit-xml
and --collectonly
with --collect-only
.#10447: Markers are now considered in the reverse mro order to ensure base class markers are considered first -- this resolves a regression.
#11239: Fixed :=
in asserts impacting unrelated test cases.
#11439: Handled an edge case where :data:sys.stderr
might already be closed when :ref:faulthandler
is tearing down.
#11237: Fix doctest collection of functools.cached_property
objects.
#11306: Fixed bug using --importmode=importlib
which would cause package __init__.py
files to be imported more than once in some cases.
#11367: Fixed bug where user_properties
where not being saved in the JUnit XML file if a fixture failed during teardown.
#11394: Fixed crash when parsing long command line arguments that might be interpreted as files.
#10337: Fixed bug where fake intermediate modules generated by --import-mode=importlib
would not include the
child modules as attributes of the parent modules.
#10702: Fixed error assertion handling in pytest.approx
when None
is an expected or received value when comparing dictionaries.
#10811: Fixed issue when using --import-mode=importlib
together with --doctest-modules
that caused modules
to be imported more than once, causing problems with modules that have import side effects.
ExceptionInfo.from_exception() <pytest.ExceptionInfo.from_exception>
{.interpreted-text role="func"}, a simpler way to create an ~pytest.ExceptionInfo
{.interpreted-text role="class"} from an exception.
This can replace ExceptionInfo.from_exc_info() <pytest.ExceptionInfo.from_exc_info()>
{.interpreted-text role="func"} for most uses.#10872: Update test log report annotation to named tuple and fixed inconsistency in docs for pytest_report_teststatus
{.interpreted-text role="hook"} hook.
#10907: When an exception traceback to be displayed is completely filtered out (by mechanisms such as __tracebackhide__
, internal frames, and similar), now only the exception string and the following message are shown:
"All traceback entries are hidden. Pass [--full-trace]{.title-ref} to see hidden and internal frames.".
Previously, the last frame of the traceback was shown, even though it was hidden.
#10940: Improved verbose output (-vv
) of skip
and xfail
reasons by performing text wrapping while leaving a clear margin for progress output.
Added TerminalReporter.wrap_write()
as a helper for that.
#10991: Added handling of %f
directive to print microseconds in log format options, such as log-date-format
.
#11005: Added the underlying exception to the cache provider's path creation and write warning messages.
#11013: Added warning when testpaths
{.interpreted-text role="confval"} is set, but paths are not found by glob. In this case, pytest will fall back to searching from the current directory.
#11043: When [--confcutdir]{.title-ref} is not specified, and there is no config file present, the conftest cutoff directory ([--confcutdir]{.title-ref}) is now set to the rootdir <rootdir>
{.interpreted-text role="ref"}.
Previously in such cases, [conftest.py]{.title-ref} files would be probed all the way to the root directory of the filesystem.
If you are badly affected by this change, consider adding an empty config file to your desired cutoff directory, or explicitly set [--confcutdir]{.title-ref}.
#11081: The norecursedirs
{.interpreted-text role="confval"} check is now performed in a pytest_ignore_collect
{.interpreted-text role="hook"} implementation, so plugins can affect it.
If after updating to this version you see that your [norecursedirs]{.title-ref} setting is not being respected, it means that a conftest or a plugin you use has a bad [pytest_ignore_collect]{.title-ref} implementation. Most likely, your hook returns [False]{.title-ref} for paths it does not want to ignore, which ends the processing and doesn't allow other plugins, including pytest itself, to ignore the path. The fix is to return [None]{.title-ref} instead of [False]{.title-ref} for paths your hook doesn't want to ignore.
#8711: caplog.set_level() <pytest.LogCaptureFixture.set_level>
{.interpreted-text role="func"} and caplog.at_level() <pytest.LogCaptureFixture.at_level>
{.interpreted-text role="func"}
will temporarily enable the requested level
if level
was disabled globally via
logging.disable(LEVEL)
.
--tb=line
mode where pytest.fail(pytrace=False)
tests report None
.--last-failed
whole-file skipping functionality ("skipped N files") for non-python test files <non-python tests>
{.interpreted-text role="ref"}.testpaths
{.interpreted-text role="confval"} to be considered for loading initial conftests,
even when it was not utilized (e.g. when explicit paths were given on the command line).
Now the testpaths
are only considered when they are in use.__tracebackhide__ = True
still being shown for chained exceptions (parts after "... the above exception ..." message).--debug
.caplog.set_level() <pytest.LogCaptureFixture.set_level>
{.interpreted-text role="func"}.-c
to now include --config-file
to make it clear that this flag applies to the usage of a custom config file.OSError: [Errno 36] File name too long
on some systems.testpaths
{.interpreted-text role="confval"} is now honored to load root conftests
.--last-failed
's "(skipped N files)" functionality for files inside of packages (directories with [__init__.py]{.title-ref} files).RuntimeError: TestResult has no addDuration method
when running unittest
tests.shutil.rmtree(onerror=...)
deprecation warning when using tmp_path
{.interpreted-text role="fixture"}.tmp_path
{.interpreted-text role="fixture"} and the new tmp_path_retention_policy
{.interpreted-text role="confval"} option.INTERNALERROR IndexError: list index out of range
which happens when displaying an exception where all entries are hidden.
This reverts the change "Correctly handle __tracebackhide__
for chained exceptions." introduced in version 7.3.0.@classmethod
can now be discovered as tests, following the same rules as normal methods. This fills the gap that static methods were discoverable as tests but not class methods.console_output_style
{.interpreted-text role="confval"} now supports progress-even-when-capture-no
to force the use of the progress output even when capture is disabled. This is useful in large test suites where capture may have significant performance impact.--log-disable
CLI option added to disable individual loggers.tmp_path_retention_count
{.interpreted-text role="confval"} and tmp_path_retention_policy
{.interpreted-text role="confval"} configuration options to control how directories created by the tmp_path
{.interpreted-text role="fixture"} fixture are kept.ExceptionGroup
of them instead of discarding all but the last.-p
arguments to include spaces (eg: -p no:logging
instead of
-pno:logging
). Mostly useful in the addopts
section of the configuration
file.start
and stop
timestamps to TestReport
objects.rootdir
, config file
and testpaths
so each has its own line.tmp_path
{.interpreted-text role="fixture"} fixture always raising OSError
{.interpreted-text role="class"} on emscripten
platform due to missing os.getuid
{.interpreted-text role="func"}.__tracebackhide__
for chained exceptions.goodpractices
{.interpreted-text role="ref"}: pip install -e .
requires a version
entry in pyproject.toml
to run successfully.pytest.approx
{.interpreted-text role="func"} handling of dictionaries containing one or more values of [0.0]{.title-ref}.teardown
would be called as part of nose
teardown stage.--fixtures
and --help
are passed at the same time.pytest.raises
{.interpreted-text role="func"} to return a 'ContextManager' so that type-checkers could narrow
pytest.raises(...) if ... else nullcontext()
down to 'ContextManager' rather than 'object'.rootdir <rootdir>
{.interpreted-text role="ref"} on Windows.