Skip to main content

Wrapper of boto package for django

Project description

# Django-boto


Is an implementation of Django integration with [Amazon AWS]( services through [boto]( module.

# Installation

To install:

easy_install django-boto


pip install django-boto

# Configuration


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 import S3Storage

s3 = S3Storage()

class Car(models.Model):

… photo = models.ImageField(storage=s3)

## Other 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


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).

# Usage

## 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 import S3Storage

s3 = S3Storage(bucket_name=’another-bucket’, key=’another-key’,

secret=’another-secret’, location=’EU’)

S3Storage is a typical [Django storage system](, 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 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;


AWS_ACCESS_KEY_ID replacement;




BOTO_S3_HOST replacement.


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 or defaults are used.

upload() returns a generated URL for a file download.

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.12.tar.gz (7.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page