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)

v3.30.0

Compare Source

Features

• Add roundingmode enum, wiring, and tests (#​2121) (3a48948)
• Adds foreign_type_info attribute to table class and adds unit tests. (#​2126) (2c19681)
• Support resource_tags for table (#​2093) (d4070ca)

Bug Fixes

• Avoid blocking in download thread when using BQ Storage API (#​2034) (54c8d07)
• Retry 404 errors in Client.query(...) (#​2135) (c6d5f8a)

Dependencies

• Updates required checks list in github (#​2136) (fea49ff)
• Use pandas-gbq to determine schema in load_table_from_dataframe (#​2095) (7603bd7)

Documentation

• Update magics.rst (#​2125) (b5bcfb3)

v3.29.0

Compare Source

Features

• Add ExternalCatalogTableOptions class and tests (#​2116) (cdc1a6e)

Bug Fixes

• Add default value in SchemaField.from_api_repr() (#​2115) (7de6822)

v3.28.0

Compare Source

Features

• Add property for allowNonIncrementalDefinition for materialized view (#​2084) (3359ef3)
• Add property for maxStaleness in table definitions (#​2087) (729322c)
• Add type hints to Client (#​2044) (40529de)
• Adds ExternalCatalogDatasetOptions and tests (#​2111) (b929a90)
• Adds ForeignTypeInfo class and tests (#​2110) (55ca63c)
• Adds new input validation function similar to isinstance. (#​2107) (a2bebb9)
• Adds StorageDescriptor and tests (#​2109) (6be0272)
• Adds the SerDeInfo class and tests (#​2108) (62960f2)
• Migrate to pyproject.toml (#​2041) (1061611)
• Preserve unknown fields from the REST API representation in SchemaField (#​2097) (aaf1eb8)
• Resource tags in dataset (#​2090) (3e13016)
• Support setting max_stream_count when fetching query result (#​2051) (d461297)

Bug Fixes

• Allow geopandas 1.x (#​2065) (f2ab8cb)

Documentation

• Render fields correctly for update calls (#​2055) (a4d9534)

v3.27.0

Compare Source

Features

• Updates to allow users to set max_stream_count (#​2039) (7372ad6)

v3.26.0

Compare Source

Features

• Include LegacyPandasError in init imports (#​2014) (3ab5e95)
• Use bigquery-magics package for the %%bigquery magic (#​1965) (60128a5)

Bug Fixes

• Add docfx to the presubmit configuration and delete docs-presubmit (#​1995) (bd83cfd)
• Add warning when encountering unknown field types (#​1989) (8f5a41d)
• Allow protobuf 5.x; require protobuf >=3.20.2; proto-plus >=1.22.3 (#​1976) (57bf873)
• Do not set job timeout extra property if None (#​1987) (edcb79c)
• Set pyarrow field nullable to False for a BigQuery field in REPEATED mode (#​1999) (5352870)

Dependencies

• Bump min version of google-api-core and google-cloud-core to 2.x (#​1972) (a958732)

Documentation

• Add short mode query sample & test (#​1978) (ba61a8a)
• Improve QueryJobConfig.destination docstring (#​2016) (1b4cca0)

v3.12.1

Compare Source

Bug Fixes

• Make logging handler close conditional to having the transport opened (#​990) (66c6b91)

v3.12.0

Compare Source

Features

• Add REST Interceptors which support reading metadata (681bcc5)
• Add support for opt-in debug logging (681bcc5)
• Added flushes/close functionality to logging handlers (#​917) (d179304)

Bug Fixes

• Allow protobuf 6.x (#​977) (6757890)
• deps: Require google-cloud-audit-log >= 0.3.1 (#​979) (1cc00ec)
• Fix typing issue with gRPC metadata when key ends in -bin (681bcc5)

Documentation

• Added documentation on log_level and excluded_loggers params in setup_logging (#​971) (70d9d25)
• Update README to break infinite redirect loop (#​972) (52cd907)

v3.11.4

Compare Source

Bug Fixes

• Made write_entries raise ValueError on ParseErrors (#​958) (5309478)
• Require proto-plus >= 1.25 for Python 3.13 (#​955) (7baed8e)
• Require proto-plus >= 1.25 for Python 3.13 (#​955) (002b1fc)

v3.11.3

Compare Source

Bug Fixes

• 16-bit hexadecimal formatting for XCTC span IDs (#​946) (1f2b190)

v3.11.2

Compare Source

Bug Fixes

• deps: Require google-cloud-appengine-logging>=0.1.3 (550abca)
• deps: Require google-cloud-audit-log >= 0.2.4 (550abca)
• deps: Require opentelemetry-api>=1.9.0 (550abca)
• Fixed type hinting issue with specifying Transport class (#​930) (e2875d6)

v3.11.1

Compare Source

Bug Fixes

• Allow protobuf 5.x (#​888) (7746e64)

v3.11.0

Compare Source

Features

• OpenTelemetry trace/spanID integration for Python handlers (#​889) (78168a3)

Bug Fixes

• Added environment specific labels to client library when running in Cloud Run Jobs (#​877) (9c5e8f0)
• Added missing import into logger.py (#​896) (9ca242d)
• Added type hints to CloudLoggingHandler constructor (#​903) (6959345)

Documentation

• Add summary_overview template (#​878) (b60714c)
• Changed table in web-framework-integration to bulleted list (#​875) (a4aa3a7)
• Documentation update for OpenTelemetry (#​915) (2a0539a)
• Update dictConfig snippet (#​885) (6264107)

v2.29.1

Compare Source

Bug Fixes

• Remove setup.cfg configuration for creating universal wheels (#​1376) (60639c4)

Documentation

• sample: Add samples for topic and subscription SMTs (#​1386) (4d072e0)
• Update documentation for JavaScriptUDF to indicate that the message_id metadata field is optional instead of required (#​1380) (be90054)
• Update readme links (#​1409) (77ba05d)

v2.29.0

Compare Source

Features

• Add REST Interceptors which support reading metadata (4363179)
• Add support for opt-in debug logging (4363179)
• Deprecate enabled field for message transforms and add disabled field (4363179)

Bug Fixes

• Allow logs to propagate upstream for caplog testing (#​1374) (fa39b0e)
• Allow Protobuf 6.x (#​1369) (c95b7a5)
• Fix typing issue with gRPC metadata when key ends in -bin (4363179)

Documentation

• A comment for field code in message .google.pubsub.v1.JavaScriptUDF is changed (4363179)
• Add samples and test for ingestion from Kafka sources (#​1354) (820f986)
• Deprecate enabled field for message transforms and add disabled field (4363179)
• samples: Increase example max_bytes setting for cloud storage subscriptions to encourage more performant subscribe (#​1324) (cb760a7)

v2.28.0

Compare Source

Features

• Add support for message transforms to Topic and Subscription (#​1274) (e5e2f3f)

Bug Fixes

• Get channel target for a gRPC request (#​1339) (16ea766)
• Set creds only if transport not provided (#​1348) (59965a4)

v2.27.3

Compare Source

Bug Fixes

• Stop using api_core default timeouts in publish since they are broken (#​1326) (ba2c2ee)

v2.27.2

Compare Source

Bug Fixes

• Handle TransportError Exceptions thrown from gapic_publish (#​1318) (0e058c7)

v2.27.1

Compare Source

Bug Fixes

• Add support for Python3.13 (#​1302) (ab22e27)

v2.27.0

Compare Source

Features

• Add support for Python 3.13 (#​1281) (0b46a33)

Bug Fixes

• Mark test_streaming_pull_max_messages flaky (#​1288) (d6635a0)

v2.26.1

Compare Source

Documentation

• Add ingestion from GCS sample (#​1273) (b59cc8d)

v2.26.0

Compare Source

Features

• Add ingestion Cloud Storage fields and Platform Logging fields to Topic (#​1248) (a7a4caa)

v2.25.2

Compare Source

Documentation

• Add command line args for OpenTelemetry Subscribe sample (#​1265) (0ff7f2a)

v2.25.1

Compare Source

Bug Fixes

• Update the requirements.txt for samples directory (#​1263) (5cce8b1)

v2.25.0

Compare Source

Features

• Add OpenTelemetry publish sample (#​1258) (bc13ff0)

v2.23.1

Compare Source

Bug Fixes

• Replace asserts with None checks for graceful shutdown (#​1244) (ced4f52)

v2.23.0

Compare Source

Features

• Add max messages batching for Cloud Storage subscriptions (#​1224) (91c89d3)

v3.1.0

Compare Source

Features

• Add api_key argument to Client constructor (#​1441) (c869e15)
• Add Bucket.move_blob() for HNS-enabled buckets (#​1431) (24c000f)

v3.0.0

Compare Source

⚠ BREAKING CHANGES

Please consult the README for details on this major version release.

• The default checksum strategy for uploads has changed from None to "auto" (#​1383)
• The default checksum strategy for downloads has changed from "md5" to "auto" (#​1383)
• Deprecated positional argument "num_retries" has been removed (#​1377)
• Deprecated argument "text_mode" has been removed (#​1379)
• Blob.download_to_filename() now deletes the empty destination file on a 404 (#​1394)
• Media operations now use the same retry backoff, timeout and custom predicate system as non-media operations, which may slightly impact default retry behavior (#​1385)
• Retries are now enabled by default for uploads, blob deletes and blob metadata updates (#​1400)

Features

• Add "auto" checksum option and make default (#​1383) (5375fa0)
• Blob.download_to_filename() deletes the empty destination file on a 404 (#​1394) (066be2d)
• Enable custom predicates for media operations (#​1385) (f3517bf)
• Integrate google-resumable-media (#​1283) (bd917b4)
• Retry by default for uploads, blob deletes, metadata updates (#​1400) (0426005)

Bug Fixes

• Cancel upload when BlobWriter exits with exception (#​1243) (df107d2)
• Changed name of methods Blob.from_string() and Bucket.from_string() to from_uri() (#​1335) (58c1d03)
• Correctly calculate starting offset for retries of ranged reads (#​1376) (7b6c9a0)
• Filter download_kwargs in BlobReader (#​1411) (0c21210)
• Remove deprecated num_retries argument (#​1377) (58b5040)
• Remove deprecated text_mode argument (#​1379) (4d20a8e)

Documentation

• Correct formatting and update README.rst (#​1427) (2945853)
• Fix issue with exceptions.py documentation (#​1328) (22b8c30)

v2.19.0

Compare Source

Features

• Add integration test for universe domain (#​1346) (02a972d)
• Add restore_bucket and handling for soft-deleted buckets (#​1365) (ab94efd)
• Add support for restore token (#​1369) (06ed15b)
• IAM signBlob retry and universe domain support (#​1380) (abc8061)

Bug Fixes

• Allow signed post policy v4 with service account and token (#​1356) (8ec02c0)
• Do not spam the log with checksum related INFO messages when downloading using transfer_manager (#​1357) (42392ef)

v2.18.2

Compare Source

Bug Fixes

• Add regression test for range read retry issue and bump dependency to fix (#​1338) (0323647)

v2.18.1

Compare Source

Bug Fixes

• Properly escape URL construction for XML MPU API, fixing a path traversal issue that allowed uploads to unintended buckets. Reported by @​jdomeracki. (#​1333) (bf4d0e0)

v2.18.0

Compare Source

Features

• Add OpenTelemetry Tracing support as a preview feature (#​1288) (c2ab0e0)

Bug Fixes

• Allow Protobuf 5.x (#​1317) (152b249)
• Correct notification error message (#​1290) (1cb977d), closes #​1289

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