This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
=============================
django-fallback-storage
=============================

.. image:: https://badge.fury.io/py/django-fallback-storage.png
:target: https://badge.fury.io/py/django-fallback-storage

.. image:: https://travis-ci.org/simpleenergy/django-fallback-storage.png?branch=master
:target: https://travis-ci.org/simpleenergy/django-fallback-storage

``django-fallback-storage`` allows for the use of multiple storage engines at
the same time. It works by iterating through the declared storage backends
until one succeeds with the desired storage action.

While usable in a production environment, this tool was primarily designed to
help with development of a project.

Consider a production site using the ``S3BotoStorage`` backend to store its
static assets on Amazon S3 and a development environment that regularly gets
database dumps from the production environment. In order to get the media
associated with the database dump to work, the development environment could be
configured to use the same S3 bucket. This could be problematic, as it would
risk making unwanted modifications to the production media.

The ``FallbackStorage`` backend provided by ``django-fallback-storage`` allows
use of the same production production media source in the development
environment while delegating all write operations to a different storage
backend (such as the filesystem).

This is accomplished by wrapping multiple storage backends, and iterating
through them for each request until one of them returns a successful response.


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

1. Install the package::

.. code-block:: bash

$ pip install django-fallback-storage

2. Set ``fallback_storage.storage.FallbackStorage`` as your desired storage
backend.::

.. code-block:: python

# settings.py
DEFAULT_FILE_STORAGE = "fallback_storage.storage.FallbackStorage"

3. Declare what storage backends fallback storage should use.::

.. code-block:: python

# All operations will be tried first on `FileSystemStorage` and then on
# `S3BotoStorage`.
FALLBACK_STORAGES = (
"django.core.files.storage.FileSystemStorage",
"storages.backends.s3boto.S3BotoStorage",
)


API
---

``FallbackStorage`` implements all of the following backend methods.

* ``_open()``
* ``_save()``
* ``delete()``
* ``exists()``
* ``listdir()``
* ``size()``
* ``url()``
* ``accessed_time()``
* ``created_time()``
* ``modified_time()``
* ``get_valid_name()``
* ``get_available_name()``
* ``path()``

When one of these methods is called, each backend declared in
``FALLBACK_STORAGES`` is called. The first successful response is
returned.

Any backend which does not implement a given method will be skipped over. If
none of the backends implement a called method, then an ``AttributeError`` is
raised.

Exceptions raised by any backend are reraised if none of the backends returns a
successful response.

The following methods behave somewhat specially.

* **FallbackStorage.exists(name)**::

Will return ``True`` if the file exists in *any* of the storage backends.

* **FallbackStorage.listdir(path)**::

Will return the set of all directories and files in all of the storage backents.

* **FallbackStorage.url(name)**::

When computing a url, FallbackStorage first checks if the file exists. If
the file exists in none of the storage backends, the last backend is used to
compute the file name.
Release History

Release History

1.0.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django_fallback_storage-1.0.0-py2.py3-none-any.whl (6.9 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Dec 5, 2014
django-fallback-storage-1.0.0.tar.gz (5.6 kB) Copy SHA256 Checksum SHA256 Source Dec 5, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting