Fixed #22347 -- Unified FileSystemStorage documentation.

Thanks nliberg for the report.
This commit is contained in:
Vishal Lal 2014-04-02 08:08:20 +00:00 committed by Tim Graham
parent 608e6eb295
commit ca93f02c62
2 changed files with 12 additions and 14 deletions

View File

@ -36,6 +36,16 @@ The FileSystemStorage Class
:class:`~django.core.files.storage.Storage` and provides implementations
for all the public methods thereof.
.. attribute:: location
Absolute path to the directory that will hold the 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 that the file will receive when it is

View File

@ -149,20 +149,8 @@ See :doc:`/ref/files/storage` for the file storage API.
The built-in filesystem storage class
-------------------------------------
Django ships with a built-in ``FileSystemStorage`` class (defined in
``django.core.files.storage``) which implements basic local filesystem file
storage. Its initializer takes two arguments:
====================== ===================================================
Argument Description
====================== ===================================================
``location`` Optional. Absolute path to the directory that will
hold the files. If omitted, it will be set to the
value of your :setting:`MEDIA_ROOT` setting.
``base_url`` Optional. URL that serves the files stored at this
location. If omitted, it will default to the value
of your :setting:`MEDIA_URL` setting.
====================== ===================================================
Django ships with a :class:`django.core.files.storage.FileSystemStorage` class
which implements basic local filesystem file storage.
For example, the following code will store uploaded files under
``/media/photos`` regardless of what your :setting:`MEDIA_ROOT` setting is::