v3.34.0

Compare Source

Features

• Job creation mode GA (#​2190) (64cd39f)

Bug Fixes

• deps: Update all dependencies (#​2184) (12490f2)

Documentation

• Update query.py (#​2192) (9b5ee78)
• Use query_and_wait in the array parameters sample (#​2202) (28a9994)

v3.33.0

Compare Source

Features

• Add ability to set autodetect_schema query param in update_table (#​2171) (57f940d)
• Add dtype parameters to to_geodataframe functions (#​2176) (ebfd0a8)
• Support job reservation (#​2186) (cb646ce)

Bug Fixes

• Ensure AccessEntry equality and repr uses the correct entity_type (#​2182) (0217637)
• Ensure SchemaField.field_dtype returns a string (#​2188) (7ec2848)

v3.32.0

Compare Source

Features

• Add dataset access policy version attribute (#​2169) (b7656b9)
• Add preview support for incremental results (#​2145) (22b80bb)
• Add WRITE_TRUNCATE_DATA enum (#​2166) (4692747)
• Adds condition class and assoc. unit tests (#​2159) (a69d6b7)
• Support BigLakeConfiguration (managed Iceberg tables) (#​2162) (a1c8e9a)
• Update the AccessEntry class with a new condition attribute and unit tests (#​2163) (7301667)

Bug Fixes

• query() now warns when job_id is set and the default job_retry is ignored (#​2167) (ca1798a)
• Empty record dtypes (#​2147) (77d7173)
• Table iterator should not use bqstorage when page_size is not None (#​2154) (e89a707)

v3.31.0

Compare Source

Features

• Add query text and total bytes processed to RowIterator (#​2140) (2d5f932)
• Add support for Python 3.13 (0842aa1)

Bug Fixes

• Adding property setter for table constraints, #​1990 (#​2092) (f8572dd)
• Allow protobuf 6.x (0842aa1)
• Avoid "Unable to determine type" warning with JSON columns in to_dataframe (#​1876) (968020d)
• Remove setup.cfg configuration for creating universal wheels (#​2146) (d7f7685)

Dependencies

• Remove Python 3.7 and 3.8 as supported runtimes (#​2133) (fb7de39)

v2.32.0

Compare Source

Features

• Add BigQuery Metastore Partition Service API version v1beta (#​941) (fa8c533)

Bug Fixes

• Separate create_stream() in pyarrow sample (#​946) (127e70c)

v2.31.0

Compare Source

Features

• v1alpha: Increased the number of partitions can be written in a single request (1f2ed7e)

Documentation

• v1alpha: Updated the number of partitions (from 100 to 900) that can be inserted, updated and deleted in a single request (1f2ed7e)

v2.30.0

Compare Source

Features

• Link stream to use _Connection (#​901) (28e0529)
• Sample for AppendRowsStream with Arrow (#​915) (a6df546)

Bug Fixes

• Remove setup.cfg configuration for creating universal wheels (#​913) (a1fa1c7)

v1.6.4

Compare Source

Miscellaneous Chores

• Force release for testing (#​279) (7333a49)

v1.6.3

Compare Source

Miscellaneous Chores

• Force release for testing (#​277) (05ad7f1)

v1.6.2

Compare Source

Miscellaneous Chores

• Force rebuild (#​275) (40fb90e)

v1.6.1

Compare Source

Bug Fixes

• Remove setup.cfg configuration for creating universal wheels (#​272) (32a23d2)

v0.29.0

Compare Source

Features

• Instrument vscode, jupyter and 3p plugin usage (#​925) (7d354f1)

v0.28.1

Compare Source

Bug Fixes

• Remove setup.cfg configuration for creating universal wheels (#​898) (b3a9af2)
• Remove unnecessary global variable definition (#​907) (d4d85ce)
• Resolve issue where pre-release versions of dependencies are installed (#​890) (3574ca1)

v8.4.0

Compare Source

pytest 8.4.0 (2025-06-02)

Removals and backward incompatible breaking changes

• #​11372: Async tests will now fail, instead of warning+skipping, if you don't have any suitable plugin installed.

• #​12346: Tests will now fail, instead of raising a warning, if they return any value other than None.

• #​12874: We dropped support for Python 3.8 following its end of life (2024-10-07).

• #​12960: Test functions containing a yield now cause an explicit error. They have not been run since pytest 4.0, and were previously marked as an expected failure and deprecation warning.

  See the docs <yield tests deprecated>{.interpreted-text role="ref"} for more information.

Deprecations (removal in next major release)

• #​10839: Requesting an asynchronous fixture without a [pytest_fixture_setup]{.title-ref} hook that resolves it will now give a DeprecationWarning. This most commonly happens if a sync test requests an async fixture. This should have no effect on a majority of users with async tests or fixtures using async pytest plugins, but may affect non-standard hook setups or autouse=True. For guidance on how to work around this warning see sync-test-async-fixture{.interpreted-text role="ref"}.

New features

• #​11538: Added pytest.RaisesGroup{.interpreted-text role="class"} as an equivalent to pytest.raises{.interpreted-text role="func"} for expecting ExceptionGroup{.interpreted-text role="exc"}. Also adds pytest.RaisesExc{.interpreted-text role="class"} which is now the logic behind pytest.raises{.interpreted-text role="func"} and used as parameter to pytest.RaisesGroup{.interpreted-text role="class"}. RaisesGroup includes the ability to specify multiple different expected exceptions, the structure of nested exception groups, and flags for emulating except* <except_star>{.interpreted-text role="ref"}. See assert-matching-exception-groups{.interpreted-text role="ref"} and docstrings for more information.

• #​12081: Added capteesys{.interpreted-text role="fixture"} to capture AND pass output to next handler set by --capture=.

• #​12504: pytest.mark.xfail{.interpreted-text role="func"} now accepts pytest.RaisesGroup{.interpreted-text role="class"} for the raises parameter when you expect an exception group. You can also pass a pytest.RaisesExc{.interpreted-text role="class"} if you e.g. want to make use of the check parameter.

• #​12713: New [--force-short-summary]{.title-ref} option to force condensed summary output regardless of verbosity level.

  This lets users still see condensed summary output of failures for quick reference in log files from job outputs, being especially useful if non-condensed output is very verbose.

• #​12749: pytest traditionally collects classes/functions in the test module namespace even if they are imported from another file.

  For example:

contents of src/domain.py

class Testament: ...

contents of tests/test_testament.py

from domain import Testament

def test_testament(): ...
```

In this scenario with the default options, pytest will collect the class [Testament]{.title-ref} from [tests/test_testament.py]{.title-ref} because it starts with [Test]{.title-ref}, even though in this case it is a production class being imported in the test module namespace.

This behavior can now be prevented by setting the new `collect_imported_tests`{.interpreted-text role="confval"} configuration option to `false`, which will make pytest collect classes/functions from test files **only** if they are defined in that file.

\-- by `FreerGit`{.interpreted-text role="user"}

• #​12765: Thresholds to trigger snippet truncation can now be set with truncation_limit_lines{.interpreted-text role="confval"} and truncation_limit_chars{.interpreted-text role="confval"}.

  See truncation-params{.interpreted-text role="ref"} for more information.

• #​13125: console_output_style{.interpreted-text role="confval"} now supports times to show execution time of each test.

• #​13192: pytest.raises{.interpreted-text role="func"} will now raise a warning when passing an empty string to match, as this will match against any value. Use match="^$" if you want to check that an exception has no message.

• #​13192: pytest.raises{.interpreted-text role="func"} will now print a helpful string diff if matching fails and the match parameter has ^ and $ and is otherwise escaped.

• #​13192: You can now pass with pytest.raises(check=fn): <pytest.raises>{.interpreted-text role="func"}, where fn is a function which takes a raised exception and returns a boolean. The raises fails if no exception was raised (as usual), passes if an exception is raised and fn returns True (as well as match and the type matching, if specified, which are checked before), and propagates the exception if fn returns False (which likely also fails the test).

• #​13228: hidden-param{.interpreted-text role="ref"} can now be used in id of pytest.param{.interpreted-text role="func"} or in
  ids of Metafunc.parametrize <pytest.Metafunc.parametrize>{.interpreted-text role="py:func"}.
  It hides the parameter set from the test name.

• #​13253: New flag: --disable-plugin-autoload <disable_plugin_autoload>{.interpreted-text role="ref"} which works as an alternative to PYTEST_DISABLE_PLUGIN_AUTOLOAD{.interpreted-text role="envvar"} when setting environment variables is inconvenient; and allows setting it in config files with addopts{.interpreted-text role="confval"}.

Improvements in existing functionality

• #​10224: pytest's short and long traceback styles (how-to-modifying-python-tb-printing{.interpreted-text role="ref"})
  now have partial 657{.interpreted-text role="pep"} support and will show specific code segments in the
  traceback.

  ================================= FAILURES =================================
  _______________________ test_gets_correct_tracebacks _______________________
  
  test_tracebacks.py:12: in test_gets_correct_tracebacks
      assert manhattan_distance(p1, p2) == 1
             ^^^^^^^^^^^^^^^^^^^^^^^^^^
  test_tracebacks.py:6: in manhattan_distance
      return abs(point_1.x - point_2.x) + abs(point_1.y - point_2.y)
                             ^^^^^^^^^
  E   AttributeError: 'NoneType' object has no attribute 'x'
  

  -- by ammaraskar{.interpreted-text role="user"}

• #​11118: Now pythonpath{.interpreted-text role="confval"} configures [$PYTHONPATH]{.title-ref} earlier than before during the initialization process, which now also affects plugins loaded via the [-p]{.title-ref} command-line option.

  -- by millerdev{.interpreted-text role="user"}

• #​11381: The type parameter of the parser.addini method now accepts ["int"]{.title-ref} and "float" parameters, facilitating the parsing of configuration values in the configuration file.

  Example:

  def pytest_addoption(parser):
      parser.addini("int_value", type="int", default=2, help="my int value")
      parser.addini("float_value", type="float", default=4.2, help="my float value")

  The [pytest.ini]{.title-ref} file:

  [pytest]
  int_value = 3
  float_value = 5.4

• #​11525: Fixtures are now clearly represented in the output as a "fixture object", not as a normal function as before, making it easy for beginners to catch mistakes such as referencing a fixture declared in the same module but not requested in the test function.

  -- by the-compiler{.interpreted-text role="user"} and glyphack{.interpreted-text role="user"}

• #​12426: A warning is now issued when pytest.mark.usefixtures ref{.interpreted-text role="ref"} is used without specifying any fixtures. Previously, empty usefixtures markers were silently ignored.

• #​12707: Exception chains can be navigated when dropped into Pdb in Python 3.13+.

• #​12736: Added a new attribute [name]{.title-ref} with the fixed value ["pytest tests"]{.title-ref} to the root tag [testsuites]{.title-ref} of the junit-xml generated by pytest.

  This attribute is part of many junit-xml specifications and is even part of the [junit-10.xsd]{.title-ref} specification that pytest's implementation is based on.

• #​12943: If a test fails with an exceptiongroup with a single exception, the contained exception will now be displayed in the short test summary info.

• #​12958: A number of unraisable <unraisable>{.interpreted-text role="ref"} enhancements:

  • Set the unraisable hook as early as possible and unset it as late as possible, to collect the most possible number of unraisable exceptions.
  • Call the garbage collector just before unsetting the unraisable hook, to collect any straggling exceptions.
  • Collect multiple unraisable exceptions per test phase.
  • Report the tracemalloc{.interpreted-text role="mod"} allocation traceback (if available).
  • Avoid using a generator based hook to allow handling StopIteration{.interpreted-text role="class"} in test failures.
  • Report the unraisable exception as the cause of the pytest.PytestUnraisableExceptionWarning{.interpreted-text role="class"} exception if raised.
  • Compute the repr of the unraisable object in the unraisable hook so you get the latest information if available, and should help with resurrection of the object.

• #​13010: pytest.approx{.interpreted-text role="func"} now can compare collections that contain numbers and non-numbers mixed.

• #​13016: A number of threadexception <unraisable>{.interpreted-text role="ref"} enhancements:

  • Set the excepthook as early as possible and unset it as late as possible, to collect the most possible number of unhandled exceptions from threads.
  • Collect multiple thread exceptions per test phase.
  • Report the tracemalloc{.interpreted-text role="mod"} allocation traceback (if available).
  • Avoid using a generator based hook to allow handling StopIteration{.interpreted-text role="class"} in test failures.
  • Report the thread exception as the cause of the pytest.PytestUnhandledThreadExceptionWarning{.interpreted-text role="class"} exception if raised.
  • Extract the name of the thread object in the excepthook which should help with resurrection of the thread.

• #​13031: An empty parameter set as in pytest.mark.parametrize([], ids=idfunc) will no longer trigger a call to idfunc with internal objects.

• #​13115: Allows supplying ExceptionGroup[Exception] and BaseExceptionGroup[BaseException] to pytest.raises to keep full typing on ExceptionInfo <pytest.ExceptionInfo>{.interpreted-text role="class"}:

  with pytest.raises(ExceptionGroup[Exception]) as exc_info:
      some_function()

  Parametrizing with other exception types remains an error - we do not check the types of child exceptions and thus do not permit code that might look like we do.

• #​13122: The --stepwise mode received a number of improvements:

  • It no longer forgets the last failed test in case pytest is executed later without the flag.

    This enables the following workflow:

    1. Execute pytest with --stepwise, pytest then stops at the first failing test;
    2. Iteratively update the code and run the test in isolation, without the --stepwise flag (for example in an IDE), until it is fixed.
    3. Execute pytest with --stepwise again and pytest will continue from the previously failed test, and if it passes, continue on to the next tests.

    Previously, at step 3, pytest would start from the beginning, forgetting the previously failed test.

    This change however might cause issues if the --stepwise mode is used far apart in time, as the state might get stale, so the internal state will be reset automatically in case the test suite changes (for now only the number of tests are considered for this, we might change/improve this on the future).

  • New --stepwise-reset/--sw-reset flag, allowing the user to explicitly reset the stepwise state and restart the workflow from the beginning.

• #​13308: Added official support for Python 3.14.

• #​13380: Fix ExceptionGroup{.interpreted-text role="class"} traceback filtering to exclude pytest internals.

• #​13415: The author metadata of the BibTex example is now correctly formatted with last names following first names.
  An example of BibLaTex has been added.
  BibTex and BibLaTex examples now clearly indicate that what is cited is software.

  -- by willynilly{.interpreted-text role="user"}

• #​13420: Improved test collection performance by optimizing path resolution used in FSCollector.

• #​13457: The error message about duplicate parametrization no longer displays an internal stack trace.

• #​4112: Using pytest.mark.usefixtures <pytest.mark.usefixtures ref>{.interpreted-text role="ref"} on pytest.param{.interpreted-text role="func"} now produces an error instead of silently doing nothing.

• #​5473: Replace [:]{.title-ref} with [;]{.title-ref} in the assertion rewrite warning message so it can be filtered using standard Python warning filters before calling pytest.main{.interpreted-text role="func"}.

[#​6985](https://redirect.github.com/pytest-dev/pytest/issues/6985): Improved `pytest.approx`{.interpreted-text role="func"} to enhance the readability of value ranges and tolerances between 0.001 and 1000.

:   -   The [repr]{.title-ref} method now provides clearer output for values within those ranges, making it easier to interpret the results.

    -   Previously, the output for those ranges of values and tolerances was displayed in scientific notation (e.g., [42 ± 1.0e+00]{.title-ref}). The updated method now presents the tolerance as a decimal for better readability (e.g., [42 ± 1]{.title-ref}).

        Example:

        **Previous Output:**

        ``` console
        >>> pytest.approx(42, abs=1)
        42 ± 1.0e+00
        ```

        **Current Output:**

        ``` console
        >>> pytest.approx(42, abs=1)
        42 ± 1
        ```

    \-- by `fazeelghafoor`{.interpreted-text role="user"}

• #​7683: The formerly optional pygments dependency is now required, causing output always to be source-highlighted (unless disabled via the --code-highlight=no CLI option).

Bug fixes

• #​10404: Apply filterwarnings from config/cli as soon as possible, and revert them as late as possible
  so that warnings as errors are collected throughout the pytest run and before the
  unraisable and threadexcept hooks are removed.

  This allows very late warnings and unraisable/threadexcept exceptions to fail the test suite.

  This also changes the warning that the lsof plugin issues from PytestWarning to the new warning PytestFDWarning so it can be more easily filtered.

• #​11067: The test report is now consistent regardless if the test xfailed via pytest.mark.xfail <pytest.mark.xfail ref>{.interpreted-text role="ref"} or pytest.fail{.interpreted-text role="func"}.

  Previously, xfailed tests via the marker would have the string "reason: " prefixed to the message, while those xfailed via the function did not. The prefix has been removed.

• #​12008: In 11220{.interpreted-text role="pr"}, an unintended change in reordering was introduced by changing the way indices were assigned to direct params. More specifically, before that change, the indices of direct params to metafunc's callspecs were assigned after all parametrizations took place. Now, that change is reverted.

• #​12863: Fix applying markers, including pytest.mark.parametrize <pytest.mark.parametrize ref>{.interpreted-text role="ref"} when placed above [@​staticmethod]{.title-ref} or [@​classmethod]{.title-ref}.

• #​12929: Handle StopIteration from test cases, setup and teardown correctly.

• #​12938: Fixed --durations-min argument not respected if -vv is used.

• #​12946: Fixed missing help for pdb{.interpreted-text role="mod"} commands wrapped by pytest -- by adamchainz{.interpreted-text role="user"}.

• #​12981: Prevent exceptions in pytest.Config.add_cleanup{.interpreted-text role="func"} callbacks preventing further cleanups.

• #​13047: Restore pytest.approx{.interpreted-text role="func"} handling of equality checks between [bool]{.title-ref} and [numpy.bool_]{.title-ref} types.

  Comparing [bool]{.title-ref} and [numpy.bool_]{.title-ref} using pytest.approx{.interpreted-text role="func"} accidentally changed in version [8.3.4]{.title-ref} and [8.3.5]{.title-ref} to no longer match:

  >>> import numpy as np
  >>> from pytest import approx
  >>> [np.True_, np.True_] == pytest.approx([True, True])
  False

  This has now been fixed:

  >>> [np.True_, np.True_] == pytest.approx([True, True])
  True

• #​13119: Improved handling of invalid regex patterns for filter warnings by providing a clear error message.

• #​13175: The diff is now also highlighted correctly when comparing two strings.

• #​13248: Fixed an issue where passing a scope in Metafunc.parametrize <pytest.Metafunc.parametrize>{.interpreted-text role="py:func"} with indirect=True
  could result in other fixtures being unable to depend on the parametrized fixture.

• #​13291: Fixed repr of attrs objects in assertion failure messages when using attrs>=25.2.

• #​13312: Fixed a possible KeyError crash on PyPy during collection of tests involving higher-scoped parameters.

• #​13345: Fix type hints for pytest.TestReport.when{.interpreted-text role="attr"} and pytest.TestReport.location{.interpreted-text role="attr"}.

• #​13377: Fixed handling of test methods with positional-only parameter syntax.

  Now, methods are supported that formally define self as positional-only
  and/or fixture parameters as keyword-only, e.g.:

  class TestClass:
  
      def test_method(self, /, *, fixture): ...

  Before, this caused an internal error in pytest.

• #​13384: Fixed an issue where pytest could report negative durations.

• #​13420: Added lru_cache to nodes._check_initialpaths_for_relpath.

• #​9037: Honor disable_test_id_escaping_and_forfeit_all_rights_to_community_support{.interpreted-text role="confval"} when escaping ids in parametrized tests.

Improved documentation

• #​12535: [This
  example]{.title-ref}<https://docs.pytest.org/en/latest/example/simple.html#making-test-result-information-available-in-fixtures>
  showed print statements that do not exactly reflect what the
  different branches actually do. The fix makes the example more precise.

• #​13218: Pointed out in the pytest.approx{.interpreted-text role="func"} documentation that it considers booleans unequal to numeric zero or one.

• #​13221: Improved grouping of CLI options in the --help output.

• #​6649: Added ~pytest.TerminalReporter{.interpreted-text role="class"} to the api-reference{.interpreted-text role="ref"} documentation page.

• #​8612: Add a recipe for handling abstract test classes in the documentation.

  A new example has been added to the documentation to demonstrate how to use a mixin class to handle abstract
  test classes without manually setting the __test__ attribute for subclasses.
  This ensures that subclasses of abstract test classes are automatically collected by pytest.

Packaging updates and notes for downstreams

• #​13317: Specified minimum allowed versions of colorama, iniconfig,
  and packaging; and bumped the minimum allowed version
  of exceptiongroup for python_version<'3.11' from a release
  candidate to a full release.

Contributor-facing changes

• #​12017: Mixed internal improvements:

  • Migrate formatting to f-strings in some tests.
  • Use type-safe constructs in JUnitXML tests.
  • MovedMockTiming into _pytest.timing.

  -- by RonnyPfannschmidt{.interpreted-text role="user"}

• #​12647: Fixed running the test suite with the hypothesis pytest plugin.

Miscellaneous internal changes

• #​6649: Added ~pytest.TerminalReporter{.interpreted-text role="class"} to the public pytest API, as it is part of the signature of the pytest_terminal_summary{.interpreted-text role="hook"} hook.

v3.13.3: 3.13.3

Compare Source

Python 3.13.3

v3.13.2: 3.13.2

Compare Source

Python 3.13.2

v3.13.1: 3.13.1

Compare Source

Python 3.13.1

v3.13.0: 3.13.0

Compare Source

Python 3.13.0

v3.12.10: 3.12.10

Compare Source

Python 3.12.10

v3.12.9: 3.12.9

Compare Source

Python 3.12.9

v3.12.8: 3.12.8

Compare Source

Python 3.12.8

v3.12.7: 3.12.7

Compare Source

Python 3.12.7

v3.12.6: 3.12.6

Compare Source

Python 3.12.6

v3.12.5: 3.12.5

Compare Source

Python 3.12.5

v3.12.4: 3.12.4

Compare Source

Python 3.12.4

v3.12.3: 3.12.3

Compare Source

Python 3.12.3

v3.12.2: 3.12.2

Compare Source

Python 3.12.2

v3.12.1: 3.12.1

Compare Source

Python 3.12.1

v3.12.0: 3.12.0

Compare Source

Python 3.12.0

v3.11.12: 3.11.12

Compare Source

Python 3.11.12

v3.11.11: 3.11.11

Compare Source

Python 3.11.11

v3.11.10: 3.11.10

Compare Source

Python 3.11.10

v3.11.9: 3.11.9

Compare Source

Python 3.11.9

v3.11.8: 3.11.8

Compare Source

Python 3.11.8

v3.11.7: 3.11.7

Compare Source

Python 3.11.7

v3.11.6: 3.11.6

Compare Source

Python 3.11.6

v3.11.5: 3.11.5

Compare Source

Python 3.11.5

v3.11.4: 3.11.4

Compare Source

Python 3.11.4

v3.11.3: 3.11.3

Compare Source

Python 3.11.3

v3.11.2: 3.11.2

Compare Source

Python 3.11.2

v3.11.1: 3.11.1

Compare Source

Python 3.11.1

v3.11.0: 3.11.0

Compare Source

Python 3.11.0