django.core.files.storage.FileSystemStorage

class documentation

class FileSystemStorage(Storage):

Known subclasses: django.contrib.staticfiles.storage.StaticFilesStorage

View In Hierarchy

Standard filesystem storage
Method get​_created​_time Return the creation time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True.
Constant OS​_OPEN​_FLAGS Undocumented
Method __init__ Undocumented
Method ​_clear​_cached​_properties Reset setting based property values.
Method ​_datetime​_from​_timestamp If timezone support is enabled, make an aware datetime object in UTC; otherwise make a naive one in the local timezone.
Method ​_open Undocumented
Method ​_save Undocumented
Method ​_value​_or​_setting Undocumented
Method delete Delete the specified file from the storage system.
Method exists Return True if a file referenced by the given name already exists in the storage system, or False if the name is available for a new file.
Method get​_accessed​_time Return the last accessed time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True.
Method get​_modified​_time Return the last modified time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True.
Method listdir List the contents of the specified path. Return a 2-tuple of lists: the first item being directories, the second item being files.
Method path Return a local filesystem path where the file can be retrieved using Python's built-in open() function. Storage systems that can't be accessed using open() should not implement this method.
Method size Return the total size, in bytes, of the file specified by name.
Method url Return an absolute URL where the file's contents can be accessed directly by a web browser.
Instance Variable ​_base​_url Undocumented
Instance Variable ​_directory​_permissions​_mode Undocumented
Instance Variable ​_file​_permissions​_mode Undocumented
Instance Variable ​_location Undocumented
Property base​_location Undocumented
Property base​_url Undocumented
Property directory​_permissions​_mode Undocumented
Property file​_permissions​_mode Undocumented
Property location Undocumented

Inherited from Storage:

Method generate​_filename Validate the filename by calling get_valid_name() and return a filename to be passed to the save() method.
Method get​_alternative​_name Return an alternative filename, by adding an underscore and a random 7 character alphanumeric string (before the file extension, if one exists) to the filename.
Method get​_available​_name Return a filename that's free on the target storage system and available for new content to be written to.
Method get​_valid​_name Return a filename, based on the provided filename, that's suitable for use in the target storage system.
Method open Retrieve the specified file from storage.
Method save Save new content to the file specified by name. The content should be a proper File object or any Python file-like object, ready to be read from the beginning.
def get_created_time(self, name):
overrides django.core.files.storage.Storage.get_created_time
Return the creation time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True.
OS_OPEN_FLAGS =

Undocumented

Value
((os.O_WRONLY|os.O_CREAT)|os.O_EXCL)|getattr(os, 'O_BINARY', 0)
def __init__(self, location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None):
overridden in django.contrib.staticfiles.storage.StaticFilesStorage

Undocumented

def _clear_cached_properties(self, setting, **kwargs):
Reset setting based property values.
def _datetime_from_timestamp(self, ts):
If timezone support is enabled, make an aware datetime object in UTC; otherwise make a naive one in the local timezone.
def _open(self, name, mode='rb'):

Undocumented

def _save(self, name, content):

Undocumented

def _value_or_setting(self, value, setting):

Undocumented

def delete(self, name):
overrides django.core.files.storage.Storage.delete
Delete the specified file from the storage system.
def exists(self, name):
overrides django.core.files.storage.Storage.exists
Return True if a file referenced by the given name already exists in the storage system, or False if the name is available for a new file.
def get_accessed_time(self, name):
overrides django.core.files.storage.Storage.get_accessed_time
Return the last accessed time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True.
def get_modified_time(self, name):
overrides django.core.files.storage.Storage.get_modified_time
Return the last modified time (as a datetime) of the file specified by name. The datetime will be timezone-aware if USE_TZ=True.
def listdir(self, path):
overrides django.core.files.storage.Storage.listdir
List the contents of the specified path. Return a 2-tuple of lists: the first item being directories, the second item being files.
def path(self, name):
overrides django.core.files.storage.Storage.path
overridden in django.contrib.staticfiles.storage.StaticFilesStorage
Return a local filesystem path where the file can be retrieved using Python's built-in open() function. Storage systems that can't be accessed using open() should not implement this method.
def size(self, name):
overrides django.core.files.storage.Storage.size
Return the total size, in bytes, of the file specified by name.
def url(self, name):
overrides django.core.files.storage.Storage.url
Return an absolute URL where the file's contents can be accessed directly by a web browser.
_base_url =

Undocumented

_directory_permissions_mode =

Undocumented

_file_permissions_mode =

Undocumented

_location =

Undocumented

@cached_property
base_location =
overridden in django.contrib.staticfiles.storage.StaticFilesStorage

Undocumented

@cached_property
base_url =

Undocumented

@cached_property
directory_permissions_mode =

Undocumented

@cached_property
file_permissions_mode =

Undocumented

@cached_property
location =
overridden in django.contrib.staticfiles.storage.StaticFilesStorage

Undocumented