summaryrefslogtreecommitdiff
path: root/docs/ref/files
AgeCommit message (Collapse)Author
7 daysReplaced references in docs to accepted PEPs with specific Python docs links.Mike Edmunds
Where the docs used `:pep:` links for established Python language features, replaced them with direct references to the Python docs (usually glossary terms).
2025-10-30Added community package storage backends mention to docs.Tim Schilling
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
2025-08-28Fixed #36570 -- Removed unnecessary :py domain from documentation roles.SaJH
Signed-off-by: SaJH <wogur981208@gmail.com>
2025-08-25Refs #36485 -- Rewrapped docs to 79 columns line length.David Smith
Lines in the docs files were manually adjusted to conform to the 79 columns limit per line (plus newline), improving readability and consistency across the content.
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-22Removed versionadded/changed annotations for 5.0.Natalia
This also removes remaining versionadded/changed annotations for older versions.
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-09-11Fixed #34642 -- Added File.open() support for *args and **kwargs.Yves Weissig
2023-05-04Corrected code-block directives in docs.Jannis Vajen
2023-03-01Fixed #34140 -- Reformatted code blocks in docs with blacken-docs.django-bot
2023-02-10Refs #34140 -- Applied rst code-block to non-Python examples.Carlton Gibson
Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for reviews.
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-09-20Removed versionadded/changed annotations for 3.2.Mariusz Felisiak
2021-04-16Corrected File, ContentFile, and ImageFile signatures in docs.Adam Johnson
2021-01-14Removed versionadded/changed annotations for 3.1.Mariusz Felisiak
2020-12-21Fixed typo in docs/ref/files/storage.txt.joshuapatel
2020-09-30Fixed #30422 -- Made TemporaryFileUploadHandler handle interrupted uploads.aryan
This patch allows upload handlers to handle interrupted uploads. Co-Authored-By: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2020-05-13Used :pep: role in various docs.Nick Pope
2020-05-13Removed versionadded/changed annotations for 3.0.Mariusz Felisiak
2020-04-15Used :rfc: role in various docs.Mariusz Felisiak
2019-12-23Removed unnecessary code-block directives in various docs.Jon Dufresne
2019-10-31Refs #28428 -- Made FileSystemStorage.save() to support pathlib.Path.Hasan Ramezani
2019-09-06Fixed #30573 -- Rephrased documentation to avoid words that minimise the ↵Tobias Kunze
involved difficulty. This patch does not remove all occurrences of the words in question. Rather, I went through all of the occurrences of the words listed below, and judged if they a) suggested the reader had some kind of knowledge/experience, and b) if they added anything of value (including tone of voice, etc). I left most of the words alone. I looked at the following words: - simply/simple - easy/easier/easiest - obvious - just - merely - straightforward - ridiculous Thanks to Carlton Gibson for guidance on how to approach this issue, and to Tim Bell for providing the idea. But the enormous lion's share of thanks go to Adam Johnson for his patient and helpful review.
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
2019-03-28Fixed "byte string" typo in various docs and comments.Mariusz Felisiak
2018-07-07Fixed word choice in ContentFile example.Josh Schneier
2018-05-17Removed versionadded/changed annotations for 2.0.Tim Graham
2017-09-22Removed versionadded/changed annotations for 1.11.Tim Graham
2017-05-31Refs #27777 -- Improved docs/added test for File context manager change.Ingo Klöcker
2017-04-26Refs #23919 -- Removed File's Python 2 proxied methods.Josh Schneier
2017-04-26Fixed #27644 -- Doc'd FileSystemStorage.get_created_time().Ingo Klöcker
2017-04-25Removed nonexistent methods from File's docs.Josh Schneier
read() and write() were removed in 68a890e79f660484d05482902663b6168f0bd71e.
2017-04-07Fixed #27777 -- Made File.open() work with the with statement (#8310)Ingo Klöcker
Fixed #27777 -- Made File.open() work with the with statement
2017-01-26Refs #23919, #27778 -- Removed obsolete mentions of unicode.Vytis Banaitis
2017-01-18Refs #23919 -- Removed Python 2 notes in docs.Tim Graham
2017-01-18Refs #23919 -- Removed encoding preambles and future importsClaude Paroz
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-05-27Fixed #26646 -- Added IOBase methods required by TextIOWrapper to File.Simon Charette
Thanks Tim for the review.