Usage

Basic usage

After setting up the storage using environment variables import the default_storage object from storages.provider module and use it as an interface for storing and retrieving your data.

fromstorages.providerimportdefault_storage

Writing data

default_storage.write(
name="example.txt",
content="Lorem ipsum dolor sit amet...",
mode="x",
)

Reading data

file_contents=default_storage.read(name="example.txt")

Deleting a resource

default_storage.delete(name="example.txt")

Check if a resource exists

ifdefault_storage.exists(name="example.txt"):
print("Hooray! The resource exists")

Check the size of a resource (in bytes)

size_in_bytes=default_storage.size(name="example.txt")
print(f"The file size is: {size_in_bytes} bytes")

Check the creation time

creation_datetime=default_storage.get_created_time(name="example.txt")

Check the last modification time

modification_datetime=default_storage.get_modified_time(name="example.txt")

Check the last access time

access_time=default_storage.get_access_time(name="example.txt")

Multiple storages

It is also possible to use many storages at the same time. In this case you should use the storages.StorageProvider class as a proxy to access the actual storage:

fromstorages.providerimportStorageProviderfile_system_stoarge=StorageProvider.provide(
backend_path="storages.backends.file_system.FileSystemStorage"
)
aws_s3_storage=StorageProvider.provide(
backend_path="storages.backends.amazon_s3.AmazonS3Storage"
)

And then you can use any of these storages the same way you'd use the default_storage.