Description

.. image:: https://raw.githubusercontent.com/jschneier/django-storages/master/docs/logos/horizontal.png :alt: Django-Storages :width: 100% .. image:: https://img.shields.io/pypi/v/django-storages.svg :target: https://pypi.org/project/django-storages/ :alt: PyPI Version .. image:: https://github.com/jschneier/django-storages/actions/workflows/ci.yml/badge.svg :target: https://github.com/jschneier/django-storages/actions/workflows/ci.yml :alt: Build Status Installation ============ Installing from PyPI is as easy as doing: .. code-block:: bash 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: .. code-block:: bash pip install -e 'git+https://github.com/jschneier/django-storages.git#egg=django-storages' For detailed instructions on how to configure the backend of your choice please consult the documentation. 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. django-storages is backed in part by `Tidelift`_. Check them out for all of your enterprise open source software commercial support needs. .. _Tidelift: https://tidelift.com/subscription/pkg/pypi-django-storages?utm_source=pypi-django-storages&utm_medium=referral&utm_campaign=enterprise&utm_term=repo Security ======== To report a security vulnerability, please use the `Tidelift security contact`_. Tidelift will coordinate the fix and disclosure. Please **do not** post a public issue on the tracker. .. _Tidelift security contact: https://tidelift.com/security Found a Bug? ============ Issues are tracked via GitHub issues at the `project issue page <https://github.com/jschneier/django-storages/issues>`_. Documentation ============= Documentation for django-storages is located at https://django-storages.readthedocs.io/. 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. Please don't update the library version in CHANGELOG.rst or ``storages/__init__.py``, the maintainer will do that on release. 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.