gcloud-rest-storage 5.3.0

Python Client for Google Cloud Storage

This is a shared codebase for gcloud-rest-storage and gcloud-rest-storage

Installation

$ pip install --upgrade gcloud-{aio,rest}-storage

Usage

To upload a file, you might do something like the following:

import aiohttp
from gcloud.rest.storage import Storage


async with aiohttp.ClientSession() as session:
    client = Storage(session=session)

    async with open('/path/to/my/file', mode='r') as f:
        status = await client.upload('my-bucket-name',
                                     'path/to/gcs/folder',
                                     f.read())
        print(status)

Note that there are multiple ways to accomplish the above, ie,. by making use of the Bucket and Blob convenience classes if that better fits your use-case.

You can also refer smoke test for more info and examples.

Note that you can also let gcloud-rest-storage do its own session management, so long as you give us a hint when to close that session:

async with Storage() as client:
    # closes the client.session on leaving the context manager

# OR

client = Storage()
# do stuff
await client.close()  # close the session explicitly

Contributing

Please see our contributing guide.