Metadata-Version: 2.1
Name: sthree
Version: 0.1.0
Summary: A suite of typed data structures backed by Amazon S3.
Home-page: https://github.com/anatoly-scherbakov/sthree
Author: Anatoly Scherbakov
Author-email: altaisoft@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: boto3-type-annotations
Provides-Extra: boto
Requires-Dist: boto3 ; extra == 'boto'
Provides-Extra: dev
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: boto3 ; extra == 'dev'
Requires-Dist: moto ; extra == 'dev'
Requires-Dist: fire ; extra == 'dev'
Requires-Dist: twine ; extra == 'dev'

# Typed access to Amazon S3 for humans

## Installation

```shell script
pip install three
```

`three` requires `boto3` for its operation, but it is not listed as package dependency because, if you'd want to use `three` in AWS Lambda, you do not need to install `boto3` there - since it is already installed.

If you're not using Lambda you may run

```shell script
pip install three[boto]
```

to make sure all dependencies are satisfied.

## Usage Examples

```python
from sthree import Keys
from itertools import islice    

for key in islice(Keys('my-bucket'), 10):
    print(key)

```

## Motivation

Motivation to build this library is to simplify using Amazon S3 in Python applications and to make development experience a bit more pleasant and Pythonic, as well as to benefit from Python's type hinting capabilities.   


