Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-boto-0.3.3.tar.gz (6.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page