django-storages (1.13.2)

Published 2024-11-27 18:40:32 +01:00 by eofredj

To install the package using pip, run the following command:

pip install --index-url  django-storages

For more information on the PyPI registry, see the documentation.

Support for many storage backends in Django

.. 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'

Once that is done set DEFAULT_FILE_STORAGE to the backend of your choice. If, for example, you want to use the boto3 backend you would set:

.. code-block:: python

DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'

If you are using the FileSystemStorage as your storage management class in your models FileField fields, remove them and don't specify any storage parameter. That way, the DEFAULT_FILE_STORAGE class will be used by default in your field. For example, if you have a photo field defined as:

.. code-block:: python

photo = models.FileField(
    storage=FileSystemStorage(location=settings.MEDIA_ROOT),
    upload_to='photos',
)

Set it to just:

.. code-block:: python

photo = models.FileField(
    upload_to='photos',
)

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.

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. If you're the first to update the CHANGELOG in this release cycle, just put the version as XXXX-XX-XX.

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.

django-storages CHANGELOG

1.13.2 (2022-12-23)

General

Add support for Python 3.11 (#1196_)
Add support for saving pathlib.Path names (#1200_)

S3

Catch 404 errors when calling delete() (#1201_)

Azure

Use AZURE_CUSTOM_DOMAIN for retrieving blob URLs and storage URL for other operations (#1176_)

Google Cloud

Use DEFAULT_RETRY for all upload & delete operations (#1156_)
Fix gzipping of content (#1203_)
Pass through kwargs to signed URL generator (#1193_)

SFTP

Improve write & memory performance when saving files (#1194_)

1.13.1 (2022-08-06)

Dropbox

Strip off the root path when saving files to fix saving with upgraded versions of Django (#1168_)
Update DropBoxStorage constructor parameter order to be backwards compatible (#1167_)

.. _#1167: https://github.com/jschneier/django-storages/pull/1167 .. _#1168: https://github.com/jschneier/django-storages/pull/1168

1.13 (2022-08-05)

General

Add support for Django 4.0 and 4.1 (#1093_)
Drop support for Django 2.2, 3.0 and 3.1 (#1093_)
Drop support for Python 3.5 and 3.6 (#1093_)

S3

Breaking: Update and document the undocumented AWS_S3_URL_PROTOCOL from http: to https: and remove the undocumented AWS_S3_SECURE_URLS setting. You should only need to update your settings if you had updated either of these previously undocumented settings. The default behavior of constructing an https: URL with a custom domain is unchanged (#1164_)
Add AWS_S3_USE_THREADS to disable threading for compatibility with gevent (#1112_)

Dropbox

Add support for refresh tokens (#1159_)
Ignore ApiError exception in url() (#1158_)

Azure

Restore support for AZURE_ENDPOINT_SUFFIX (#1118_)
Replace deprecated download_to_stream with readinto (#1113_)
Add AZURE_API_VERSION setting (#1132_)
Fix get_modified_time() (#1134_)

Google Cloud

Add support for gzipping files via GS_IS_GZIPPED and GZIP_CONTENT_TYPES (#980_)
Use GS_BLOB_CHUNK_SIZE with files that already exist (#1154_)

1.12.3 (2021-10-29)

General

Add support for Python 3.10 (#1078_)

S3

Re-raise non-404 errors in .exists() (#1084, #1085)

Azure

Fix using AZURE_CUSTOM_DOMAIN with an account key credential (#1082, #1083)

SFTP

Catch FileNotFoundError instead of OSerror in .exists() to prevent swallowing socket.timeout exceptions (#1064, #1087)

.. _#1078: https://github.com/jschneier/django-storages/pull/1078 .. _#1084: https://github.com/jschneier/django-storages/issues/1084 .. _#1085: https://github.com/jschneier/django-storages/pull/1085 .. _#1082: https://github.com/jschneier/django-storages/issues/1082 .. _#1083: https://github.com/jschneier/django-storages/pull/1083 .. _#1064: https://github.com/jschneier/django-storages/issues/1064 .. _#1087: https://github.com/jschneier/django-storages/pull/1087

1.12.2 (2021-10-16)

Azure

Add parameters kwarg to AzureStorage.url to configure blob properties in the SAS token (#1071_)
Fix regression where AZURE_CUSTOM_DOMAIN was interpreted as a replacement of blob.core.windows.net rather than as a full domain (#1073, #1076)

.. _#1071: https://github.com/jschneier/django-storages/pull/1071 .. _#1073: https://github.com/jschneier/django-storages/issues/1073 .. _#1076: https://github.com/jschneier/django-storages/pull/1076

1.12.1 (2021-10-11)

S3

Change gzip compression to use a streaming implementation (#1061_)
Fix saving files with S3ManifestStaticStorage (#1068, #1069)

.. _#1061: https://github.com/jschneier/django-storages/pull/1061 .. _#1068: https://github.com/jschneier/django-storages/issues/1068 .. _#1069: https://github.com/jschneier/django-storages/pull/1069

1.12 (2021-10-06)

General

Add support for Django 3.2 (#1046, #1042, #1005_)
Replace Travis CI with GitHub actions (#1051_)

S3

Convert signing keys to bytes if necessary (#1003_)
Avoid a ListParts API call during multipart upload (#1041_)
Custom domains now use passed URL params (#1054_)
Allow the use of AWS profiles and clarify the options for passing credentials (fbe9538_)
Re-allow override of various access key names (#1026_)
Properly exclude empty folders during listdir (66f4f8e_)
Support saving file objects that are not seekable (#860, #1057)
Return True for .exists() if a non-404 error is encountered (#938_)

Azure

Breaking: This backend has been rewritten to use the newer versions of azure-storage-blob, which now has a minimum required version of 12.0. The settings AZURE_EMULATED_MODE, AZURE_ENDPOINT_SUFFIX, and AZURE_CUSTOM_CONNECTION_STRING are now ignored. (#784, #805)
Add support for user delegation keys (#1063_)

Google Cloud

Breaking: The minimum required version of google-cloud-storage is now 1.27.0 (#994_)
Breaking: Switch URL signing version from v2 to v4 (#994_)
Deprecated: Support for GS_CACHE_CONTROL will be removed in 1.13. Please set the cache_control parameter of GS_OBJECT_PARAMETERS instead. (#970_)
Add GS_OBJECT_PARAMETERS and overridable GoogleCloudStorage.get_object_parameters to customize blob parameters for all blobs and per-blob respectively. (#970_)
Catch the NotFound exception raised when deleting a non-existent blob, this matches Django and other backends (#998, #999)
Fix signing URLs with custom endpoints (#994_)

Dropbox

Validate write_mode param (#1020_)

1.11.1 (2020-12-23)

S3

Revert fix for ValueError: I/O operation on closed file when calling collectstatic and introduce S3StaticStorage and S3ManifestStaticStorage for use as STATICFILES_STORAGE targets (#968_)

.. _#968: https://github.com/jschneier/django-storages/pull/968

1.11 (2020-12-16)

General

Test against Python 3.9 (#964_)

S3

Fix ValueError: I/O operation on closed file when calling collectstatic (#382, #955)
Calculate S3Boto3StorageFile.buffer_size (via setting AWS_S3_FILE_BUFFER_SIZE) at run-time rather than import-time. (#930_)
Fix writing bytearray content (#958, #965)

Google Cloud

Add setting GS_QUERYSTRING_AUTH to avoid signing URLs. This is useful for buckets with a policy of Uniform public read (#952_)

Azure

Add AZURE_OBJECT_PARAMETERS and overridable AzureStorage.get_object_parameters to customize ContentSettings parameters for all keys and per-key respectively. (#898_)

1.10.1 (2020-09-13)

S3

Restore AWS_DEFAULT_ACL handling. This setting is ignored if ACL is set in AWS_S3_OBJECT_PARAMETERS (#934_)

SFTP

Fix using SFTP_STORAGE_HOST (#926_)

.. _#926: https://github.com/jschneier/django-storages/pull/926 .. _#934: https://github.com/jschneier/django-storages/pull/934

1.10 (2020-08-30)

General

Breaking: Removed support for end-of-life Python 2.7 and 3.4 (#709_)
Breaking: Removed support for end-of-life Django 1.11 (#891_)
Add support for Django 3.1 (#916_)
Introduce a new BaseStorage class with a get_default_settings method and use it in S3Boto3Storage, AzureStorage, GoogleCloudStorage, and SFTPStorage. These backends now calculate their settings when instantiated, not imported. (#524, #852)

S3

Breaking: Automatic bucket creation has been removed. Doing so encourages using overly broad credentials. As a result, support for the corresponding AWS_BUCKET_ACL and AWS_AUTO_CREATE_BUCKET settings have been removed. (#636_)
Breaking: Support for the undocumented setting AWS_PRELOAD_METADATA has been removed (#636_)
Breaking: The constructor kwarg acl is no longer accepted. Instead, use the ACL key in setting AWS_S3_OBJECT_PARAMETERS (#636_)
Breaking: The constructor kwarg bucket is no longer accepted. Instead, use bucket_name or the AWS_STORAGE_BUCKET_NAME setting (#636_)
Breaking: Support for setting AWS_REDUCED_REDUNDANCY has been removed. Replace with StorageClass=REDUCED_REDUNDANCY in AWS_S3_OBJECT_PARAMETERS (#636_)
Breaking: Support for setting AWS_S3_ENCRYPTION has been removed. Replace with ServerSideEncryption=AES256 in AWS_S3_OBJECT_PARAMETERS (#636_)
Breaking: Support for setting AWS_DEFAULT_ACL has been removed. Replace with ACL in AWS_S3_OBJECT_PARAMETERS (#636_)
Add http_method parameter to .url method (#854_)
Add support for signing Cloudfront URLs to the .url method. You must set AWS_CLOUDFRONT_KEY, AWS_CLOUDFRONT_KEY_ID and install either cryptography_ or rsa_ (#456, #587). See the docs for more info. URLs will only be signed if AWS_QUERYSTRING_AUTH is set to True (#885_)

Google Cloud

Breaking: Automatic bucket creation has been removed. Doing so encourages using overly broad credentials. As a result, support for the corresponding GS_AUTO_CREATE_BUCKET and GS_AUTO_CREATE_ACL settings have been removed. (#894_)

Dropbox

Add DROPBOX_WRITE_MODE setting to control e.g. overwriting behavior. Check the docs for more info (#873, #138)

SFTP

Remove exception swallowing during ssh connection (#835, #838)

FTP

Add FTP_STORAGE_ENCODING setting to set the filesystem encoding (#803_)
Support multiple nested paths for files (#886_)

1.9.1 (2020-02-03)

S3

Fix reading files with S3Boto3StorageFile (#831, #833)

.. _#831: https://github.com/jschneier/django-storages/issues/831 .. _#833: https://github.com/jschneier/django-storages/pull/833

1.9 (2020-02-02)

General

Breaking: The long deprecated S3 backend based on boto has been removed. (#825_)
Test against and support Python 3.8 (#810_)

S3

Deprecated: Automatic bucket creation will be removed in version 1.10 (#826_)
Deprecated: The undocumented AWS_PRELOAD_METADATA and associated functionality will be removed in version 1.10 (#829_)
Deprecated: Support for AWS_REDUCED_REDUNDANCY will be removed in version 1.10 Replace with StorageClass=REDUCED_REDUNDANCY in AWS_S3_OBJECT_PARAMETERS (#829_)
Deprecated: Support for AWS_S3_ENCRYPTION will be removed in version 1.10 (#829_) Replace with ServerSideEncryption=AES256 in AWS_S3_OBJECT_PARAMETERS
A custom ContentEncoding is no longer overwritten automatically (note that specifying one will disable automatic gzip) (#391, #828).
Add S3Boto3Storage.get_object_parameters, an overridable method for customizing upload parameters on a per-object basis (#819, #828)
Opening and closing a file in w mode without writing anything will now create an empty file in S3, this mimics the builtin open and Django's own FileSystemStorage (#435, #816)
Fix reading a file in text mode (#404, #827)

Google Cloud

Deprecated: Automatic bucket creation will be removed in version 1.10 (#826_)

Dropbox

Fix crash on DropBoxStorage.listdir (#762_)
Settings can now additionally be specified at the class level to ease subclassing (#745_)

Libcloud

Add support for Backblaze B2 to LibCloudStorage.url (#807_)

FTP

Fix creating multiple intermediary directories on Windows (#823, #824)

1.8 (2019-11-20)

General

Add support for Django 3.0 (#759_)
Update license identifier to unambiguous BSD-3-Clause

S3

Include error message raised when missing library is imported (#776, #793)

Google

Breaking The minimum supported version of google-cloud-storage is now 1.15.0 which enables...
Add setting GS_CUSTOM_ENDPOINT to allow usage of custom domains (#775, #648)

Azure

Fix extra installation by pinning version to < 12 (#785_)
Add support for setting AZURE_CACHE_CONTROL header (#780, #674)

1.7.2 (2019-09-10)

S3

Avoid misleading AWS_DEFAULT_ACL warning for insecure default_acl when overridden as a class variable (#591_)
Propagate file deletion to cache when preload_metadata is True, (not the default) (#743, #749)
Fix exception raised on closed file (common if using ManifestFilesMixin or collectstatic. (#382, #754)

Azure

Pare down the required packages in extra_requires when installing the azure extra to only azure-storage-blob (#680, #684)
Fix compatability with generate_blob_shared_access_signature updated signature (#705, #723)
Fetching a file now uses the configured timeout rather than hardcoding one (#727_)
Add support for configuring all blobservice options: AZURE_ENDPOINT_SUFFIX, AZURE_CUSTOM_DOMAIN, AZURE_CONNECTION_STRING, AZURE_TOKEN_CREDENTIAL. See the docs for more info. Huge thanks once again to @nitely. (#750_)
Fix filename handling to not strip special characters (#609, #752)

Google Cloud

Set the file acl in the same call that uploads it (#698_)
Reduce the number of queries and required permissions when GS_AUTO_CREATE_BUCKET is False (the default) (#412, #718)
Set the predefined_acl when creating a GoogleCloudFile using .write (#640, #756)
Add GS_BLOB_CHUNK_SIZE setting to enable efficient uploading of large files (#757_)

Dropbox

Complete migration to v2 api with file fetching and metadata fixes (#724_)
Add DROPBOX_TIMEOUT to configure client timeout defaulting to 100 seconds to match the underlying sdk. (#419, #747)

SFTP

Fix reopening a file (#746_)

1.7.1 (2018-09-06)

Fix off-by-1 error in get_available_name whenever file_overwrite or overwrite_files is True (#588, #589)
Change S3Boto3Storage.listdir() to use list_objects instead of list_objects_v2 to restore compatability with services implementing the S3 protocol that do not yet support the new method (#586, #590)

.. _#588: https://github.com/jschneier/django-storages/issues/588 .. _#589: https://github.com/jschneier/django-storages/pull/589 .. _#586: https://github.com/jschneier/django-storages/issues/586 .. _#590: https://github.com/jschneier/django-storages/pull/590

1.7 (2018-09-03)

Security

The S3BotoStorage and S3Boto3Storage backends have an insecure default ACL of public-read. It is recommended that all current users audit their bucket permissions. Support has been added for setting AWS_DEFAULT_ACL = None and AWS_BUCKET_ACL = None which causes all created files to inherit the bucket's ACL (and created buckets to inherit the Amazon account's default ACL). This will become the default in version 1.10 (for S3Boto3Storage only since S3BotoStorage will be removed in version 1.9, see below). Additionally, a warning is now raised if AWS_DEFAULT_ACL or AWS_BUCKET_ACL is not explicitly set. (#381, #535, #579_)

Breaking

The AzureStorage backend and documentation has been completely rewritten. It now depends on azure and azure-storage-blob and is vastly improved. Big thanks to @nitely and all other contributors along the way (#565_)
The .url() method of GoogleCloudStorage has been completely reworked. Many use cases should require no changes and will experience a massive speedup. The .url() method no longer hits the network for public urls and generates signed urls (with a default of 1-day expiration, configurable via GS_EXPIRATION) for non-public buckets. Check out the docs for more information. (#570_)
Various backends will now raise ImproperlyConfigured at runtime if their location (GS_LOCATION, AWS_LOCATION) begins with a leading / rather than silently stripping it. Verify yours does not. (#520_)
The long deprecated GSBotoStorage backend is removed. (#518_)

Deprecation

The insecure default of public-read for AWS_DEFAULT_ACL and AWS_BUCKET_ACL in S3Boto3Storage will change to inherit the bucket's setting in version 1.10 (#579_)
The legacy S3BotoBackend is deprecated and will be removed in version 1.9. It is strongly recommended to move to the S3Boto3Storage backend for performance, stability and bugfix reasons. See the boto migration docs_ for step-by-step guidelines. (#578, #584)
The long aliased arguments to S3Boto3Storage of acl and bucket are deprecated in favor of bucket_name and default_acl (#516_)
The minimum required version of boto3 will be increasing to 1.4.4 in the next major version of django-storages. (#583_)

Features

Add support for a file to inherit its bucket's ACL by setting AWS_DEFAULT_ACL = None (#535_)
Add GS_CACHE_CONTROL setting for GoogleCloudStorage backend (#411, #505)
Add documentation around using django-storages with Digital Ocean Spaces (#521_)
Add support for Django 2.1 and Python 3.7 (#530_)
Make S3Boto3Storage pickleable (#551_)
Add automatic reconnection to SFTPStorage (#563, #564)
Unconditionally set the security token in the boto backends (b13efd_)
Improve efficiency of .listdir on S3Boto3Storage (#352_)
Add AWS_S3_VERIFY to support custom certificates and disabling certificate verification to S3Boto3Storage (#486, #580)
Add AWS_S3_PROXIES setting to S3Boto3Storage (#583_)
Add a snazzy new logo. Big thanks to @reallinfo

Bugfixes

Reset file read offset before passing to GoogleCloudStorage and AzureStorage (#481, #581, #582_)
Fix various issues with multipart uploads in the S3 backends (#169, #160, #364, #449, #504, #506, #546_)
Fix S3Boto3Storage to stream down large files (also disallow r+w mode) (#383, #548)
Fix SFTPStorageFile to align with the core File abstraction (#487, #568)
Catch IOError in SFTPStorage.delete (#568_)
AzureStorage, GoogleCloudStorage, S3Boto3Storage and S3BotoStorage now respect max_length when file_overwrite = True (#513, #554)
The S3 backends now consistently use compresslevel=9 (the Python stdlib default) for gzipped content (#572, #576)
Improve error message of S3Boto3Storage during an unexpected exception when automatically creating a bucket (#574, #577)

1.6.6 (2018-03-26)

You can now specify the backend you are using to install the necessary dependencies using extra_requires. For example pip install django-storages[boto3] (#417_)
Add additional content-type detection fallbacks (#406, #407)
Add GS_LOCATION setting to specify subdirectory for GoogleCloudStorage (#355_)
Add support for uploading large files to DropBoxStorage, fix saving files (#379, #378, #301_)
Drop support for Django 1.8 and Django 1.10 (and hence Python 3.3) (#438_)
Implement get_created_time for GoogleCloudStorage (#464_)

1.6.5 (2017-08-01)

Fix Django 1.11 regression with gzipped content being saved twice resulting in empty files (#367, #371, #373_)
Fix the mtime when gzipping content on S3Boto3Storage (#374_)

.. _#367: https://github.com/jschneier/django-storages/issues/367 .. _#371: https://github.com/jschneier/django-storages/pull/371 .. _#373: https://github.com/jschneier/django-storages/pull/373 .. _#374: https://github.com/jschneier/django-storages/pull/374

1.6.4 (2017-07-27)

Files uploaded with GoogleCloudStorage will now set their appropriate mimetype (#320_)
Fix DropBoxStorage.url to work. (#357_)
Fix S3Boto3Storage when AWS_PRELOAD_METADATA = True (#366_)
Fix S3Boto3Storage uploading file-like objects without names (#195, #368)
S3Boto3Storage is now threadsafe - a separate session is created on a per-thread basis (#268, #358)

.. _#320: https://github.com/jschneier/django-storages/pull/320 .. _#357: https://github.com/jschneier/django-storages/pull/357 .. _#366: https://github.com/jschneier/django-storages/pull/366 .. _#195: https://github.com/jschneier/django-storages/pull/195 .. _#368: https://github.com/jschneier/django-storages/pull/368 .. _#268: https://github.com/jschneier/django-storages/issues/268 .. _#358: https://github.com/jschneier/django-storages/pull/358

1.6.3 (2017-06-23)

Revert default AWS_S3_SIGNATURE_VERSION to V2 to restore backwards compatability in S3Boto3. It's recommended that all new projects set this to be 's3v4'. (#344_)

.. _#344: https://github.com/jschneier/django-storages/pull/344

1.6.2 (2017-06-22)

Fix regression in safe_join() to handle a trailing slash in an intermediate path. (#341_)
Fix regression in gs.GSBotoStorage getting an unexpected kwarg. (#342_)

.. _#341: https://github.com/jschneier/django-storages/pull/341 .. _#342: https://github.com/jschneier/django-storages/pull/342

1.6.1 (2017-06-22)

Drop support for Django 1.9 (e89db45_)
Fix regression in safe_join() to allow joining a base path with an empty string. (#336_)

.. _e89db45: e89db451d7 .. _#336: https://github.com/jschneier/django-storages/pull/336

1.6 (2017-06-21)

Breaking: Remove backends deprecated in v1.5.1 (#280_)
Breaking: DropBoxStorage has been upgrade to support v2 of the API, v1 will be shut off at the end of the month - upgrading is recommended (#273_)
Breaking: The SFTPStorage backend now checks for the existence of the fallback ~/.ssh/known_hosts before attempting to load it. If you had previously been passing in a path to a non-existent file it will no longer attempt to load the fallback. (#118, #325)
Breaking: The default version value for AWS_S3_SIGNATURE_VERSION is now 's3v4'. No changes should be required (#335_)
Deprecation: The undocumented gs.GSBotoStorage backend. See the new gcloud.GoogleCloudStorage or apache_libcloud.LibCloudStorage backends instead. (#236_)
Add a new backend, gcloud.GoogleCloudStorage based on the google-cloud bindings. (#236_)
Pass in the location constraint when auto creating a bucket in S3Boto3Storage (#257, #258)
Add support for reading AWS_SESSION_TOKEN and AWS_SECURITY_TOKEN from the environment to S3Boto3Storage and S3BotoStorage. (#283_)
Fix Boto3 non-ascii filenames on Python 2.7 (#216, #217)
Fix collectstatic timezone handling in and add get_modified_time to S3BotoStorage (#290_)
Add support for Django 1.11 (#295_)
Add project keyword support to GCS in LibCloudStorage backend (#269_)
Files that have a guessable encoding (e.g. gzip or compress) will be uploaded with that Content-Encoding in the s3boto3 backend (#263, #264)
The Dropbox backend now properly translates backslashes in Windows paths into forward slashes (e52a127_)
The S3 backends now permit colons in the keys (#248, #322)

1.5.2 (2017-01-13)

Actually use SFTP_STORAGE_HOST in SFTPStorage backend (#204_)
Fix S3Boto3Storage to avoid race conditions in a multi-threaded WSGI environment (#238_)
Fix trying to localize a naive datetime when settings.USE_TZ is False in S3Boto3Storage.modified_time. (#235, #234)
Fix automatic bucket creation in S3Boto3Storage when AWS_AUTO_CREATE_BUCKET is True (#196_)
Improve the documentation for the S3 backends

.. _#204: https://github.com/jschneier/django-storages/pull/204 .. _#238: https://github.com/jschneier/django-storages/pull/238 .. _#234: https://github.com/jschneier/django-storages/issues/234 .. _#235: https://github.com/jschneier/django-storages/pull/235 .. _#196: https://github.com/jschneier/django-storages/pull/196

1.5.1 (2016-09-13)

Breaking: Drop support for Django 1.7 (#185_)
Deprecation: hashpath, image, overwrite, mogile, symlinkorcopy, database, mogile, couchdb. See (#202_) to discuss maintenance going forward
Use a fixed mtime argument for GzipFile in S3BotoStorage and S3Boto3Storage to ensure a stable output for gzipped files
Use .putfileobj instead of .put in S3Boto3Storage to use the transfer manager, allowing files greater than 5GB to be put on S3 (#194_ , #201_)
Update S3Boto3Storage for Django 1.10 (#181_) (get_modified_time and get_accessed_time)
Fix bad kwarg name in S3Boto3Storage when AWS_PRELOAD_METADATA is True (#189, #190)

.. _#202: https://github.com/jschneier/django-storages/issues/202 .. _#201: https://github.com/jschneier/django-storages/pull/201 .. _#194: https://github.com/jschneier/django-storages/issues/194 .. _#190: https://github.com/jschneier/django-storages/pull/190 .. _#189: https://github.com/jschneier/django-storages/issues/189 .. _#185: https://github.com/jschneier/django-storages/pull/185 .. _#181: https://github.com/jschneier/django-storages/pull/181

1.5.0 (2016-08-02)

Add new backend S3Boto3Storage (#179_)
Add a strict option to utils.setting (#176_)
Tests, documentation, fixing .close for SFTPStorage (#177_)
Tests, documentation, add .readlines for FTPStorage (#175_)
Tests and documentation for DropBoxStorage (#174_)
Fix MANIFEST.in to not ship .pyc files. (#145_)
Enable CI testing of Python 3.5 and fix test failure from api change (#171_)

.. _#145: https://github.com/jschneier/django-storages/pull/145 .. _#171: https://github.com/jschneier/django-storages/pull/171 .. _#174: https://github.com/jschneier/django-storages/pull/174 .. _#175: https://github.com/jschneier/django-storages/pull/175 .. _#177: https://github.com/jschneier/django-storages/pull/177 .. _#176: https://github.com/jschneier/django-storages/pull/176 .. _#179: https://github.com/jschneier/django-storages/pull/179

1.4.1 (2016-04-07)

Files that have a guessable encoding (e.g. gzip or compress) will be uploaded with that Content-Encoding in the s3boto backend. Compressable types such as application/javascript will still be gzipped. PR #122_
Fix DropBoxStorage.exists check and add DropBoxStorage.url (#127_)
Add GS_HOST setting (with a default of GSConnection.DefaultHost) to fix GSBotoStorage. (#124, #125)

.. _#122: https://github.com/jschneier/django-storages/pull/122 .. _#127: https://github.com/jschneier/django-storages/pull/127 .. _#124: https://github.com/jschneier/django-storages/issues/124 .. _#125: https://github.com/jschneier/django-storages/pull/125

1.4 (2016-02-07)

This package is now released on PyPI as django-storages. Please update your requirements files to django-storages==1.4.

1.3.2 (2016-01-26)

Fix memory leak from not closing underlying temp file in s3boto backend (#106_)
Allow easily specifying a custom expiry time when generating a url for S3BotoStorage (#96_)
Check for bucket existence when the empty path ('') is passed to storage.exists in S3BotoStorage - this prevents a crash when running collectstatic -c on Django 1.9.1 (#112) fixed in #116

.. _#106: https://github.com/jschneier/django-storages/pull/106 .. _#96: https://github.com/jschneier/django-storages/pull/96 .. _#112: https://github.com/jschneier/django-storages/issues/112 .. _#116: https://github.com/jschneier/django-storages/pull/116

1.3.1 (2016-01-12)

A few Azure Storage fixes [pass the content-type to Azure, handle chunked content, fix url] (#45__)
Add support for a Dropbox (dropbox) storage backend
Various fixes to the apache_libcloud backend [return the number of bytes asked for by .read, make .name non-private, don't initialize to an empty BytesIO object] (#55_)
Fix multi-part uploads in s3boto backend not respecting AWS_S3_ENCRYPTION (#94_)
Automatically gzip svg files (#100_)

.. __: https://github.com/jschneier/django-storages/pull/45 .. _#76: https://github.com/jschneier/django-storages/pull/76 .. _#55: https://github.com/jschneier/django-storages/pull/55 .. _#94: https://github.com/jschneier/django-storages/pull/94 .. _#100: https://github.com/jschneier/django-storages/pull/100

1.3 (2015-08-14)

Breaking: Drop Support for Django 1.5 and Python 2.6
Breaking: Remove previously deprecated mongodb backend
Breaking: Remove previously deprecated parse_ts_extended from s3boto storage
Add support for Django 1.8+ (#36__)
Add AWS_S3_PROXY_HOST and AWS_S3_PROXY_PORT settings for s3boto backend (#41_)
Fix Python3K compat issue in apache_libcloud (#52_)
Fix Google Storage backend not respecting GS_IS_GZIPPED setting (#51__, #60_)
Rename FTP _name attribute to name which is what the Django File api is expecting (#70_)
Put StorageMixin first in inheritance to maintain backwards compat with older versions of Django (#63_)

.. __: https://github.com/jschneier/django-storages/pull/36 .. _#41: https://github.com/jschneier/django-storages/pull/41 .. _#52: https://github.com/jschneier/django-storages/issues/52 .. __: https://github.com/jschneier/django-storages/pull/51 .. _#60: https://github.com/jschneier/django-storages/pull/60 .. _#70: https://github.com/jschneier/django-storages/pull/70 .. _#63: https://github.com/jschneier/django-storages/pull/63

1.2.3 (2015-03-14)

Variety of FTP backend fixes (fix exists, add modified_time, remove call to non-existent function) (#26_)
Apparently the year changed to 2015

.. _#26: https://github.com/jschneier/django-storages/pull/26

1.2.2 (2015-01-28)

Remove always show all warnings filter (#21_)
Release package as a wheel
Avoid resource warning during install (#20__)
Made S3BotoStorage deconstructible (previously only S3BotoStorageFile was deconstructible) (#19_)

.. _#21: https://github.com/jschneier/django-storages/pull/21 .. __: https://github.com/jschneier/django-storages/issues/20 .. _#19: https://github.com/jschneier/django-storages/pull/19

1.2.1 (2014-12-31)

Deprecation: Issue warning about parse_ts_extended
Deprecation: mongodb backend - django-mongodb-engine now ships its own storage backend
Fix storage.modified_time crashing on new files when AWS_PRELOAD_METADATA=True (#11, #12__, #14)

.. _#11: https://github.com/jschneier/django-storages/pull/11 __ https://github.com/jschneier/django-storages/issues/12 .. _#14: https://github.com/jschneier/django-storages/pull/14

1.2 (2014-12-14)

Breaking: Remove legacy S3 storage (#1_)
Breaking: Remove mosso files backend (#2_)
Add text/javascript mimetype to S3BotoStorage gzip allowed defaults
Add support for Django 1.7 migrations in S3BotoStorage and ApacheLibCloudStorage (#5, #8)
Python3K (3.3+) now available for S3Boto backend (#4_)

.. _#8: https://github.com/jschneier/django-storages/pull/8 .. _#5: https://github.com/jschneier/django-storages/pull/5 .. _#4: https://github.com/jschneier/django-storages/pull/4 .. _#1: https://github.com/jschneier/django-storages/issues/1 .. _#2: https://github.com/jschneier/django-storages/issues/2

NOTE: Version 1.1.9 is the first release of django-storages after the fork. It represents the current (2014-12-08) state of the original django-storages in master with no additional changes. This is the first release of the code base since March 2013.

1.1.9 (2014-12-08)

Fix syntax for Python3 with pull-request #91_
Support pushing content type from File object to GridFS with pull-request #90_
Support passing a region to the libcloud driver with pull-request #86_
Handle trailing slash paths fixes #188_ fixed by pull-request #85_
Use a SpooledTemporaryFile to conserve memory in S3BotoFile pull-request #69_
Guess content-type for S3BotoStorageFile the same way that _save() in S3BotoStorage does
Pass headers and response_headers through from url to generate_url in S3BotoStorage pull-request #65_
Added AWS_S3_HOST, AWS_S3_PORT and AWS_S3_USE_SSL settings to specify host, port and is_secure in pull-request #66_

Everything Below Here Was Previously Released on PyPI under django-storages

1.1.8 (2013-03-31)

Fixes #156_ regarding date parsing, ValueError when running collectstatic
Proper handling of boto dev version parsing
Made SFTP URLs accessible, now uses settings.MEDIA_URL instead of sftp://

.. _#156: https://bitbucket.org/david/django-storages/issue/156/s3boto-backend-valueerror-time-data-thu-07

1.1.7 (2013-03-20)

Listing of huge buckets on S3 is now prevented by using the prefix argument to boto's list() method
Initial support for Windows Azure Storage
Switched to useing boto's parse_ts date parser getting last modified info when using S3boto backend
Fixed key handling in S3boto and Google Storage backends
Account for lack of multipart upload in Google Storage backend
Fixed seek() issue when using AWS_IS_GZIPPED by darkness51 with pull-request #50_
Improvements to S3BotoStorage and GSBotoStorage

.. _#50: https://bitbucket.org/david/django-storages/pull-request/50/

1.1.6 (2013-01-06)

Merged many changes from Jannis Leidel (mostly regarding gzipping)
Fixed tests by Ian Lewis
Added support for Google Cloud Storage backend by Jannis Leidel
Updated license file by Dan Loewenherz, fixes #133_ with pull-request #44_
Set Content-Type header for use in upload_part_from_file by Gerardo Curiel
Pass the rewind parameter to Boto's set_contents_from_file method by Jannis Leidel with pull-request #45_
Fix for FTPStorageFile close() method by Mathieu Comandon with pull-request #43_
Minor refactoring by Oktay Sancak with pull-request #48_
Ungzip on download based on Content-Encoding by Gavin Wahl with pull-request #46_
Add support for S3 server-side encryption by Tobias McNulty with pull-request #17_
Add an optional setting to the boto storage to produce protocol-relative URLs, fixes #105_

1.1.5 (2012-07-18)

Merged pull request #36_ from freakboy3742 Keith-Magee, improvements to Apache Libcloud backend and docs
Merged pull request #35_ from atodorov, allows more granular S3 access settings
Add support for SSL in Rackspace Cloudfiles backend
Fixed the listdir() method in s3boto backend, fixes #57_
Added base url tests for safe_join in s3boto backend
Merged pull request #20_ from alanjds, fixed SuspiciousOperation warning if AWS_LOCATION ends with '/'
Added FILE_BUFFER_SIZE setting to s3boto backend
Merged pull request #30_ from pendletongp, resolves #108, #109 and #110_
Updated the modified_time() method so that it doesn't require dateutil. fixes #111_
Merged pull request #16_ from chamal, adds Apache Libcloud backend
When preloading the S3 metadata make sure we reset the files key during saving to prevent stale metadata
Merged pull request #24_ from tobias.mcnulty, fixes bug where s3boto backend returns modified_time in wrong time zone
Fixed HashPathStorage.location to no longer use settings.MEDIA_ROOT
Remove download_url from setup file so PyPI dist is used

1.1.4 (2012-01-06)

Added PendingDeprecationWarning for mosso backend
Merged pull request #13_ from marcoala, adds SFTP_KNOWN_HOST_FILE setting to SFTP storage backend
Merged pull request #12_ from ryankask, fixes HashPathStorage tests that delete remote media
Merged pull request #10_ from key, adds support for django-mongodb-engine 0.4.0 or later, fixes GridFS file deletion bug
Fixed S3BotoStorage performance problem calling modified_time()
Added deprecation warning for s3 backend, refs #40_
Fixed CLOUDFILES_CONNECTION_KWARGS import error, fixes #78_
Switched to sphinx documentation, set official docs up on https://django-storages.readthedocs.io/
HashPathStorage uses self.exists now, fixes #83_

.. _#13: https://bitbucket.org/david/django-storages/pull-request/13/a-version-of-sftp-storage-that-allows-you .. _#12: https://bitbucket.org/david/django-storages/pull-request/12/hashpathstorage-tests-deleted-my-projects .. _#10: https://bitbucket.org/david/django-storages/pull-request/10/support-django-mongodb-engine-040 .. _#40: https://bitbucket.org/david/django-storages/issue/40/deprecate-s3py-backend .. _#78: https://bitbucket.org/david/django-storages/issue/78/import-error .. _#83: https://bitbucket.org/david/django-storages/issue/6/symlinkorcopystorage-new-custom-storage

1.1.3 (2011-08-15)

Created this lovely change log
Fixed #89_: broken StringIO import in CloudFiles backend
Merged pull request #5_: HashPathStorage path bug

.. _#89: https://bitbucket.org/david/django-storages/issue/89/112-broke-the-mosso-backend .. _pull request #5: https://bitbucket.org/david/django-storages/pull-request/5/fixed-path-bug-and-added-testcase-for

Requires Python: >=3.7

Details

PyPI

2024-11-27 18:40:32 +01:00

Josh Schneier

Project website

BSD-3-Clause

46 KiB

Assets (1)

django_storages-1.13.2-py3-none-any.whl 46 KiB

Versions (1) View all

1.13.2

2024-11-27

django-storages (1.13.2)

Installation

About this package

Installation

About

Security

Found a Bug?

Documentation

Contributing

History

django-storages CHANGELOG

General

S3

Azure

Google Cloud

SFTP

Dropbox

General

S3

Dropbox

Azure

Google Cloud

General

S3

Azure

SFTP

Azure

S3

General

S3

Azure

Google Cloud

Dropbox

S3

General

S3

Google Cloud

Azure

S3

SFTP

General

S3

Google Cloud

Dropbox

SFTP

FTP

S3

General

S3

Google Cloud

Dropbox

Libcloud

FTP

General

S3

Google

Azure

S3

Azure

Google Cloud

Dropbox

SFTP

Requirements