Navigation

django-downloadview

Django-DownloadView provides generic views to make Django serve files.

It can serve files from models, storages, local filesystem, arbitrary URL... and even generated files.

For increased performances, it can delegate the actual streaming to a reverse proxy, via mechanisms such as Nginx’s X-Accel.

Example

In some urls.py, serve files managed in a model:

from django.conf.urls import url, url_patterns
from django_downloadview import ObjectDownloadView
from demoproject.download.models import Document  # A model with a FileField

# ObjectDownloadView inherits from django.views.generic.BaseDetailView.
download = ObjectDownloadView.as_view(model=Document, file_field='file')

url_patterns = ('',
    url('^download/(?P<slug>[A-Za-z0-9_-]+)/$', download, name='download'),
)

More examples in the demo project!

Views

Several views are provided to cover frequent use cases:

  • ObjectDownloadView to serve some file field of a model.
  • StorageDownloadView to serve files in a storage, without models.
  • PathDownloadView to serve files located on local filesystem, without storage.
  • HTTPDownloadView to proxy some arbitrary URL.
  • VirtualDownloadView to serve in-memory or generated files.

See Download views for details.

Then get increased performances with Optimizations.

Table Of Contents

Next topic

Demo project

This Page

Navigation

© Copyright 2012, Benoît Bryon. Created using Sphinx 1.1.3.