1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
.. 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.
|
