Changelog

PyPI History

3.3.0 (2025-08-05)

Features

Add support for bucket IP filter ( #1516 ) ( a29073c )

Bug Fixes

Add logs on AssertionError for issue #1512 ( #1518 ) ( 6a9923e )

Documentation

Update the documentation of move_blob function ( #1507 ) ( 72252e9 )

3.2.0 (2025-07-04)

Features

Adding support of single shot download ( #1493 ) ( 61c5d5f )

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 )

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, fixing a path traversal issue that allowed uploads to unintended buckets. Reported by @jdomeracki. ( #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 )

2.15.0 (2024-02-28)

Features

Support custom universe domains/TPC ( #1212 ) ( f4cf041 )

Bug Fixes

Add “updated” as property for Bucket ( #1220 ) ( ae9a53b )
Remove utcnow usage ( #1215 ) ( 8d8a53a )

2.14.0 (2023-12-10)

Features

Add support for Python 3.12 ( #1187 ) ( ecf4150 )
Support object retention lock ( #1188 ) ( a179337 )

Bug Fixes

Clarify error message and docstrings in Blob class method ( #1196 ) ( 92c20d3 )
Propagate timeout in BlobWriter ( #1186 ) ( 22f36da ), closes #1184
Use native namespace to avoid pkg_resources warnings ( #1176 ) ( 2ed915e )

2.13.0 (2023-10-31)

Features

Add Autoclass v2.1 support ( #1117 ) ( d38adb6 )
Add support for custom headers ( #1121 ) ( 2f92c3a )

Bug Fixes

Blob.from_string parse storage uri with regex ( #1170 ) ( 0a243fa )
Bucket.delete(force=True) now works with version-enabled buckets ( #1172 ) ( 0de09d3 )
Fix typo in Bucket.clear_lifecycle_rules() ( #1169 ) ( eae9ebe )

Documentation

Fix exception field in tm reference docs ( #1164 ) ( eac91cb )

2.12.0 (2023-10-12)

Features

Add additional_blob_attributes to upload_many_from_filenames ( #1162 ) ( c7229f2 )
Add crc32c_checksum argument to download_chunks_concurrently ( #1138 ) ( fc92ad1 )
Add skip_if_exists to download_many ( #1161 ) ( c5a983d )
Launch transfer manager to GA ( #1159 ) ( 5c90563 )

Bug Fixes

Bump python-auth version to fix issue and remove workaround ( #1158 ) ( 28c02dd )
Mark _deprecate_threads_param as a wrapper to unblock introspection and docs ( #1122 ) ( 69bd4a9 )

Documentation

Add snippets for upload_chunks_concurrently and add chunk_size ( #1135 ) ( 3a0f551 )
Update formatting and wording in transfer_manager docstrings ( #1163 ) ( 9e460d8 )

2.11.0 (2023-09-19)

Features

Add gccl-gcs-cmd field to X-Goog-API-Client header for Transfer Manager calls ( #1119 ) ( 14a1909 )
Add transfer_manager.upload_chunks_concurrently using the XML MPU API ( #1115 ) ( 56aeb87 )
Support configurable retries in upload_chunks_concurrently ( #1120 ) ( 1271686 )

Bug Fixes

Split retention period tests due to caching change ( #1068 ) ( cc191b0 )

Documentation

Add Transfer Manager documentation in c.g.c ( #1109 ) ( c1f8724 )

2.10.0 (2023-06-14)

Features

Add matchGlob parameter to list_blobs ( #1055 ) ( d02098e )
Allow exceptions to be included in batch responses ( #1043 ) ( 94a35ba )

Bug Fixes

Extend wait for bucket metadata consistency in system tests ( #1053 ) ( d78586c )

Documentation

Add clarification to batch module ( #1045 ) ( 11f6024 )

2.9.0 (2023-05-04)

Features

Un-deprecate blob.download_to_file(), bucket.create(), and bucket.list_blobs() ( #1013 ) ( aa4f282 )

Bug Fixes

Avoid pickling processed credentials ( #1016 ) ( 7935824 )
Improve test error message for missing credentials ( #1024 ) ( 892481a )

Documentation

Add sample and sample test for transfer manager ( #1027 ) ( 4698799 )
Remove threads in transfer manager samples ( #1029 ) ( 30c5146 )

2.8.0 (2023-03-29)

Features

Add multiprocessing and chunked downloading to transfer manager ( #1002 ) ( e65316b )

Bug Fixes

Add trove classifier for python 3.11 ( #971 ) ( 7886376 )
Remove use of deprecated cgi module ( #1006 ) ( 3071832 )

Documentation

Add clarifications to read timeout ( #873 ) ( 8fb26f4 )
Fix c.g.c structure ( #982 ) ( d5a2931 )
Update c.g.c docs and guides ( #994 ) ( 62b4a50 )

2.7.0 (2022-12-07)

Features

Add “transfer_manager” module for concurrent uploads and downloads, as a preview feature ( #943 ) ( 9998a5e )
Add use_auth_w_custom_endpoint support ( #941 ) ( 5291c08 )

Bug Fixes

Implement closed property on fileio.py classes ( #907 ) ( 64406ca )

2.6.0 (2022-11-07)

Features

Add Autoclass support and samples ( #791 ) ( 9ccdc5f ), closes #797
Add predefined_acl to create_resumable_upload_session ( #878 ) ( 2b3e8f9 )
Enable delete_blobs() to preserve generation ( #840 ) ( 8fd4c37 ), closes #814
Make tests run against environments other than prod ( #883 ) ( 7dfeb62 )

Bug Fixes

Align bucket bound hostname url builder consistency ( #875 ) ( 8a24add )
BlobWriter.close() will do nothing if already closed ( #887 ) ( 7707220 )
Remove client side validations ( #868 ) ( 928ebbc )

Documentation

Update comments in list_blobs sample ( #866 ) ( 9469f5d )
Clarify prefixes entity in list_blobs usage ( #837 ) ( 7101f47 )
Streamline docs for migration ( #876 ) ( 7c8a178 )
Update docstring for lifecycle_rules to match generator behavior ( #841 ) ( 36fb81b )

2.5.0 (2022-07-24)

Features

Custom Placement Config Dual Region Support ( #819 ) ( febece7 )

Documentation

open file-like objects in byte mode for uploads ( #824 ) ( 4bd3d1d )

2.4.0 (2022-06-07)

Features

add AbortIncompleteMultipartUpload lifecycle rule ( #765 ) ( b2e5150 )
support OLM Prefix/Suffix ( #773 ) ( 187cf50 )

Bug Fixes

fix rewrite object in CMEK enabled bucket ( #807 ) ( 9b3cbf3 )

Documentation

fix changelog header to consistent size ( #802 ) ( 4dd0907 )
samples:Update the Recovery Point Objective (RPO) sample output ( #725 ) ( b0bf411 )
Update generation_metageneration.rst with a missing space ( #798 ) ( 1e7cdb6 )
update retry docs ( #808 ) ( c365d5b )

2.3.0 (2022-04-12)

Features

add dual region bucket support and sample ( #748 ) ( 752e8ab )
track invocation id for retry metrics ( #741 ) ( bd56931 )

Bug Fixes

deps:drop pkg_resources ( #744 ) ( e963f33 )

Documentation

fix links in blob module ( #759 ) ( 9b29314 )

2.2.1 (2022-03-15)

Bug Fixes

remove py.typed marker file for PEP 561 ( #735 ) ( f77d2f7 ), closes #734

2.2.0 (2022-03-14)

Features

allow no project in client methods using storage emulator ( #703 ) ( bcde0ec )

Bug Fixes

add user agent in python-storage when calling resumable media ( c7bf615 )
deps:require google-api-core>=1.31.5, >=2.3.2 ( #722 ) ( e9aab38 )
Fix BlobReader handling of interleaved reads and seeks ( #721 ) ( 5d1cfd2 )
retry client side requests timeout ( #727 ) ( e0b3b35 )

Documentation

fixed download_blob_to_file example ( #704 ) ( 2c94d98 )

2.1.0 (2022-01-19)

Features

add turbo replication support and samples ( #622 ) ( 4dafc81 )
avoid authentication with storage emulator ( #679 ) ( 8789afa )
remove python 3.6 support ( #689 ) ( 8aa4130 )

2.0.0 (2022-01-12)

⚠ BREAKING CHANGES

Remove Python 2 support (#657)

Features

Remove Python 2 support ( #657 ) ( b611670 )

1.44.0 (2022-01-05)

Features

add raw_download kwarg to BlobReader ( #668 ) ( 10cdad6 )

Documentation

Describe code sample more specifically ( #660 ) ( 0459cb4 )
refresh readme instructions ( #667 ) ( ceb9314 )
This is just a simple PR to better describe what the code is doing in the comments. ( 0459cb4 )
use writeable streamin example for ‘download_blob_to_file’ ( #676 ) ( 96092d4 )

1.43.0 (2021-11-15)

Features

add ignore_flush parameter to BlobWriter ( #644 ) ( af9c9dc )
add support for Python 3.10 ( #615 ) ( f81a2d0 )

Bug Fixes

raise a ValueError in BucketNotification.create() if a topic name is not set ( #617 ) ( 9dd78df )

Documentation

add contributing and authoring guides under samples/ ( #633 ) ( 420591a )
add links to samples and how to guides ( #641 ) ( 49f78b0 )
add README to samples subdirectory ( #639 ) ( 58af882 )
update samples readme with cli args ( #651 ) ( 75dda81 )

1.42.3 (2021-09-30)

Bug Fixes

changeover unspecified to inherited ( #603 ) ( 283a419 )
check response code in batch.finish ( #609 ) ( 318a286 )
skip tests that use unspecified pap until we get the change in ( #600 ) ( 38b9b55 )

1.42.2 (2021-09-16)

Bug Fixes

add preconditions and retry config support to ACL patch operationss ( #586 ) ( 4333caf )
add unpinned protobuf for python3 ( #592 ) ( 53f7ad0 )
pin six as a required dependency ( #589 ) ( 9ca97bf )

1.42.1 (2021-09-07)

Bug Fixes

do not append duplicates to user agent string ( #570 ) ( 57cf3a1 )

Documentation

pass explicit ‘client’ in ‘{Blob.Bucket}.from_string’ examples ( #545 ) ( 6eff22d )

1.42.0 (2021-08-05)

Features

add ‘page_size’ parameter to ‘Bucket.list_blobs, list_buckets ( #520 ) ( c5f4ad8 )

Bug Fixes

deps:add explicit ranges for ‘google-api-core’ and ‘google-auth’ ( #530 ) ( 310f207 )
downloading no longer marks metadata fields as ‘changed’ ( #523 ) ( 160d1ec )
make ‘requests.exceptions.ChunkedEncodingError retryable by default ( #526 ) ( 4abb403 )

Documentation

update supported / removed Python versions in README ( #519 ) ( 1f1b138 )

1.41.1 (2021-07-20)

Bug Fixes

deps:pin {api,cloud}-core , auth to allow 2.x versions on Python 3 ( #512 ) ( 4d7500e )
remove trailing commas from error message constants ( #505 ) ( d4a86ce ), closes #501

Documentation

replace usage of deprecated function download_as_string in docs ( #508 ) ( 8dfa4d4 )

1.41.0 (2021-07-13)

Features

add support for Etag headers on reads ( #489 ) ( 741d3fd )

Bug Fixes

deps:update minimum dependency versions to pick up bugfixes ( #496 ) ( 92251a5 ), closes #494
populate etag / generation / metageneration properties during download ( #488 ) ( 49ba14c )
revise and rename is_etag_in_json(data) ( #483 ) ( 0a52546 )

1.40.0 (2021-06-30)

Features

add preconditions and retry configuration to blob.create_resumable_upload_session ( #484 ) ( 0ae35ee )
add public access prevention to bucket IAM configuration ( #304 ) ( e3e57a9 )

Bug Fixes

replace default retry for upload operations ( #480 ) ( c027ccf )

1.39.0 (2021-06-21)

Features

media operation retries can be configured using the same interface as with non-media operation ( #447 ) ( 0dbbb8a )

Bug Fixes

add ConnectionError to default retry ( #445 ) ( 8344253 )
apply idempotency policies for ACLs ( #458 ) ( 2232f38 )
replace python lifecycle action parsing ValueError with warning ( #437 ) ( 2532d50 )
revise blob.compose query parameters if_generation_match ( #454 ) ( 70d19e7 )

Documentation

streamline ‘timeout’ / ‘retry’ docs in docstrings ( #461 ) ( 78b2eba )
streamline docstrings for conditional parmas ( #464 ) ( 6999370 )

1.38.0 (2021-04-26)

Features

add getters and setters for encryption_key and kms_key_name ( #409 ) ( 2adfb59 )

Bug Fixes

retry auth.TransportError errors ( #418 ) ( 23a8db8 )

Documentation

revise docstrings for generate_signed_url ( #408 ) ( f090548 )

1.37.1 (2021-04-02)

Bug Fixes

Ensure consistency check in test runs even if expected error occurs ( #402 ) ( 416bcd4 )
silence expected errors for routine operations on BlobReader ( #400 ) ( d52853b )

1.37.0 (2021-03-24)

Features

add blob.open() for file-like I/O ( #385 ) ( 440a0a4 ), closes #29

Bug Fixes

update user_project usage and documentation in bucket/client class methods ( #396 ) ( 1a2734b )

1.36.2 (2021-03-09)

Bug Fixes

update batch connection to request api endpoint info from client ( #392 ) ( 91fc6d9 )

1.36.1 (2021-02-19)

Bug Fixes

allow metadata keys to be cleared ( #383 ) ( 79d27da ), closes #381
allow signed url version v4 without signed credentials ( #356 ) ( 3e69bf9 )
correctly encode bytes for V2 signature ( #382 ) ( f44212b )

1.36.0 (2021-02-10)

Features

add mtls support ( #367 ) ( d35ab35 )

Bug Fixes

correctly decode times without microseconds ( #375 ) ( 37a1eb5 ), closes #363
expose num_retries parameter for blob upload methods ( #353 ) ( fdabd6a ), closes #352
pass the unused parameter ( #349 ) ( 5c60d24 )
set custom_time on uploads ( #374 ) ( f048be1 ), closes #372

1.35.1 (2021-01-28)

Bug Fixes

address incorrect usage of request preconditions ( #366 ) ( 321658c )
Amend default retry behavior for bucket operations on client ( #358 ) ( b91e57d )

1.35.0 (2020-12-14)

Features

support ConnectionError retries for media operations ( #342 ) ( e55b25b )

1.34.0 (2020-12-11)

Features

make retry parameter public and added in other methods ( #331 ) ( 910e34c )

Bug Fixes

avoid triggering global logging config ( #333 ) ( 602108a ), closes #332
fall back to ‘charset’ of ‘content_type’ in ‘download_as_text’ ( #326 ) ( 63ff233 ), closes #319
fix conditional retry handling of camelCase query params ( #340 ) ( 4ff6141 )
retry uploads only conditionally ( #316 ) ( 547740c )
update ‘custom_time’ setter to record change ( #323 ) ( 5174154 ), closes #322

1.33.0 (2020-11-16)

Features

add classifiers for python3.9 and remove for python3.5 ( #295 ) ( f072825 )
add testing support for Python 3.9, drop Python 3.5 ( #313 ) ( fa14009 )

Bug Fixes

use passed-in client within Blob.from_string and helpers ( #290 ) ( d457ce3 ), closes #286
preserve metadata value when uploading new file content ( #298 ) ( 5ab6b0d ), closes #293

1.32.0 (2020-10-16)

Features

retry API calls with exponential backoff ( #287 ) ( fbe5d9c )

Bug Fixes

field policy return string ( #282 ) ( c356b84 )
self-upload files for Unicode system test ( #296 ) ( 6f865d9 )
use version.py for versioning, avoid issues with discovering version via get_distribution ( #288 ) ( fcd1c4f )

1.31.2 (2020-09-23)

Documentation

fix docstring example for ‘blob.generate_signed_url’ ( #278 ) ( 2dc91c9 )

1.31.1 (2020-09-16)

Bug Fixes

add requests as a dependency ( #271 ) ( ec52b38 )
preserve existing blob hashes when ‘X-Goog-Hash header’ is not present ( #267 ) ( 277afb8 )
blob:base64 includes additional characters ( #258 ) ( cf0774a )

Documentation

add docs signed_url expiration take default utc ( #250 ) ( 944ab18 )

1.31.0 (2020-08-26)

Features

add configurable checksumming for blob uploads and downloads ( #246 ) ( 23b7d1c )
add support for ‘Blob.custom_time’ and lifecycle rules ( #199 ) ( 180873d )
error message return from api ( #235 ) ( a8de586 )
storage:add support of daysSinceNoncurrentTime and noncurrentTimeBefore ( #162 ) ( 136c097 )
pass ‘client_options’ to base class ctor ( #225 ) ( e1f91fc ), closes #210
rename ‘Blob.download_as_{string,bytes}’, add ‘Blob.download_as_text’ ( #182 ) ( 73107c3 )

Bug Fixes

change datetime.now to utcnow ( #251 ) ( 3465d08 ), closes #228
extract hashes correctly during download ( #238 ) ( 23cfb65 )
repair mal-formed docstring ( #255 ) ( e722376 )

Documentation

update docs build (via synth) ( #222 ) ( 4c5adfa )

1.30.0 (2020-07-24)

Features

add timeouts to Blob methods where missing ( #185 ) ( 6eeb855 )
auto-populate standard headers for non-chunked downloads ( #204 ) ( d8432cd ), closes #24
migrate to Service Account Credentials API ( #189 ) ( e4990d0 )

Bug Fixes

add multiprocessing.rst to synthool excludes ( #186 ) ( 4d76e38 )

Documentation

fix indent in code blocks ( #171 ) ( 62d1543 ), closes #170
remove doubled word in docstring ( #209 ) ( 7a4e7a5 )

Documentation

fix indent in code blocks ( #171 ) ( 62d1543 ), closes #170
remove doubled word in docstring ( #209 ) ( 7a4e7a5 )

Dependencies

prep for grmp-1.0.0 release ( #211 ) ( 55bae9a )

1.29.0 (2020-06-09)

Features

add generation match args into Blob.compose() ( #122 ) ( dc01c59 )
add Bucket.reload() and Bucket.update() wrappers to restrict generation match args ( #153 ) ( 76dd9ac ), closes #127
add helper for bucket bound hostname URLs ( #137 ) ( b26f9fa ), closes #121
add if generation match support for Bucket.rename_blob() ( #141 ) ( f52efc8 )
add if generation Match support, pt1 ( #123 ) ( 0944442 )
add offset and includeTrailingPrefix options to list_blobs ( #125 ) ( d84c0dd )
Create CODEOWNERS ( #135 ) ( 32a8d55 )

Bug Fixes

add documentaion of list_blobs with user project ( #147 ) ( 792b21f )
add projection parameter to blob.reload method ( #146 ) ( ddad20b )
add unused variables to method generation match ( #152 ) ( f6574bb )
change the method names in snippets file ( #161 ) ( e516ed9 )
fix upload object with bucket cmek enabled ( #158 ) ( 5f27ffa )
set default POST policy scheme to “http” ( #172 ) ( 90c020d )

1.28.1 (2020-04-28)

Bug Fixes

anonymous credentials for private bucket ( #107 ) ( 6152ab4 )
add bucket name into POST policy conditions ( #118 ) ( 311ecab )

1.28.0 (2020-04-22)

Features

add arguments for *GenerationMatch uploading options ( #111 ) ( b11aa5f )

Bug Fixes

fix incorrect mtime by UTC offset ( #42 ) ( 76bd652 )
remove expiration strict conversion ( #106 ) ( 9550dad ), closes #105

1.27.0 (2020-04-01)

Features

generate signed URLs for blobs/buckets using virtual hostname ( #58 ) ( 23df542 )
Add cname support for V4 signature ( #72 ) ( cc853af )
add conformance tests for virtual hosted style signed URLs ( #83 ) ( 5adc8b0 )
add get notification method ( #77 ) ( f602252 )
improve v4 signature query parameters encoding ( #48 ) ( 8df0b55 )

Bug Fixes

fix blob metadata to None regression ( #60 ) ( a834d1b )
add classifer for Python 3.8 ( #63 ) ( 1b9b6bc )
make v4 signing formatting consistent w/ spec ( #56 ) ( 8712da8 )
use correct IAM object admin role ( #71 ) ( 2e27edd )
remove docstring of retrun in reload method ( #78 ) ( 4abeb1c )
use OrderedDict while encoding POST policy ( #95 ) ( df560e1 )

1.26.0 (2020-02-12)

Features

add support for signing URLs using token ( #9889 ) ( ad280bf )
add timeout parameter to public methods ( #44 ) ( 63abf07 )

Bug Fixes

fix documentation of max_result parameter in list_blob ( #43 ) ( ff15f19 )
fix system test and change scope for iam access token ( #47 ) ( bc5375f )
remove low version error assertion from iam conditions system tests ( #53 ) ( 8904aee )

1.25.0

01-16-2020 11:00 PST

Implementation Changes

fix: replace unsafe six.PY3 with PY2 for better future compatibility with Python 4 ( #10081 )
fix(storage): fix document of delete blob ( #10015 )

New Features

feat(storage): support optionsRequestedPolicyVersion ( #9989 )

Dependencies

chore(storage): bump core dependency to 1.2.0 ( #10160 )

1.24.1

01-02-2020 13:20 PST

Implementation Changes

Add ‘ARCHIVE’ storage class ( #9533 )

1.24.0

01-02-2020 10:39 PST

Implementation Changes

-str() metadata for for blob ( #9796 )

New Features

Add timeout parameter to Batch interface to match google-cloud-core ( #10010 )

1.23.0

11-12-2019 12:57 PST

Implementation Changes

Move create_bucket implementation from Bucket to Client . ( #8604 )

New Features

Add opt-in raw download support. ( #9572 )

Dependencies

Pin google-resumable-media >= 0.5.0, < 0.6dev . ( #9572 )

Documentation

Add python 2 sunset banner to documentation. ( #9036 )

Internal / Testing Changes

Fix query-string order dependent assert. ( #9728 )
Normalize VPCSC configuration in system tests. ( #9616 )

1.22.0

11-05-2019 10:22 PST

New Features

Add UBLA attrs to IAMConfiguration. ( #9475 )

1.21.0

10-28-2019 21:52 PDT

Implementation Changes

Add gcloud-python header to user agent ( #9551 )
Don’t report a gapic version for storage ( #9549 )
Update storage endpoint from www.googleapis.com to storage.googleapis.com ( #9543 )
Call anonymous client method to remove dependency of google application credentials ( #9455 )
Enable CSEK w/ V4 signed URLs ( #9450 )

New Features

Support predefined ACLs in Bucket.create ( #9334 )

Documentation

Add hmac_key and notification documentation rst files ( #9529 )
Remove references to the old authentication credentials ( #9456 )
Clarify docstring for Blob.download_as_string ( #9332 )

1.20.0

09-26-2019 06:45 PDT

New Features

Add user_project param to HMAC-related methods. ( #9237 )
Add Blob.from_string and Bucket.from_string factories. ( #9143 )

Documentation

Fix intersphinx reference to requests . ( #9294 )
Fix deep / broken URL for service account setup. ( #9164 )

Internal / Testing Changes

Fix typo in _helpers.py . ( #9239 )
In systests, retry bucket creation on 503. ( #9248 )
Avoid using REGIONAL / MULTI_REGIONAL in examples, tests. ( #9205 )
Move benchwrapper into tests/perf . ( #9246 )
Add support for STORAGE_EMULATOR_HOST ; add benchwrapper script. ( #9219 )

1.19.0

08-28-2019 09:45 PDT

Implementation Changes

Expose ‘HMACKeyMetadata.id’ field. ( #9115 )
Make ‘Blob.bucket’ a readonly property. ( #9113 )
Clarify ‘response_type’ for signed_url methods. ( #8942 )

New Features

Add client_options to constructors for manual clients. ( #9054 )

Documentation

Remove compatability badges from READMEs. ( #9035 )

Internal / Testing Changes

Remove CI for gh-pages, use googleapis.dev for api_core refs. ( #9085 )
Fix tests broken by yesterday’s google-resumable-media release. ( #9119 )
Harden ‘test_access_to_public_bucket’ systest against 429 / 503 errors. ( #8997 )

1.18.0

08-07-2019 00:37 PDT

New Features

Add HMAC key support. ( #8430 )

Documentation

Mark old storage classes as legacy, not deprecated. ( #8887 )

Internal / Testing Changes

Normalize ‘lint’ / ‘blacken’ support under nox. ( #8831 )
Update intersphinx mapping for requests. ( #8805 )

1.17.0

07-24-2019 12:37 PDT

New Features

Add Bucket.location_type property. ( #8570 )
Add Client.list_blobs(bucket_or_name) . ( #8375 )

Implementation Changes

Retry bucket creation in signing setup. ( #8620 )
Fix URI -> blob name conversion in Client download_blob_to_file . ( #8440 )
Avoid escaping tilde in blob public / signed URLs. ( #8434 )
Add generation to ‘Blob. repr’. ( #8423 )

Documentation

Link to googleapis.dev documentation in READMEs. ( #8705 )
Add compatibility check badges to READMEs. ( #8288 )
Fix example in Client.download_blob_to_file docstring. ( #8629 )
Remove typing information for kwargs to not conflict with type checkers ( #8546 )

Internal / Testing Changes

Skip failing test_bpo_set_unset_preserves_acls systest. ( #8617 )
Add nox session ‘docs’. ( #8478 )
Add docs job to publish to googleapis.dev. ( #8464 )

1.16.1

06-04-2019 11:09 PDT

Dependencies

Don’t pin google-api-core in libs using google-cloud-core . ( #8213 )

Documentation

Fix example in download_blob_to_file docstring. ( #8201 )
Tweak fields docstring further. ( #8040 )
Improve docs for fields argument to Bucket.list_blobs . ( #8023 )
Fix docs typo. ( #8027 )

Internal / Testing Changes

Retry harder in face of 409/429 during module teardown. ( #8113 )
Add more retries for 429s during teardown operations. ( #8112 )

1.16.0

05-16-2019 12:55 PDT

New Features

Update Client.create_bucket to take a Bucket object or string. ( #7820 )
Update Client.get_bucket to take a Bucket object or string. ( #7856 )
Add Client.download_blob_to_file method. ( #7949 )
Add client_info support to client / connection. ( #7872 )

Dependencies

Pin google-cloud-core >= 1.0.0, < 2.0dev . ( #7993 )
Pin google-auth >= 1.2.0 . ( #7798 )

1.15.0

04-17-2019 15:37 PDT

New Features

Add support for V4 signed URLs ( #7460 )
Add generation arguments to bucket / blob methods. ( #7444 )

Implementation Changes

Remove classifier for Python 3.4 for end-of-life. ( #7535 )
Ensure that ‘Blob.reload’ passes encryption headers. ( #7441 )

Documentation

Update client library documentation URLs. ( #7307 )

Internal / Testing Changes

Fix failing system tests ( #7714 )
Increase number of retries for 429 errors. ( #7484 )
Un-flake KMS integration tests expecting empty bucket. ( #7479 )

1.14.0

02-06-2019 12:49 PST

New Features

Add ‘Bucket.iam_configuration’ property, enabling Bucket-Policy-Only. ( #7066 )

Documentation

Improve docs for ‘generate_signed_url’. ( #7201 )

1.13.2

12-17-2018 17:02 PST

Implementation Changes

Update Blob.update_storage_class to support rewrite tokens. ( #6527 )

Internal / Testing Changes

Skip signing tests for insufficient credentials ( #6917 )
Document Python 2 deprecation ( #6910 )
Normalize docs for page_size / max_results / page_token . ( #6842 )

1.13.1

12-10-2018 13:31 PST

Implementation Changes

Import iam.policy from google.api_core . ( #6741 )
Accomodate new back-end restriction on retention period. ( #6388 )
Avoid deleting a blob renamed to itself ( #6365 )

Dependencies

Update dependency to google-cloud-core ( #6835 )
Bump minimum api_core version for all GAPIC libs to 1.4.1. ( #6391 )

Documentation

Normalize use of support level badges ( #6159 )

Internal / Testing Changes

Blacken libraries ( #6794 )
Add templates for flake8, coveragerc, noxfile, and black. ( #6642 )
Harden teardown in system tests. ( #6444 )
Harden create_bucket call in systests vs. 429 TooManyRequests. ( #6401 )
Skip public bucket test in VPC Service Controls ( #6230 )
Fix lint failure. ( #6219 )
Disable test running in VPC Service Controls restricted environment ( #6215 )
Use new Nox ( #6175 )

1.13.0

New Features

Add support for bucket retention policies ( #5534 )
Allow destination.content_type to be None in Blob.compose . ( #6031 )

Implementation Changes

Ensure that method for Blob.generate_signed_url is uppercase. ( #6110 )

Documentation

Clarify GCS URL signing limitations on GCE ( #6104 )
Redirect renamed ‘usage.html’/’client.html’ -> ‘index.html’. ( #5996 )

1.12.0

New Features

Add support for Python 3.7, drop support for Python 3.4. ( #5942 )
Add lifecycle rules helpers to bucket. ( #5877 )

Implementation Changes

Add ‘stacklevel=2’ to deprecation warnings. ( #5897 )

Documentation

Storage docs: fix typos. ( #5933 )
Prep storage docs for repo split. ( #5923 )

Internal / Testing Changes

Harden systest teardown further. ( #5900 )
Nox: use inplace installs ( #5865 )

1.11.0

Implementation Changes

Preserve message / args from an InvalidResponse . (#5492)
Fix generating signed urls for blobs with non-ascii names. (#5625)
Move bucket location specification to Bucket.create ; deprecate Bucket.location setter (#5808)

New Features

Add Client.get_service_account_email . (#5765)

Documentation

Clarify None values for resource-backed properties. (#5509)
Elaborate docs for {Bucket,Blob}.make_{public,private} ; note how to enable anonymous accesss to Blob.public_url . (#5767)

Internal / Testing Changes

Harden create_bucket systest against 429 responses. (#5535)
Add system test: signed URLs w/ non-ASCII blob name. (#5626)
Harden tearDownModule against 429 TooManyRequests. (#5701)
Retry notification.create() on 503 ServiceUnavailable . (#5741)
Fix failing KMS system tests. (#5832, #5837, #5860)

1.10.0

New Features

Add support for KMS keys (#5259)
Add {Blob,Bucket}make_private method (#5336)

Internal / Testing Changes

Modify system tests to use prerelease versions of grpcio (#5304)

1.9.0

Implementation Changes

Change GCS batch endpoint from /batch to /batch/storage/v1 (#5040)

New Features

Allow uploading files larger than 2GB by using Resumable Media Requests (#5187)
Add range downloads (#5081)

Documentation

Update docstring to reflect correct units (#5277)
Replace link to 404 object IAM docs with a note on limited utility. (#5181)
Update doc reference in GCS client documentation (#5084)
Add see also for Bucket.create method call for Client.create_bucket() documentation. (#5073)
Link out to requester pays docs. (#5065)

Internal / Testing Changes

Add testing support for Python 3.7; remove testing support for Python 3.4. (#5295)
Fix bad trove classifier
Remove unused var (flake8 warning) (#5280)
Fix unit test moving batch to batch/storage/v1 (#5082)

1.8.0

New features

Implement predefined acl (#4757)
Add support for resumable signed url generation (#4789)

Implementation changes

Do not quote embedded slashes for public / signed URLs (#4716)

Dependencies

Update dependency range for api-core to include v1.0.0 releases (#4944)

Documentation

Missing word in docstring (#4763)

Testing and internal changes

Install local dependencies when running lint (#4936)
Re-enable lint for tests, remove usage of pylint (#4921)
Normalize all setup.py files (#4909)

1.7.0

Features

Enable anonymous access to blobs in public buckets (#4315)
Make project optional / overridable for storage client (#4381)
Relax regex used to test for valid project IDs (#4543)
Add support for source_generation parameter to Bucket.copy_blob (#4546)

1.6.0

Documentation

Added link to “Python Development Environment Setup Guide” in project README (#4187, h/t to @michaelawyu)

Dependencies

Upgrading to google-cloud-core >= 0.28.0 and adding dependency on google-api-core (#4221, #4280)
Requiring google-resumable-media >= 0.3.1 (#4244)

PyPI: https://pypi.org/project/google-cloud-storage/1.6.0/