************
Installation
************

Install
=======

You can install the latest stable version of Cloud Storage using pip:

.. 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]

If you don't have `pip <https://pip.pypa.io>`_ installed,
`this Python installation guide <http://docs.python-guide.org/en/latest/
starting/installation/>`_ can guide you through the process.

Source Code
===========

Cloud Storage is actively developed on GitHub, where the code is
`always available <https://github.com/scottwernervt/cloudstorage>`_.

You can either clone the public repository:

.. code-block:: bash

    git clone https://github.com/scottwernervt/cloudstorage.git

Or, download the
`tarball <https://github.com/scottwernervt/cloudstorage/tarball/master>`_:

.. code-block:: bash

    curl -OL https://github.com/scottwernervt/cloudstorage/tarball/master

Once you have a copy of the source, you can embed it in your own Python
package, or install it into your site-packages easily:

.. code-block:: bash

    python setup.py install
