Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

feat: add blob.open() for file-like I/O #385

Merged
merged 9 commits into from Mar 24, 2021
Merged

feat: add blob.open() for file-like I/O #385

Changes from 1 commit
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
323291a
feat: add blob.open() for file-like I/O
andrewsg Feb 22, 2021
e6c6cf1
coverage
andrewsg Feb 22, 2021
12d1f33
remove accidentally duplicated tests
andrewsg Feb 23, 2021
40245aa
docstrings
andrewsg Mar 18, 2021
ccf0bb4
Validate chunk size
andrewsg Mar 20, 2021
876d1f6
Enable seek on sliding buffer (backwards only)
andrewsg Mar 20, 2021
55fc90a
docstrings
andrewsg Mar 24, 2021
1bd04e8
docstrings final pass
andrewsg Mar 24, 2021
8cd9ecf
docstrings final final pass
andrewsg Mar 24, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
9 changes: 8 additions & 1 deletion google/cloud/storage/blob.py
View file
Open in desktop
Expand Up @@ -3426,6 +3426,13 @@ def open(
This method can be used as a context manager, just like Python's
built-in 'open()' function.

While reading, as with other read methods, if blob.generation is not set
the most recent blob generation will be used. Because the file-like IO
reader downloads progressively in chunks, this could result in data from
multiple versions being mixed together. If this is a concern, use
either bucket.get_blob(), or blob.reload(), which will download the
latest generation number and set it.
andrewsg marked this conversation as resolved.
Show resolved Hide resolved

:type mode: str
andrewsg marked this conversation as resolved.
Show resolved Hide resolved
:param mode:
(Optional) A mode string, as per standard Python `open()` semantics.The first
Expand Down Expand Up @@ -3485,7 +3492,7 @@ def open(
>>> client = storage.Client()
>>> bucket = client.bucket("bucket-name")

>>> blob = bucket.blob("blob-name.txt")
>>> blob = bucket.get_blob("blob-name.txt")
andrewsg marked this conversation as resolved.
Show resolved Hide resolved
>>> with blob.open("rt") as f:
>>> print(f.read())

Expand Down