Metadata-Version: 2.1
Name: cloudstorage
Version: 0.7.0
Summary: Unified cloud storage API for storage services.
Home-page: https://github.com/scottwernervt/cloudstorage
Author: Scott Werner
Author-email: scott.werner.vt@gmail.com
License: MIT
Download-URL: https://github.com/scottwernervt/cloudstorage/archive/0.7.0.tar.gz
Project-URL: Bug Tracker, https://github.com/scottwernervt/cloudstorage/issues
Project-URL: Documentation, https://cloudstorage.readthedocs.io
Project-URL: Source Code, https://github.com/scottwernervt/cloudstorage
Keywords: storage amazon aws s3 azure rackspace cloudfiles google cloudstorage gcs
Platform: Posix; MacOS X; Windows
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: microsoft
Provides-Extra: rackspace
Provides-Extra: google
Provides-Extra: docs
Provides-Extra: amazon
Provides-Extra: local
Requires-Dist: inflection (>=0.3.1)
Requires-Dist: python-dateutil (>=2.7.3)
Requires-Dist: python-magic (>=0.4.15)
Requires-Dist: requests (>=2.19.1)
Requires-Dist: typing; python_version < "3.5"
Requires-Dist: httpstatus35; python_version < "3.5"
Provides-Extra: amazon
Requires-Dist: boto3 (>=1.7.60); extra == 'amazon'
Provides-Extra: docs
Requires-Dist: sphinx; extra == 'docs'
Requires-Dist: sphinx-rtd-theme; extra == 'docs'
Requires-Dist: sphinx-autodoc-typehints; extra == 'docs'
Requires-Dist: Pygments; extra == 'docs'
Provides-Extra: google
Requires-Dist: google-cloud-storage (>=1.10.0); extra == 'google'
Provides-Extra: local
Requires-Dist: filelock (>=3.0.0); extra == 'local'
Requires-Dist: itsdangerous (>=0.24); extra == 'local'
Requires-Dist: xattr (>=0.9.3); extra == 'local'
Provides-Extra: microsoft
Requires-Dist: azure (>=3.0.0); extra == 'microsoft'
Provides-Extra: rackspace
Requires-Dist: rackspacesdk (>=0.7.5); extra == 'rackspace'

Cloud Storage
=============

.. image:: https://img.shields.io/pypi/v/cloudstorage.svg
    :target: https://pypi.python.org/pypi/cloudstorage

.. image:: https://img.shields.io/pypi/l/cloudstorage.svg
    :target: https://pypi.python.org/pypi/cloudstorage

.. image:: https://img.shields.io/pypi/wheel/cloudstorage.svg
    :target: https://pypi.python.org/pypi/cloudstorage

.. image:: https://img.shields.io/pypi/pyversions/cloudstorage.svg
    :target: https://pypi.python.org/pypi/cloudstorage

.. image:: https://travis-ci.org/scottwernervt/cloudstorage.svg?branch=master
    :target: https://travis-ci.org/scottwernervt/cloudstorage

.. image:: https://codeclimate.com/github/scottwernervt/cloudstorage/badges/gpa.svg
    :target: https://codeclimate.com/github/scottwernervt/cloudstorage

`Cloud Storage`_ is a Python +3.4 package which creates a unified API for the
cloud storage services: Amazon Simple Storage Service (S3),
Microsoft Azure Storage, Rackspace Cloud Files, Google Cloud Storage, and the
Local File System.

Cloud Storage is inspired by `Apache Libcloud <https://libcloud.apache.org/>`_.
Advantages to Apache Libcloud Storage are:

* Full Python 3 support.
* Generate temporary signed URLs for downloading and uploading files.
* Support for request and response headers like Content-Disposition.
* Pythonic! Iterate through all blobs in containers and all containers in
  storage using respective objects.

Usage
-----

.. code-block:: python

    >>> from cloudstorage.drivers.amazon import S3Driver
    >>> storage = S3Driver(key='<my-aws-access-key-id>', secret='<my-aws-secret-access-key>')

    >>> container = storage.create_container('avatars')
    >>> container.cdn_url
    'https://avatars.s3.amazonaws.com/'

    >>> avatar_blob = container.upload_blob('/path/my-avatar.png')
    >>> avatar_blob.cdn_url
    'https://s3.amazonaws.com/avatars/my-avatar.png'

    >>> avatar_blob.generate_download_url(expires=3600)
    'https://avatars.s3.amazonaws.com/my-avatar.png?'
    'AWSAccessKeyId=<my-aws-access-key-id>'
    '&Signature=<generated-signature>'
    '&Expires=1491849102'

    >>> container.generate_upload_url('user-1-avatar.png', expires=3600)
    {
        'url': 'https://avatars.s3.amazonaws.com/',
        'fields': {
            'key': 'user-1-avatar.png',
            'AWSAccessKeyId': '<my-aws-access-key-id>',
            'policy': '<generated-policy>',
            'signature': '<generated-signature>'
        }
    }

Supported Services
------------------

* `Amazon S3`_
* `Google Cloud Storage`_
* `Microsoft Azure Storage`_
* `Rackspace CloudFiles`_
* Local File System


Installation
------------

To install Cloud Storage:

.. code-block:: bash

    pip install cloudstorage

Also install the storage driver(s) you will be using:

.. code-block:: bash

    pip install cloudstorage[amazon]
    pip install cloudstorage[google]
    pip install cloudstorage[local]
    pip install cloudstorage[microsoft]
    pip install cloudstorage[rackspace]

.. _`Amazon S3`: http://aws.amazon.com/s3/
.. _`Blackblaze B2 Cloud Storage`: https://www.backblaze.com/b2/Cloud-Storage.html
.. _`Google Cloud Storage`: https://cloud.google.com/storage/
.. _`Microsoft Azure Storage`: https://azure.microsoft.com/services/storage/
.. _`Rackspace CloudFiles`: https://www.rackspace.com/cloud/files
.. _`Cloud Storage`: https://github.com/scottwernervt/cloudstorage


