summaryrefslogtreecommitdiff
path: root/docs/ref/files/storage.txt
AgeCommit message (Collapse)Author
2025-10-30Added community package storage backends mention to docs.Tim Schilling
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
2025-08-25Refs #36485 -- Removed unnecessary parentheses in :meth: and :func: roles in ↵David Smith
docs.
2025-01-15Removed versionadded/changed annotations for 5.1.Sarah Boyce
This also removes remaining versionadded/changed annotations for older versions.
2024-10-24Refs #26029 -- Extended docs for the StorageHandler default instance.Carlton Gibson
Third-party packages that provide storages need to rely on the StorageHandler API in order to allow users to use the `storages` module instance to override defaults. Minimally documenting these methods allows package authors to rely on them. Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com>
2024-07-24Fixed #35604, Refs #35326 -- Made FileSystemStorage.exists() behaviour ↵Sarah Boyce
independent from allow_overwrite. Partially reverts 0b33a3abc2ca7d68a24f6d0772bc2b9fa603744e. Storage.exists(name) was documented to "return False if the name is available for a new file." but return True if the file exists. This is ambiguous in the overwrite file case. It will now always return whether the file exists. Thank you to Natalia Bidart and Josh Schneier for the review.
2024-05-21Fixed #35326 -- Added allow_overwrite parameter to FileSystemStorage.Ben Cail
2024-05-16Moved FileSystemStorage note in docs to the correct place.Sarah Boyce
2023-09-18Refs #26029 -- Removed DEFAULT_FILE_STORAGE and STATICFILES_STORAGE settings.Mariusz Felisiak
This also removes django.core.files.storage.get_storage_class(). Per deprecation timeline.
2023-09-18Removed versionadded/changed annotations for 4.2.Mariusz Felisiak
This also removes remaining versionadded/changed annotations for older versions.
2023-01-12Refs #26029 -- Deprecated DEFAULT_FILE_STORAGE and STATICFILES_STORAGE settings.Jarosław Wygoda
2023-01-12Fixed #26029 -- Allowed configuring custom file storage backends.Jarosław Wygoda
2023-01-10Fixed #34110 -- Added in-memory file storage.Francesco Panico
Thanks Paolo Melchiorre, Carlton Gibson, and Mariusz Felisiak for reviews.
2022-08-10Refs #26029 -- Doc'd django.core.files.storage.default_storage.Jarosław Wygoda
2021-01-14Removed versionadded/changed annotations for 3.1.Mariusz Felisiak
2020-12-21Fixed typo in docs/ref/files/storage.txt.joshuapatel
2020-05-13Removed versionadded/changed annotations for 3.0.Mariusz Felisiak
2019-10-31Refs #28428 -- Made FileSystemStorage.save() to support pathlib.Path.Hasan Ramezani
2019-08-31Refs #30736 -- Added missing versionadded annotations for ↵Mariusz Felisiak
Storage.get_alternative_name(). Thanks Simon Charette for the report.
2019-08-30Fixed #30736 -- Added Storage.get_alternative_name() to allow customization.yukihira1992
2017-04-26Fixed #27644 -- Doc'd FileSystemStorage.get_created_time().Ingo Klöcker
2017-01-17Removed versionadded/changed annotations for 1.10.Tim Graham
2017-01-17Refs #23832 -- Removed deprecated non-timezone aware Storage API.Tim Graham
2016-08-30Fixed #27145 -- Updated Storage.save() docs for refs #18899.Tim Graham
2016-04-30Fixed #26058 -- Delegated os.path bits of FileField's filename generation to ↵Cristiano
the Storage.
2016-02-23Fixed #23832 -- Added timezone aware Storage API.James Aylett
New Storage.get_{accessed,created,modified}_time() methods convert the naive time from now-deprecated {accessed,created_modified}_time() methods into aware objects in UTC if USE_TZ=True.
2016-02-01Fixed #26124 -- Added missing code formatting to docs headers.rowanv
2016-01-22Fixed #26020 -- Normalized header stylings in docs.Elif T. Kus
2015-09-23Refs #9893 -- Removed shims for lack of max_length support in file storage ↵Tim Graham
per deprecation timeline.
2015-07-27Fixed #25159 -- Removed brackets from class/function/method signatures in docs.Tim Graham
Thanks hellbeast for the initial patch.
2015-02-01Removed versionadded/changed notes for 1.7.Tim Graham
2015-01-12Fixed #9893 -- Allowed using a field's max_length in the Storage.Pavel Shpilev
2014-11-15Fixed #23827 -- TZ behavior in Storage API ref docJames Aylett
This is derived from the current behaviour of FileSystemStorage. Note that since this was not previously documented, other implementations may not currently conform.
2014-11-03Fixed versionchanged indentation in docs/.Berker Peksag
2014-08-26Fixed spelling mistake in file docs.Tim Graham
2014-08-20Fixed #23157 -- Removed O(n) algorithm when uploading duplicate file names.Tim Graham
This is a security fix. Disclosure following shortly.
2014-08-08Removed some tabs in the docs.Tim Graham
2014-04-02Fixed #22347 -- Unified FileSystemStorage documentation.Vishal Lal
Thanks nliberg for the report.
2014-01-15Fix typo in storage docsKevin Wood
2013-11-29Fixed #21380 -- Added a way to set different permission for static directories.Vajrasky Kok
Previously when collecting static files, the directories would receive permissions from the global umask. Now the default permission comes from FILE_UPLOAD_DIRECTORY_PERMISSIONS and there's an option to specify the permissions by subclassing any of the static files storage classes and setting the directory_permissions_mode parameter.
2013-10-24Fixed #21219 -- Added a way to set different permission for static files.Vajrasky Kok
Previously, when collecting static files, the files would receive permission from FILE_UPLOAD_PERMISSIONS. Now, there's an option to give different permission from uploaded files permission by subclassing any of the static files storage classes and setting the file_permissions_mode parameter. Thanks dblack at atlassian.com for the suggestion.
2013-01-13Fixed typo in file storage docs.Aymeric Augustin
Thanks Jørgen Abrahamsen.
2013-01-02Fixed #19516 - Fixed remaining broken links.Tim Graham
Added -n to sphinx builds to catch issues going forward.
2012-09-20Fixed #18934 - Removed versionadded/changed annotations for Django 1.3Tim Graham
2011-08-06Fixed #16566 - Typo in docs/ref/files/storage.txt; thanks thejaswi_puthraya.Timo Graham
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16580 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-12-06Fixed #14846 -- Corrected a tiny typo in from [14832]. Thanks to elbarto for ↵Gabriel Hurley
catching the mistake. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14846 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-12-05Fixed #13605 -- Improved documentation of the django.core.files.storage ↵Gabriel Hurley
module. Added documentation for DefaultStorage, get_storage_class, FileSystemStorage, and some missing public methods on Storage. New metadata targets included for everything. Thanks to kopernikus for the report and elbarto for contributing to the patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14831 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-10-08Fixed #10497 -- Added a few time-related methods to the storage API. Thanks ↵Jannis Leidel
for the report and patch to Stephan Jaekel. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14012 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-08-19Fixed #14141: docs now use the :doc: construct for links between documents.Jacob Kaplan-Moss
Thanks, Ramiro Morales. git-svn-id: http://code.djangoproject.com/svn/django/trunk@13608 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2009-06-10Fixed #11056 -- Corrected reference to File class in storage docs. Thanks to ↵Russell Keith-Magee
wam for the report. git-svn-id: http://code.djangoproject.com/svn/django/trunk@10970 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2008-08-31Fixed #8641: Documented the fact that file-saving methods must receive a ↵James Bennett
File instance git-svn-id: http://code.djangoproject.com/svn/django/trunk@8759 bcc190cf-cafb-0310-a4f2-bffc1f526a37
generated by cgit v1.3 (git 2.53.0) at 2026-07-01 23:50:25 +0000