Metadata-Version: 2.4
Name: st-aws-s3
Version: 0.1.0
Summary: AWS S3 store provider for storium.
Author: Kaustubh Paturi
License-Expression: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: storium<1,>=0.1.0
Requires-Dist: boto3>=1.28
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: moto[s3]>=5; extra == "dev"
Dynamic: license-file

# st-aws-s3

AWS S3 provider for [storium](https://pypi.org/project/storium/).
Installs into the `storium.stores.aws_s3` namespace.

    pip install storium st-aws-s3

    from storium import StoriumClient
    client = StoriumClient("aws_s3").create_store_client(
        connection_string="ACCESS_KEY=...;SECRET_KEY=...;REGION=us-east-1",
        container="my-bucket",
    )

Also accepts explicit kwargs: `access_key`, `secret_key`, `region`,
`endpoint_url` (for S3-compatible stores like MinIO), `container`.
Omit the keys entirely to use the ambient AWS credential chain.

`connection_string` and the individual kwargs (`access_key`, `secret_key`,
`region`, `endpoint_url`) can be combined, as long as you don't give the
SAME field both ways - e.g. a connection string with `ACCESS_KEY=...` plus
a direct `access_key=...` is ambiguous and raises
`InvalidCredentialsException`; a connection string without a `REGION=`
segment plus a direct `region=...` is fine. `container` is always required,
and omitting all credential input uses the ambient AWS credential chain
(e.g. an IAM role).
