openS3

Documentation Status tests

A Pythonic way to upload and download from AWS S3.

Installation

$ pip install openS3

To install the latest development version:

$ git clone git@github.com:logston/openS3.git
$ cd openS3
$ python setup.py install

Usage

>>> from openS3 import OpenS3
>>>
>>> openS3 = OpenS3('my_bucket', '<access_key>', '<secret_key>')
... with openS3('/my/object/key.txt', mode='w') as fd:
...     fd.write('Yeah! Files going up to S3!')
>>>
>>> # Let's create a new OpenS3 object so we know we are not
>>> # just printing saved state attached to the previous OpenS3 object.
>>> openS3 = OpenS3('my_bucket', '<access_key>', '<secret_key>')
... with openS3('/my/object/key.txt') as fd:
...     print(fd.read())
b'Yeah! Files going up to S3!'

Further Documentation

Further documentation can be found on Read the Docs.

Contributions

Thanks for wanting to contribute! To contribute with development time, fork the repo logston/openS3 on GitHub and issue a pull request.

Table Of Contents

Next topic

Testing

This Page