skip to navigation
skip to content

Not Logged In

django-s3direct 0.1.6

Add direct uploads to S3 functionality with a progress bar to file input fields within Django admin.

Latest Version: 0.3.11

django-s3direct
===============

Upload files direct to S3 from Django
-------------------------------------


Add direct uploads to AWS S3 functionality with a progress bar to file input fields within Django admin.

![screenshot]https://raw.github.com/bradleyg/django-s3direct/master/screenshot.png


## Installation

Install with Pip:

```pip install django-s3direct```

Currently only python 2.7 supported.

## S3 Setup

Setup a CORS policy on your S3 bucket.

```xml
<corsconfiguration>
<corsrule>
<allowedorigin>*</allowedorigin>
<allowedmethod>PUT</allowedmethod>
<allowedmethod>POST</allowedmethod>
<allowedmethod>GET</allowedmethod>
<maxageseconds>3000</maxageseconds>
<allowedheader>*</allowedheader>
</corsrule>
</corsconfiguration>
```

## Django Setup

### Settings.py

```python
INSTALLED_APPS = [
...
's3direct',
...
]

AWS_SECRET_ACCESS_KEY = ''
AWS_ACCESS_KEY_ID = ''
AWS_STORAGE_BUCKET_NAME = ''
S3DIRECT_ENDPOINT = '' # http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
S3DIRECT_DIR = 's3direct' # (optional, default is 's3direct', location within the bucket to upload files)
S3DIRECT_UNIQUE_RENAME = False # (optional, default is 'False', gives the uploaded file a unique filename)
```

### urls.py

```python
urlpatterns = patterns('',
url(r'^s3direct/', include('s3direct.urls')),
)
```

### models.py


```python
from django.db import models
from s3direct.fields import S3DirectField

class Example(models.Model):
thumbnail = S3DirectField(upload_to='s3direct')
# 'upload_to' is an optional argument
```

You may need to run `collectstatic` before `s3direct` will work correctly on your public website:

```bash
python manage.py collectstatic
````

[![Build Status]https://secure.travis-ci.org/bradleyg/django-s3direct.png]http://travis-ci.org/bradleyg/django-s3direct  
File Type Py Version Uploaded on Size
django-s3direct-0.1.6.macosx-10.9-intel.exe (md5) MS Windows installer any 2014-01-10 130KB
django-s3direct-0.1.6.tar.gz (md5) Source 2014-01-10 60KB
  • Downloads (All Versions):
  • 93 downloads in the last day
  • 655 downloads in the last week
  • 4722 downloads in the last month