mirror of
https://github.com/jazzband/django-downloadview.git
synced 2026-03-16 22:40:25 +00:00
a4cc84d758
As per [their blog post of the 27th April](https://blog.readthedocs.com/securing-subdomains/) ‘Securing subdomains’: > Starting today, Read the Docs will start hosting projects from subdomains on the domain readthedocs.io, instead of on readthedocs.org. This change addresses some security concerns around site cookies while hosting user generated data on the same domain as our dashboard. Test Plan: Manually visited all the links I’ve modified.
50 lines
1.5 KiB
ReStructuredText
50 lines
1.5 KiB
ReStructuredText
###################
|
|
django-downloadview
|
|
###################
|
|
|
|
`django-downloadview` makes it easy to serve files with `Django`_:
|
|
|
|
* you manage files with Django (permissions, filters, generation, ...);
|
|
|
|
* files are stored somewhere or generated somehow (local filesystem, remote
|
|
storage, memory...);
|
|
|
|
* `django-downloadview` helps you stream the files with very little code;
|
|
|
|
* `django-downloadview` helps you improve performances with reverse proxies,
|
|
via mechanisms such as Nginx's X-Accel or Apache's X-Sendfile.
|
|
|
|
|
|
*******
|
|
Example
|
|
*******
|
|
|
|
Let's serve a file stored in a file field of some model:
|
|
|
|
.. code:: python
|
|
|
|
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'),
|
|
)
|
|
|
|
|
|
*********
|
|
Resources
|
|
*********
|
|
|
|
* Documentation: https://django-downloadview.readthedocs.io
|
|
* PyPI page: http://pypi.python.org/pypi/django-downloadview
|
|
* Code repository: https://github.com/benoitbryon/django-downloadview
|
|
* Bugtracker: https://github.com/benoitbryon/django-downloadview/issues
|
|
* Continuous integration: https://travis-ci.org/benoitbryon/django-downloadview
|
|
* Roadmap: https://github.com/benoitbryon/django-downloadview/milestones
|
|
|
|
|
|
.. _`Django`: https://djangoproject.com
|