summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorFrancesco Panico <panico.francesco@gmail.com>2022-11-11 07:17:49 +0100
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2023-01-10 10:56:59 +0100
commit72efd840a8cb6ee35a3732d8bb434e7361970b3c (patch)
tree8379ee124d0c278b593b3dc2487ab8e44ad64c30 /docs/ref
parent04fdf719331dde6b0f4e7cdc445be4d4278f3ec4 (diff)
Fixed #34110 -- Added in-memory file storage.
Thanks Paolo Melchiorre, Carlton Gibson, and Mariusz Felisiak for reviews.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/files/storage.txt33
1 files changed, 33 insertions, 0 deletions
diff --git a/docs/ref/files/storage.txt b/docs/ref/files/storage.txt
index c09a46fa64..fa79a4f91a 100644
--- a/docs/ref/files/storage.txt
+++ b/docs/ref/files/storage.txt
@@ -74,6 +74,39 @@ The ``FileSystemStorage`` class
time of the last metadata change, and on others (like Windows), it's
the creation time of the file.
+The ``InMemoryStorage`` class
+=============================
+
+.. versionadded:: 4.2
+
+.. class:: InMemoryStorage(location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None)
+
+ The :class:`~django.core.files.storage.InMemoryStorage` class implements
+ a memory-based file storage. It has no persistence, but can be useful for
+ speeding up tests by avoiding disk access.
+
+ .. attribute:: location
+
+ Absolute path to the directory name assigned to files. Defaults to the
+ value of your :setting:`MEDIA_ROOT` setting.
+
+ .. attribute:: base_url
+
+ URL that serves the files stored at this location.
+ Defaults to the value of your :setting:`MEDIA_URL` setting.
+
+ .. attribute:: file_permissions_mode
+
+ The file system permissions assigned to files, provided for
+ compatibility with ``FileSystemStorage``. Defaults to
+ :setting:`FILE_UPLOAD_PERMISSIONS`.
+
+ .. attribute:: directory_permissions_mode
+
+ The file system permissions assigned to directories, provided for
+ compatibility with ``FileSystemStorage``. Defaults to
+ :setting:`FILE_UPLOAD_DIRECTORY_PERMISSIONS`.
+
The ``Storage`` class
=====================