API de armazenamento de arquivos.¶
Storage.exists(name)
¶
True
se um determinado arquivo já existe com name
.
Storage.path(name)
¶
O caminho do sistema de arquivos de onde o arquivo pode ser aberto usando a
função padrão do Python, open()
. Para sistemas de armazenamento que não
são acessíveis do sistema de arquivo local, esta função irá gerar um erro
NotImplementedError
.
Storage.size(name)
¶
Retorna o tamanho total, em bytes, do arquivo referenciado por name
.
Storage.url(name)
¶
Retorna a URL onde o conteúdo do arquivo referenciado por name
pode ser
acessado.
Storage.open(name, mode='rb')
¶
Abre o arquivo dado por name
. Note que apesar do arquivo retornado ser mesmo
um objeto File
, ele pode na verdade ser alguma subclasse. No caso de ser
um sistema de armazenamento remoto, isto significa que a leitura/escrita pode
ser lenta, então fique atento.
Storage.save(name, content)
¶
Salva um novo arquivo usando o sistema de armazenamento, preferencialmente com o
nome especificado. Se já existe um arquivo com este nome name
, o sistema
pode modificar o nome para ter um nome único. O nome real do arquivo armazenado
será retornado.
O argumento content
ponde ser uma instancia de
django.core.files.File
ou de uma subclasse de
File
.
Storage.delete(name)
¶
Deleta o arquivo referenciado por name
. Este método não irá lançar uma
exceção caso o arquivo não exista.