aiohttp-s3-client

tox

The simple module for putting and getting object from Amazon S3 compatible endpoints

Installation

pip install aiohttp-s3-client

Usage

from http import HTTPStatus

from aiohttp import ClientSession
from aiohttp_s3_client import S3Client


async with ClientSession(raise_for_status=True) as session:
    client = S3Client(
        url="http://s3-url",
        session=session,
        access_key_id="key-id",
        secret_access_key="hackme",
        region="us-east-1"
    )

    # Upload str object to bucket "bucket" and key "str"
    async with client.put("bucket/str", "hello, world") as resp:
        assert resp.status == HTTPStatus.OK

    # Upload bytes object to bucket "bucket" and key "bytes"
    resp = await client.put("bucket/bytes", b"hello, world")
    assert resp.status == HTTPStatus.OK

    # Upload AsyncIterable to bucket "bucket" and key "iterable"
    async def gen():
        yield b'some bytes'

    resp = await client.put("bucket/file", gen())
    assert resp.status == HTTPStatus.OK

    # Upload file to bucket "bucket" and key "file"
    resp = await client.put_file("bucket/file", "/path_to_file")
    assert resp.status == HTTPStatus.OK

    # Get object by bucket+key
    resp = await client.get("bucket/key")
    data = await resp.read()

Bucket may be specified as subdomain or in object name:

client = S3Client(url="http://bucket.your-s3-host", ...)
resp = await client.put("key", gen())

client = S3Client(url="http://your-s3-host", ...)
resp = await client.put("bucket/key", gen())

client = S3Client(url="http://your-s3-host/bucket", ...)
resp = await client.put("key", gen())

Auth may be specified with keywords or in URL:

client = S3Client(url="http://your-s3-host", access_key_id="key_id",
                  secret_access_key="access_key", ...)

client = S3Client(url="http://key_id:access_key@your-s3-host", ...)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aiohttp-s3-client-0.2.2.tar.gz (4.3 kB view details)

Uploaded Mar 31, 2021 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

aiohttp_s3_client-0.2.2-py3-none-any.whl (12.9 kB view details)

Uploaded Mar 31, 2021 Python 3

File details

Details for the file aiohttp-s3-client-0.2.2.tar.gz.

File metadata

Download URL: aiohttp-s3-client-0.2.2.tar.gz
Upload date: Mar 31, 2021
Size: 4.3 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for aiohttp-s3-client-0.2.2.tar.gz
Algorithm	Hash digest
SHA256	`77c7d5ea6a1ad71cef1ba1b3ed0e53836611466a9924bf56c949309c5f8a4451`
MD5	`e6dbff1c0ad5092a3187eb1f252a52a5`
BLAKE2b-256	`492ee95c76c79b877e6951be134ded27d72b4493270fa9191ed8b7f7f7026894`

See more details on using hashes here.

File details

Details for the file aiohttp_s3_client-0.2.2-py3-none-any.whl.

File metadata

Download URL: aiohttp_s3_client-0.2.2-py3-none-any.whl
Upload date: Mar 31, 2021
Size: 12.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for aiohttp_s3_client-0.2.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`1789315b0a10b94efe9690fca4488b2d6af2de61bcb7e56cf63103ca31cad38e`
MD5	`c5938a825b05f5c46e9a9fadafd0361e`
BLAKE2b-256	`3a87b7fa825228b18471a9c1c174f73136173f82b41ff23fdb75b73038fc21ab`