import tinys3

conn = tinys3.Conn(S3_SECRET_KEY,S3_ACCESS_KEY,ssl=True)

with open('some_file.zip','rb') as f:
    conn.upload('some_file.zip',f,'my_bucket', expires='max')

import tinys3

# Creating a simple connection
conn = tinys3.Conn(S3_SECRET_KEY,S3_ACCESS_KEY)

# Uploading a single file
with open('some_file.zip','rb') as f:
    conn.upload('some_file.zip',f,'my_bucket')

# Specifying a default bucket
conn = tinys3.Conn(S3_SECRET_KEY,S3_ACCESS_KEY,default='my_bucket')

# So we could skip the bucket parameter on every request

with open('some_file.zip','rb') as f:
    conn.upload('some_file.zip',f)

# Controlling the use of ssl
conn = tinys3.Conn(S3_SECRET_KEY,S3_ACCESS_KEY,ssl=True)

# File will be stored in cache for one hour:
conn.upload('my_awesome_key.zip','my_local_file.zip',bucket='sample_bucket',
            expires=3600)

# Passing 'max' as the value to 'expires' will make it cachable for a year
conn.upload('my_awesome_key.zip','my_local_file.zip',bucket='sample_bucket',
            expires='max')

# Expires can also handle timedelta object:
from datetime import timedelta

t = timedelta(weeks=5)
# File will be stored in cache for 5 weeks
conn.upload('my_awesome_key.zip','my_local_file.zip',bucket='sample_bucket',
            expires=t)

conn.upload('my_awesome_key.zip','my_local_file.zip',bucket='sample_bucket',
            content_type='application/zip')

conn.upload('my_awesome_key.zip','my_local_file.zip',bucket='sample_bucket',
            headers={
            'x-amz-storage-class': 'REDUCED_REDUNDANCY'
            })

# Simple copy between two buckets
conn.copy('source_key.jpg','source_bucket','target_key.jpg','target_bucket')

# No need to specify the target bucket if we're copying inside the same bucket
conn.copy('source_key.jpg','source_bucket','target_key.jpg')

# We could also update the metadata of the target file
conn.copy('source_key.jpg','source_bucket','target_key.jpg','target_bucket',
            metadata={ 'x-amz-storage-class': 'REDUCED_REDUNDANCY'})

# Or set the target file as private
conn.copy('source_key.jpg','source_bucket','target_key.jpg','target_bucket',
            public=False)

# Updating metadata for a key
conn.update_metadata('key.jpg',{ 'x-amz-storage-class': 'REDUCED_REDUNDANCY'},'my_bucket')

# We can also change the privacy of a file, without updating it's metadata
conn.update_metadata('key.jpg',{},'my_bucket',public=False)

pool = tinys3.Conn(S3_SECRET_KEY,S3_ACCESS_KEY)

pool = tinys3.Conn(S3_SECRET_KEY,S3_ACCESS_KEY,ssl=True, default_bucket='my_bucket')

pool = tinys3.Conn(S3_SECRET_KEY,S3_ACCESS_KEY,size=25)

# Let's use the pool to delete a file
r = pool.delete('a_key_to_delete.zip','my_bucket')
>>> <AsyncResponse completed=False>

# The AsyncResponse is a wrapper to allow us to work with the async nature of the pool

# is completed?
r.completed()
>>> False

# Block until the response is completed
r.response()
>>> <Response [200]>

# Block until completed with a timeout.
# if the response is not completed until the timeout has passed, a TimeoutError will be raised
r.response(timeout=120)
>>> <Response [200]>

# First we'll create a lot of async requests
requests = [pool.delete('key%s' % i, 'my_bucket') for i in range(100)]

# The helper methods as_completed and all_completed helps us work
# with multiple AsyncResponse objects.

# This will block until all the requests are completed
# The results are the responses themselves, without the AsyncResponse wrappers
pool.all_completed(requests)
>>> [<Response [200]>, ... ]


# The as_completed generator will yield on every completed request:
for r in pool.as_completed(requests)
    # r is the response object itself, without the AsyncResponse wrapper
    print r