DEPOT is a framework for easily storing and serving files in web applications on Python2.6+ and Python3.2+.
Installing DEPOT can be done from PyPi itself by installing the filedepot
distribution:
$ pip install filedepot
To start using Depot refer to Documentation
DEPOT was presented at PyConUK and PyConFR in 2014
Here is a simple example of using depot standalone to store files on MongoDB:
from depot.manager import DepotManager
# Configure a *default* depot to store files on MongoDB GridFS
DepotManager.configure('default', {
'depot.backend': 'depot.io.gridfs.GridFSStorage',
'depot.mongouri': 'mongodb://localhost/db'
})
depot = DepotManager.get()
# Save the file and get the fileid
fileid = depot.create(open('/tmp/file.png'))
# Get the file back
stored_file = depot.get(fileid)
print stored_file.filename
print stored_file.content_type
MemoryFileStorage
provides in memory storage for files. This is meant to provide a convenient way to speed up test suites and avoid fixture clean up issues.- S3Storage can now generate public urls for private files (expire in 1 year)
- Files created from plain bytes are now named "unnamed" instead of missing a filename.
S3Storage
now supports theprefix
option to store files in a subpath
- Storages now provide a
list
method to list files available on the store (This is not meant to be used to retrieve files uploaded by depot as it lists all the files). DepotExtension
for Ming is now properly documented
- It is now possible to use multiple
WithThumbnailFilter
to generate multiple thumbnails with different resolutions. - Better documentation for MongoDB
UploadedFileProperty
- Fixed a bug with Ming support when acessing
UploadedFileProperty
as a class property - Improved support for DEPOT inside TurboGears admin when using MongoDB
- Added
DepotManager.alias
to configure aliases to storage. This allows easy migration from one storage to another by switching where the alias points. - Now
UploadedFileField
permits to specifyupload_storage
to link a Model Column to a specific storage. - Added
policy
andencrypt_key
options to S3Storage to upload private and encrypted files.
- Added host option to S3Storage to allow using providers different from AWS.
- Added FileIntent to explicitly provide content_type and filename to uploaded content.
- Added Content-Disposition header with original filename in WSGI middleware
- Work-Around for issue with wsgi.file_wrapper provided by Waitress WSGI Server
- Official Support for AWS S3 on Python3