Wrapper of boto package for django
pip install django-boto
Can’t be used as default file storage system because of path not implemented but you still can pass S3Storage object as storage option to a FileField:
from django.db import models from django_boto.s3.storage import S3Storage
s3 = S3Storage()
- class Car(models.Model):
… photo = models.ImageField(storage=s3)
## Other settings.py options
(required for default file storage use) Access Key ID from Security Credentials settings on AWS service. Required for using as default storage.
(required for default file storage use) Secret Access Key from Security Credentials settings on AWS service. Required for using as default storage.
Default canned ACL for objects saved. Defaults to public-read.
Amazon S3 bucket name. Default set to AWS_ACCESS_KEY_ID.
Amazon S3 hostname. Default to s3.amazonaws.com.
Amazon datacenter location. Default to US Classic Region.
Default to False. This settings allow you forcing S3 to return http links to files (if you have problem with SSL).
## Manual S3Storage usage
If you need to use it manually - you can pass bucket_name (as BOTO_S3_BUCKET), key (as AWS_ACCESS_KEY_ID), secret (as AWS_SECRET_ACCESS_KEY) and location (as BOTO_BUCKET_LOCATION) directly to storage constructor:
from django_boto.s3.storage import S3Storage
- s3 = S3Storage(bucket_name=’another-bucket’, key=’another-key’,
S3Storage is a typical [Django storage system](http://readthedocs.org/docs/django/en/1.4/ref/files/storage.html#the-storage-class), only path is not implemented and created_time and accessed_time return same value as modified_time.
## Upload shortcut
You can use a shortcut for simple uploads:
from django_boto.s3 import upload
- upload(filename, name=None, prefix=False, bucket_name=False, key=None,
secret=None, host=None, expires=0, query_auth=False, force_http=True, policy=None)
string filesystem path to file or django File instance or python file object instance;
string target Django’s name for uploading the file;
string path prefix to filename in s3.amazonaws.com url. Like filename /images/image.jpg with avatars prefix convert to avatars/image.jpg in amazon url;
name of bucket (if not exists - system try to create it) in amazon S3;
int How long should private links be valid for.
bool Should the url be generated with a valid signature? Required for private files.
bool Should the generated url be http?
string Canned acl string for uploaded objects.
Last nine options are optional. If not set - it’s taken from the settings.py or defaults are used.
upload() returns a generated URL for a file download.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.