django-sticky-uploads 0.5.0

Enhanced file input widget for Django which uploads the file in the background and retains value on form errors.

django-sticky-uploads is a progressively enhanced file input widget for Django which uploads the file in the background and also retains value on form errors.

Requirements/Installing

django-sticky-uploads requires Python 2.7 or 3.4+. It also requires Django >= 1.8.

The easiest way to install django-sticky-uploads is using pip:

pip install django-sticky-uploads

Browser Support

This project makes use of progressive enhancement meaning that while all browsers are supported, they will not all have the same user-experience. If the browser does not support the necessary client-side features then it will fall back to the default file upload behavior.

The primary HTML5 dependencies are File API and XHR2 meaning that the following desktop/mobile browsers should get the enhanced experience:

• Chrome 13+

• Firefox 4+

• Internet Explorer 10+

• Safari 6+

• Opera 12+

• iOS Safari 6+

• Android Brower 3+

• Blackberry Broswer 10+

• Opera Mobile 12+

• Chrome for Android 27+

• Firefox for Android 22+

Documentation

Additional documentation on using django-sticky-uploads is available on Read The Docs.

Running the Tests

You can run the tests with via:

tox

(Possibly after installing tox with pip install tox or alternative.)

License

django-sticky-uploads is released under the BSD License. See the LICENSE file for more details.

A bundled version of jQuery 1.10.2 is included the source distribution which is used under its MIT license.

Contributing

If you think you’ve found a bug or are interested in contributing to this project check out django-sticky-uploads on Github.

Development sponsored by Caktus Consulting Group, LLC.