Django provides convenient ways to access the default storage class:
\nA dictionary-like object that allows retrieving a storage instance using\nits alias as defined by STORAGES.
storages has an attribute backends, which defaults to the raw value\nprovided in STORAGES.
Additionally, storages provides a create_storage() method that\naccepts the dictionary used in STORAGES for a backend, and\nreturns a storage instance based on that backend definition. This may be\nuseful for third-party packages needing to instantiate storages in tests:
>>> from django.core.files.storage import storages\n>>> storages.backends\n{'default': {'BACKEND': 'django.core.files.storage.FileSystemStorage'},\n 'staticfiles': {'BACKEND': 'django.contrib.staticfiles.storage.StaticFilesStorage'},\n 'custom': {'BACKEND': 'package.storage.CustomStorage'}}\n>>> storage_instance = storages.create_storage({"BACKEND": "package.storage.CustomStorage"})\nDefaultStorage provides\nlazy access to the default storage system as defined by default key in\nSTORAGES. DefaultStorage uses\nstorages internally.
default_storage is an instance of the\nDefaultStorage.
FileSystemStorage classLink para este cabeçalho#The FileSystemStorage class implements\nbasic file storage on a local filesystem. It inherits from\nStorage and provides implementations\nfor all the public methods thereof.
Absolute path to the directory that will hold the files.\nDefaults to the value of your MEDIA_ROOT setting.
URL that serves the files stored at this location.\nDefaults to the value of your MEDIA_URL setting.
The file system permissions that the file will receive when it is\nsaved. Defaults to FILE_UPLOAD_PERMISSIONS.
The file system permissions that the directory will receive when it is\nsaved. Defaults to FILE_UPLOAD_DIRECTORY_PERMISSIONS.
Flag to control allowing saving a new file over an existing one.\nDefaults to False.
Returns a datetime of the system’s ctime, i.e.\nos.path.getctime(). On some systems (like Unix), this is the\ntime of the last metadata change, and on others (like Windows), it’s\nthe creation time of the file.
InMemoryStorage classLink para este cabeçalho#The InMemoryStorage class implements\na memory-based file storage. It has no persistence, but can be useful for\nspeeding up tests by avoiding disk access.
Absolute path to the directory name assigned to files. Defaults to the\nvalue of your MEDIA_ROOT setting.
URL that serves the files stored at this location.\nDefaults to the value of your MEDIA_URL setting.
The file system permissions assigned to files, provided for\ncompatibility with FileSystemStorage. Defaults to\nFILE_UPLOAD_PERMISSIONS.
The file system permissions assigned to directories, provided for\ncompatibility with FileSystemStorage. Defaults to\nFILE_UPLOAD_DIRECTORY_PERMISSIONS.
Storage classLink para este cabeçalho#The Storage class provides a\nstandardized API for storing files, along with a set of default\nbehaviors that all other storage systems can inherit or override\nas necessary.
Deletes the file referenced by name. If deletion is not supported\non the target storage system this will raise NotImplementedError\ninstead.
Returns True if a file referenced by the given name already exists\nin the storage system.
Returns a datetime of the last accessed time of the\nfile. For storage systems unable to return the last accessed time this\nwill raise NotImplementedError.
If USE_TZ is True, returns an aware datetime,\notherwise returns a naive datetime in the local timezone.
Returns an alternative filename based on the file_root and\nfile_ext parameters, an underscore plus a random 7 character\nalphanumeric string is appended to the filename before the extension.
Returns a filename based on the name parameter that’s free and\navailable for new content to be written to on the target storage\nsystem.
The length of the filename will not exceed max_length, if provided.\nIf a free unique filename cannot be found, a\nSuspiciousFileOperation exception will be raised.
If a file with name already exists, get_alternative_name() is\ncalled to obtain an alternative name.
Returns a datetime of the creation time of the file.\nFor storage systems unable to return the creation time this will raise\nNotImplementedError.
If USE_TZ is True, returns an aware datetime,\notherwise returns a naive datetime in the local timezone.
Returns a datetime of the last modified time of the\nfile. For storage systems unable to return the last modified time this\nwill raise NotImplementedError.
If USE_TZ is True, returns an aware datetime,\notherwise returns a naive datetime in the local timezone.
Returns a filename based on the name parameter that’s suitable\nfor use on the target storage system.
Validates the filename by calling get_valid_name() and\nreturns a filename to be passed to the save() method.
The filename argument may include a path as returned by\nFileField.upload_to.\nIn that case, the path won’t be passed to get_valid_name() but\nwill be prepended back to the resulting name.
The default implementation uses os.path operations. Override\nthis method if that’s not appropriate for your storage.
Lists the contents of the specified path, returning a 2-tuple of lists;\nthe first item being directories, the second item being files. For\nstorage systems that aren’t able to provide such a listing, this will\nraise a NotImplementedError instead.
Opens the file given by name. Note that although the returned file\nis guaranteed to be a File object, it might actually be some\nsubclass. In the case of remote file storage this means that\nreading/writing could be quite slow, so be warned.
The local filesystem path where the file can be opened using Python’s\nstandard open(). For storage systems that aren’t accessible from\nthe local filesystem, this will raise NotImplementedError instead.
Saves a new file using the storage system, preferably with the name\nspecified. If there already exists a file with this name name, the\nstorage system may modify the filename as necessary to get a unique\nname. The actual name of the stored file will be returned.
The max_length argument is passed along to\nget_available_name().
The content argument must be an instance of\ndjango.core.files.File or a file-like object that can be\nwrapped in File.
Returns the total size, in bytes, of the file referenced by name.\nFor storage systems that aren’t able to return the file size this will\nraise NotImplementedError instead.
Returns the URL where the contents of the file referenced by name\ncan be accessed. For storage systems that don’t support access by URL\nthis will raise NotImplementedError instead.