Wrapper of boto package for django
Project description
# Django-boto
Is an implementation of django integration with Amazon AWS (http://aws.amazon.com/) services through boto (https://github.com/boto/boto) module.
Installation
To install:
easy_install django-boto
or:
pip install django-boto
Configuration
DEFAULT_FILE_STORAGE
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
- AWS_ACCESS_KEY_ID
(required 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
(required for default file storage using) Secret Access Key from Security Credentials settings on AWS service. Required for using as default storage.
- AWS_ACL_POLICY
Default canned ACL for objects saved. Defaults to public-read.
- 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.
- AWS_S3_FORCE_HTTP_URL
Default to False. This settings allow you forcing S3 to return http links to files (if you have problem with SSL).
# Using
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) on storage instatiation:
from boto.s3.storage import S3Storage
- s3 = S3Storage(bucket=’another-bucket’, key=’another-key’,
secret=’another-secret’, location=’EU’)
S3Storage - it’s tipical Djago storage system_, only path is not implemented and created_time and accessed_time return same value as modified_time.
Upload shortcut
For simple uploading you can use shortcut:
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)
where:
- filename
string filesystem path to file or django File instance or python file object instance;
- name
string target django name for uploading file;
- 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.
- host
BOTO_S3_HOST replacement.
- expires
int How long should private links be valid for.
- query_auth
bool Should the url be generated with a valid signature? Required for private files.
- force_http
bool Should the generated url be http?
- policy
string Canned acl string for uploaded objects.
It’s return URL for direct file download.
Last nine 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.
Source Distributions
Built Distribution
Hashes for django_boto-0.3.6-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c0959945efe36e1eabdab3190a0769fdee0019eeb10219b703673cc1536a755e |
|
MD5 | 000895d44931998d6348055760e7f80f |
|
BLAKE2b-256 | 766037ec7ca835aaf9c727853db82dfc50da3403bf5dda871d23af4ffd0fec05 |