mirror of
https://github.com/django/daphne.git
synced 2025-04-21 17:22:03 +03:00
Django Channels HTTP/WebSocket server
ee4aa9b292
* more consistent metrics More consistent metrics, in particular for consumers such as Graphite, CloudWatch etc. you don't want aggregated numbers per second, you want number since previous call. Since we don't want to track all the clients, total since start is the next best thing, because it can be easily calculated by the metrics consumer `count_since_last = pervious_count - current_count` * changing 'queue_depth' to 'messages_pending', also making 'messages' plurar for 'max_age' to keep it consitent |
||
|---|---|---|
| .github | ||
| channels | ||
| docs | ||
| loadtesting | ||
| testproject | ||
| .coveragerc | ||
| .gitignore | ||
| .travis.yml | ||
| CHANGELOG.txt | ||
| CONTRIBUTING.rst | ||
| LICENSE | ||
| Makefile | ||
| patchinator.py | ||
| README.rst | ||
| runtests.py | ||
| setup.cfg | ||
| setup.py | ||
| tox.ini | ||
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: https://channels.readthedocs.io/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
Channels loads into Django as a pluggable app to bring WebSocket, long-poll HTTP,
task offloading and other asynchrony support to your code, using familiar Django
design patterns and a flexible underlying framework that lets you not only
customize behaviours but also write support for your own protocols and needs.
This is still **beta** software: the API is mostly settled, but might change
a bit as things develop. Once we hit ``1.0``, it will be stablized and a
deprecation policy will come in.
Documentation, installation and getting started instructions are at
https://channels.readthedocs.io
Support can be obtained either here via issues, or in the ``#django-channels``
channel on Freenode.
You can install channels from PyPI as the ``channels`` package.
You'll likely also want to ``asgi_redis`` to provide the Redis channel layer.
See our `installation <https://channels.readthedocs.io/en/latest/installation.html>`_
and `getting started <https://channels.readthedocs.io/en/latest/getting-started.html>`_ docs for more.
Contributing
------------
To learn more about contributing, please `read our contributing docs <https://channels.readthedocs.io/en/latest/contributing.html>`_.
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 <https://channels.readthedocs.io/en/latest/contributing.html>`_
and get in touch!
Other Projects
--------------
The Channels project is made up of several packages; the others are:
* `Daphne <https://github.com/django/daphne/>`_, the HTTP and Websocket termination server
* `asgiref <https://github.com/django/asgiref/>`_, the base ASGI library/memory backend
* `asgi_redis <https://github.com/django/asgi_redis/>`_, the Redis channel backend
* `asgi_ipc <https://github.com/django/asgi_ipc/>`_, the POSIX IPC channel backend