django-storages 0,2 travis-ci python

3 years after

=============== django-storages

.. image:: https://travis-ci.org/jschneier/django-storages.png?branch=master :target: https://travis-ci.org/jschneier/django-storages :alt: Build Status

.. image:: https://pypip.in/v/django-storages/badge.png :target: https://pypi.python.org/pypi/django-storages :alt: PyPI Version

Installation

Installing from PyPI is as easy as doing::

pip install django-storages

If you'd prefer to install from source (maybe there is a bugfix in master that hasn't been released yet) then the magic incantation you are looking for is::

pip install -e 'git+https://github.com/jschneier/django-storages.git#egg=django-storages'

Once that is done add storages to your INSTALLED_APPS and set DEFAULT_FILE_STORAGE to the backend of your choice. If, for example, you want to use the s3boto backend you would set::

DEFAULT_FILE_STORAGE = 'storages.backends.s3boto.S3BotoStorage'

There are also a number of settings available to control how each storage backend functions, please consult the documentation for a comprehensive list.

About

django-storages is a project to provide a variety of storage backends in a single library.

This library is usually compatible with the currently supported versions of Django. Check the trove classifiers in setup.py to be sure.

History

This repo began as a fork of the original library under the package name of django-storages-redux and became the official successor (releasing under django-storages on PyPI) in February of 2016.

Found a Bug? Something Unsupported?

I suspect that a few of the storage engines in backends/ have been unsupported for quite a long time. I personally only really need the S3Storage backend but welcome bug reports (and especially) patches and tests for some of the other backends.

Issues are tracked via GitHub issues at the project issue page <https://github.com/jschneier/django-storages/issues>_.

Documentation

The original documentation for django-storages is located at https://django-storages.readthedocs.org/. Stay tuned for forthcoming documentation updates.

Contributing

. `Check for open issues

https://github.com/jschneier/django-storages/issues`_ at the project issue page or open a new issue to start a discussion about a feature or bug.

. Fork the `django-storages repository on GitHub

https://github.com/jschneier/django-storages`_ to start making changes.

. Add a test case to show that the bug is fixed or the feature is implemented

correctly.

. Bug me until I can merge your pull request. Also, don't forget to add

yourself to AUTHORS.

Related Repositories

awesome-django

awesome-django

A curated list of awesome Django apps, projects and resources. ...

django-ckeditor

django-ckeditor

Django admin CKEditor integration. ...

django-wysiwyg-redactor

django-wysiwyg-redactor

A lightweight wysiwyg editor for Django ...

django-s3-storage

django-s3-storage

Django Amazon S3 file storage. ...

django-cb-storage-s3

django-cb-storage-s3

Updated Amazon S3 storage from django-storages. Adds more fixes than I can remem ...


Top Contributors

jschneier davidbgk richleland IanLewis jezdez SmileyChris ZuluPro mattbriancon comandrei gvangool zuck skirsdeda tobiasmcnulty erlingbo thenewguy maryokhin fhahn btubbs freakboy3742 dziegler fmartingr kaedroho mattrobenolt key alanjds alex streeter j00bar strycore mmlin

Releases

-   1.5.0 zip tar
-   1.4.1 zip tar
-   1.4 zip tar
-   1.3.2 zip tar
-   1.3.1 zip tar
-   1.3 zip tar
-   1.2.1 zip tar
-   1.2 zip tar
-   1.1.9 zip tar
-   1.1.8 zip tar
-   1.1.7 zip tar
-   1.1.6 zip tar
-   1.1.5 zip tar
-   1.1.4 zip tar
-   1.1.3 zip tar
-   1.1.2 zip tar
-   1.1.1 zip tar
-   1.1 zip tar