3.1.1 (2025-06-13)

Bug Fixes

• Add a check for partial response data (#1487) (7e0412a)
• Add trove classifier for Python 3.13 (0100916)
• deps: Require google-crc32c >= 1.1.3 (0100916)
• deps: Require protobuf >= 3.20.2, < 7.0.0 (0100916)
• deps: Require requests >= 2.22.0 (0100916)
• Remove setup.cfg configuration for creating universal wheels (#1448) (d3b6b3f)
• Resolve issue where pre-release versions of dependencies are installed (0100916)
• Segmentation fault in tink while writing data (#1490) (2a46c0b)

Documentation

• Move quickstart to top of readme (#1451) (53257cf)
• Update README to break infinite redirect loop (#1450) (03f1594)

3.1.0 (2025-02-27)

Features

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

3.0.0 (2025-01-28)

⚠ 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)

3.0.0rc1 (2024-12-12)

⚠ BREAKING CHANGES

• The default checksum strategy for uploads has changed from None to "auto" (#1383) (5375fa0)
• The default checksum strategy for downloads has changed from "md5" to "auto" (#1383) (5375fa0)
• Deprecated positional argument "num_retries" has been removed (#1377) (58b5040)
• Deprecated argument "text_mode" has been removed (#1379) (4d20a8e)
• Media operation retries now work identically to other retries, which may impact default retry settings (#1385) (f3517bf)
• Blob.download_to_filename() deletes the empty destination file on a 404

Features

• Add "auto" checksum option and make default (#1383) (5375fa0)
• Blob.download_to_filename() deletes the empty destination file on a 404 (066be2d)
• Deprecated argument "text_mode" has been removed (#1379) (4d20a8e) (4e9a382)
• Deprecated positional argument "num_retries" has been removed (#1377) (58b5040) (4e9a382)
• Enable custom predicates for media operations (#1385) (f3517bf)
• Integrate google-resumable-media (#1283) (bd917b4)
• Media operation retries now work identically to other retries, which may impact default retry settings (#1385) (f3517bf) (4e9a382)
• The default checksum strategy for downloads has changed from "md5" to "auto" (#1383) (5375fa0) (4e9a382)
• The default checksum strategy for uploads has changed from None to "auto" (#1383) (5375fa0) (4e9a382)

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)
• Remove deprecated num_retries argument (#1377) (58b5040)
• Remove deprecated text_mode argument (#1379) (4d20a8e)

Documentation

• Fix issue with exceptions.py documentation (#1328) (22b8c30)

2.19.0 (2024-11-21)

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)

2.18.2 (2024-08-08)

Bug Fixes

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

2.18.1 (2024-08-05)

Bug Fixes

• Properly escape URL construction for XML MPU API (#1333) (bf4d0e0)

2.18.0 (2024-07-09)

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

2.17.0 (2024-05-22)

Features

• Support HNS enablement in bucket metadata (#1278) (add3c01)
• Support page_size in bucket.list_blobs (#1275) (c52e882)

Bug Fixes

• Remove deprecated methods in samples and tests (#1274) (4db96c9)

Documentation

• Reference Storage Control in readme (#1254) (3d6d369)
• Update DEFAULT_RETRY_IF_GENERATION_SPECIFIED docstrings (#1234) (bdd426a)

2.16.0 (2024-03-18)

Features

• Add support for soft delete (#1229) (3928aa0)
• Support includeFoldersAsPrefixes (#1223) (7bb8065)