Django Fine Uploader

.. image:: https://img.shields.io/pypi/v/django-fine-uploader.svg :target: https://pypi.python.org/pypi/django-fine-uploader

.. image:: https://img.shields.io/pypi/l/django-fine-uploader.svg :target: https://pypi.python.org/pypi/django-fine-uploader

.. image:: https://img.shields.io/pypi/wheel/django-fine-uploader.svg :target: https://pypi.python.org/pypi/django-fine-uploader

Simple, Chunked and Concurrent uploads with Django_ + Fine Uploader_

.. _Django: https://www.djangoproject.com .. _Fine Uploader: http://fineuploader.com

This is an alpha version.

We have a example_ project. Just git clone the django-fine-uploader repository and follow the instructions.

.. _example: https://github.com/douglasmiranda/django-fine-uploader/tree/master/example

Quickstart

Install django_fine_uploader::

pip install django-fine-uploader

Add it to your INSTALLED_APPS:

.. code-block:: python

INSTALLED_APPS = (
    ...
    'django_fine_uploader',
    ...
)

Add django_fine_uploader's URL patterns:

.. code-block:: python

urlpatterns = [
    ...
    url(r'^fine-uploader/', include('django_fine_uploader.urls', namespace='django_fine_uploader')),
    ...
]

And finally your html file: copy from this gist_. (too much html to put on our README)

.. _this gist: https://gist.github.com/douglasmiranda/77da9c801e0cf83357ba51a639372768

Features

• Simple Upload
• Chunked Upload
• Concurrent Chunked Upload
• Ready to use upload endpoint_
• Easy extend FineUploaderView_ (FormView)
• Or create your custom view and use the Django Fine Uploader handler

.. _Ready to use upload endpoint: https://github.com/douglasmiranda/django-fine-uploader/blob/master/django_fine_uploader/fineuploader.py .. _Easy extend FineUploaderView: https://github.com/douglasmiranda/django-fine-uploader/blob/master/django_fine_uploader/views.py

• Widget provided for overriding the FileField

Settings

If you would like to use the Fineuploader in FileField you could create the forms.FileField and set the widget=FineUploaderWidget. It also supports some attrs for extra settings. Currently it support the following settings.

.. code-block:: python

widget=FineUploaderWidget(attrs={
  'admin': True # To show the widget in Admin panel.
  'itemLimit': 2 # Set the item limit in the FineUploader.
})

TODO

Instead of listing here, check the issues_ and projects_.

.. _issues: https://github.com/douglasmiranda/django-fine-uploader/issues .. _projects: https://github.com/douglasmiranda/django-fine-uploader/projects

Running Tests

Does the code actually work?

::

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

OR

::

make test

Credits

Tools used in rendering this package:

• Cookiecutter_
• cookiecutter-djangopackage_

.. _Cookiecutter: https://github.com/audreyr/cookiecutter .. _cookiecutter-djangopackage: https://github.com/pydanny/cookiecutter-djangopackage

Fineuploader: http://fineuploader.com