As of January 1, 2020 this library no longer supports Python 2 on the latest released version.
Library versions released prior to that date will continue to be available. For more information please
visit
Python 2 support on Google Cloud.
Changelog
PyPI History
1.42.0 (2021-08-05)
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)
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
1.41.0 (2021-07-13)
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.39.0 (2021-06-21)
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)
1.37.0 (2021-03-24)
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.34.0 (2020-12-11)
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)
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)
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)
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)
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)
1.29.0 (2020-06-09)
Features
add generationmatch 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 ifgenerationmatch support for Bucket.rename_blob() (#141) (f52efc8)
add ifgenerationMatch 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.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)
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
1.24.1
01-02-2020 13:20 PST
1.24.0
01-02-2020 10:39 PST
Implementation Changes
-str() metadata for for blob (#9796)
1.23.0
11-12-2019 12:57 PST
Internal / Testing Changes
1.22.0
11-05-2019 10:22 PST
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)
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
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)
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
Internal / Testing Changes
1.17.0
07-24-2019 12:37 PDT
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
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
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)
1.15.0
04-17-2019 15:37 PDT
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
1.13.2
12-17-2018 17:02 PST
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)
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.12.0
New Features
Add support for Python 3.7, drop support for Python 3.4. (#5942)
Add lifecycle rules helpers to bucket. (#5877)
Internal / Testing Changes
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)
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
Internal / Testing Changes
1.9.0
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
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
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/