Metadata-Version: 1.1
Name: bucketstore
Version: 0.1.3
Summary: A simple library for interacting with Amazon S3.
Home-page: https://github.com/kennethreitz/bucketstore
Author: Kenneth Reitz
Author-email: me@kennethreitz.com
License: MIT
Description: 
        BucketStore: A simple Amazon S3 Client, for Python.
        ===================================================
        
        **BucketStore** is a very simple Amazon S3 client, written in Python. It
        aims to be much more straight-forward to use than boto3, and specializes
        only in Amazon S3, ignoring the rest of the AWS ecosystem.
        
        
        Features
        --------
        
        - Treats S3 Buckets as Key/Value stores.
        - Automatic support for ``AWS_ACCESS_KEY_ID`` and ``AWS_SECRET_ACCESS_KEY`` environment variables.
        - Easily make keys (or entire buckets) publically accessable.
        - Easily get the public URL for a given key.
        - Generates temporary URLs for a given key.
        
        Usage
        -----
        
        Get (or create) a bucket, easily:
        
        .. code-block:: python
        
            import bucketstore
        
            # Create the bucket if it doesn't exist.
            bucket = bucketstore.get('bucketstore-playground', create=True)
        
        
        Treat the bucket like a key/value store:
        
        .. code-block:: pycon
        
            >>> bucket
            <S3Bucket name='bucketstore-playground'>
        
            >>> bucket['foo'] = 'bar'
            >>> bucket['foo']
            bar
        
            >>> bucket.set('foo2', 'bar2')
            >>> bucket.get('foo2')
            bar2
        
            >>> bucket.list()
            [u'foo', u'foo2']
        
            >>> bucket.all()
            [<S3Key name=u'foo' bucket='bucketstore-playground'>, <S3Key name=u'foo2' bucket='bucketstore-playground'>]
        
        
        Interact with S3 keys:
        
        .. code-block:: pycon
        
            >>> bucket.key('foo')
            <S3Key bucket='bucketstore-playground' name=u'foo'>
        
            >>> foo = _
            >>> foo.set('new value')
        
            # Generate a temporary share URL.
            >>> foo.temp_url(duration=1200)
            u'https://bucketstore-playground.s3.amazonaws.com/foo?AWSAccessKeyId=AKIAI2RVFNXIW7WS66QQ&Expires=1485493909&Signature=L3gD9avwQZQO1i11dIJXUiZ7Nx8%3D'
        
            # Make key publically accessable.
            >>> foo.make_public()
            >>> foo.url
            'https://s3.amazonaws.com/bucketstore-playground/foo'
        
            # Get / set metadata for key.
            >>> foo.meta = {'foo': 'bar'}
            >>> foo.meta
            {'foo': 'bar}
        
            # Rename key to 'foo3'.
            >>> foo.rename('foo3')
        
            # Delete the key.
            >>> foo.delete()
        
            # Create a key with metadata at the same time.
            >>> foo = bucket.key('foo.html')
            >>> foo.set('<h1>bar</h1>', {'content_type': 'text/html'})
        
        Other methods include ``bucketstore.login(access_key_id, secret_access_key)``, ``bucketstore.list()``, and ``bucketstore.get(bucket_name, create=False)``.
        
        Installation
        ------------
        
        ::
        
            $ pip install bucketstore
        
        ✨🍰✨
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
