Wrapper of boto package for django
Project description
Is an implemetation if django inegration with Amazon AWS (http://aws.amazon.com/) services trough boto (https://github.com/boto/boto) module.
Installation
To install:
easy_install django-boto
or:
pip install django-boto
Configuration
To set up as default file storage replace/create DEFAULT_FILE_STORAGE in project settings.py with django_boto.s3.storage.S3Storage:
DEFAULT_FILE_STORAGE = 'django_boto.s3.storage.S3Storage'
Other settings.py options
- AWS_ACCESS_KEY_ID
(rquired for default file storage using) Access Key ID from Security Credentials settings on AWS service. Required for using as default storage.
- AWS_SECRET_ACCESS_KEY
(rquired for default file storage using) Secret Access Key from Security Credentials settings on AWS service. Required for using as default storage.
- BOTO_S3_BUCKET
Amazon S3 bucket name. Default set to AWS_ACCESS_KEY_ID.
- BOTO_S3_HOST
Amazon S3 hostname. Default to s3.amazonaws.com.
- BOTO_BUCKET_LOCATION
Amazon datacenter location. Default to US Classic Region.
Using
Default Django file storage
If set as default file storage - check for right set DEFAULT_FILE_STORAGE, AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY in project settings.py.
Manual S3Storage using
If need to using manually - you can direct set bucket_name (as BOTO_S3_BUCKET), key (as AWS_ACCESS_KEY_ID), secret (as AWS_SECRET_ACCESS_KEY) and location (as BOTO_BUCKET_LOCATION) as keyword arguments on storage instatiation:
from boto.s3.storage import S3Storage s3 = S3Storage(key='another-key', secret='another-secret', bucket='another-bucket', location='EU')
S3Storage - it’s tipical Djago storage system, only path, created_time and accessed_time is not implemented.
Upload shortcut
For simple uploading you can use shortcut:
from django_boto.s3 import upload upload(filename, prefix=False, bucket_name=False, key=None, secret=None)
where:
- filename
string filsystem path to file or django File instance or python `file object instance;
- prefix
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;
- bucket_name
name of bucket (if not exists - system try to create it) in amazon S3;
- key
AWS_ACCESS_KEY_ID replacement;
- secret
AWS_SECRET_ACCESS_KEY replacement.
It’s retun URL for direct file download.
Last four options are optional. If not set - it takes from settings.py or used defaults.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.