seanttierney / django-cumulus Goto Github PK

django-cumulus provides a set of tools to utilize the python-swiftclient and Rackspace Cloud Files API from Django. It includes a custom file storage class, CumulusFilesStorage.

More documentation about the usage and installation of django-cumulus can be found on django-cumulus.readthedocs.org.

The source code for django-cumulus can be found and contributed to on github.com/django-cumulus/django-cumulus. There you can also file issues.

To find out what's new in this version of django-cumulus, please see the changelog

This library is maintained by:

• Ferrix Hovi (@ferrix)
• Thomas Schreiber (@rizumu)

They will be able to answer questions, give architectural guidance and merge pull requests.

Please visit django-cumulus.readthedocs.org for the full documentation.

• Install Django Cumulus with your favorite Python package manager:

  pip install django-cumulus
  

• To install the in-development version of Django Cumulus:

  pip install django-cumulus==dev
  

• Add 'cumulus' to the INSTALLED_APPS setting in your project's settings.py:

  INSTALLED_APPS = (
      ...
      'cumulus',
      ...
  )
  

• Add the following to your project's settings.py file:

  CUMULUS = {
      'USERNAME': 'YourUsername',
      'API_KEY': 'YourAPIKey',
      'CONTAINER': 'ContainerName',
      'PYRAX_IDENTITY_TYPE': 'rackspace',
  }
  DEFAULT_FILE_STORAGE = 'cumulus.storage.CumulusStorage'
  

The PYRAX_IDENTITY_TYPE parameter can either be rackspace or keystone depending on whether you use Rackspace or OpenStack respectively.