Metadata-Version: 2.0
Name: django-storages-s3upload
Version: 0.1.4
Summary: Direct (client-side) HTTP POST file upload to S3 using Django forms/views.
Home-page: https://github.com/mattaustin/django-storages-s3upload
Author: Matt Austin
Author-email: mail@mattaustin.me.uk
License: UNKNOWN
Keywords: s3,upload,post,django-storages,django
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: boto
Requires-Dist: django
Requires-Dist: django-storages
Requires-Dist: python-magic

========================
django-storages-s3upload
========================


Direct (client-side) HTTP POST file upload to S3 using Django forms/views.


This project is under development, and so should be used in production
environments with a high degree of caution.

Docs: http://django-storages-s3upload.readthedocs.org/


Please be *VERY* careful with security considerations, and check you know
exactly what is happening. S3 HTTP POST upload will overwrite existing files if
the key matches. You will want to limit uploads to trusted users, and use
unique key prefixes. You will want to make sure that any processing of uploaded
files is safe.

See also:
https://docs.djangoproject.com/en/dev/topics/security/#user-uploaded-content


Features
--------

* Create signed forms for client-side uploading of files directly in to Amazon
  S3 buckets using HTTP POST:
  http://docs.aws.amazon.com/AmazonS3/latest/dev/HTTPPOSTForms.html

* A view to handle/validate the returned parameters from the upload, and a hook
  to process the uploaded file.

* An extended form/view which uses dropzone.js for handling multiple uploads
  with thumbnails and progress bars.


Requirements
------------

You'll need to set-up & configure an Amazon S3 Boto storage backend using
``django-storages``:
http://django-storages.readthedocs.org/en/latest/backends/amazon-S3.html


Installation
------------

Install django-storages-s3upload by running:


.. code-block:: sh

    pip install django-storages-s3upload


Contribute
----------

* Issue Tracker: https://github.com/mattaustin/django-storages-s3upload/issues
* Source Code: https://github.com/mattaustin/django-storages-s3upload


License
-------

The project is licensed under the Apache license 2.0.


