daphne/README.rst
2016-09-09 13:29:12 +01:00

59 lines
2.1 KiB
ReStructuredText

Django Channels
===============
.. image:: https://api.travis-ci.org/django/channels.svg
:target: https://travis-ci.org/django/channels
.. image:: https://readthedocs.org/projects/channels/badge/?version=latest
:target: http://channels.readthedocs.org/en/latest/?badge=latest
.. image:: https://img.shields.io/pypi/v/channels.svg
:target: https://pypi.python.org/pypi/channels
.. image:: https://img.shields.io/pypi/l/channels.svg
:target: https://pypi.python.org/pypi/channels
*(Note: Recent versions of Channels also need recent versions of Daphne,
asgi_redis and asgiref, so make sure you update all at once)*
This is a work-in-progress code branch of Django implemented as a third-party
app, which aims to bring some asynchrony to Django and expand the options
for code beyond the request-response model, in particular enabling WebSocket,
HTTP2 push, and background task support.
This is still **beta** software: the API is mostly settled, but might change
a bit as things develop.
Documentation, installation and getting started instructions are at
http://channels.readthedocs.org
Support can be obtained either here via issues, or in the ``#django-channels``
channel on Freenode.
You can also install channels from PyPI as the ``channels`` package.
You'll likely also want ``asgi_redis`` to provide the Redis channel layer.
Maintenance and Security
------------------------
To report security issues, please contact security@djangoproject.com. For GPG
signatures and more security process information, see
https://docs.djangoproject.com/en/dev/internals/security/.
To report bugs or request new features, please open a new GitHub issue. For
larger discussions, please post to the
`django-developers mailing list <https://groups.google.com/d/forum/django-developers>`_.
Django Core Shepherd: Andrew Godwin <andrew@aeracode.org>
Maintenance team:
* Andrew Godwin <andrew@aeracode.org>
* Steven Davidson
* Jeremy Spencer
If you are interested in joining the maintenance team, please
`read more about contributing <http://channels.readthedocs.io/en/latest/contributing.html>`_
and get in touch!