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” documentation!

Views

Several views are provided to cover frequent use cases:

  • ObjectDownloadView when you have a model with a file field.
  • StorageDownloadView when you manage files in a storage.
  • PathDownloadView when you have an absolute filename on local filesystem.
  • HTTPDownloadView when you have an URL (the resource is proxied).
  • VirtualDownloadView when you the file is generated on the fly.

See “views” documentation for details.

See also “optimizations” documentation to get increased performances.

Table Of Contents

Next topic

Demo project

This Page

Navigation

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