A fairly simple, decently quick interface to Amazon's S3 storage service.
It grew out of frustration with other libraries that were either written too pragmatically (slow), too bloatedly, or just half-done.
The module aims for:
- decent speed,
It really is designed to fit into programmer memory. The three basic operations are as easy as with dictionaries.
Requires Python 2.5+ and nose for running tests. Python 3 support is not yet available. Apart from that, the code relies solely on Python standard libraries.
pip install simples3
Access to a bucket is done via the S3Bucket class. It has three required arguments:
from simples3.bucket import S3Bucket s = S3Bucket(bucket, access_key=access_key, secret_key=secret_key) print s #<S3Bucket ... at 'https://s3.amazonaws.com/...'>
To add a file, simply do
s.put("my file", "my content")
To retrieve a file do
f = s.get("my file") print f.read() #my content
To retrieve information about a file, do
print f.s3_info["mimetype"] #'application/octet-stream' print f.s3_info.keys() #['mimetype', 'modify', 'headers', 'date', 'size', 'metadata']
To delete a file, do
del s["my file!"]
For more detailed documentation, refer here