mirror of
https://github.com/django/daphne.git
synced 2025-07-10 16:02:18 +03:00
Flesh out release notes
This commit is contained in:
parent
aa3af5031c
commit
ec0b124c6e
|
@ -1,11 +1,6 @@
|
||||||
Data Binding
|
Data Binding
|
||||||
============
|
============
|
||||||
|
|
||||||
.. warning::
|
|
||||||
|
|
||||||
Data Binding is new and might change slightly in the
|
|
||||||
upcoming weeks, and so don't consider this API totally stable yet.
|
|
||||||
|
|
||||||
The Channels data binding framework automates the process of tying Django
|
The Channels data binding framework automates the process of tying Django
|
||||||
models into frontend views, such as javascript-powered website UIs. It provides
|
models into frontend views, such as javascript-powered website UIs. It provides
|
||||||
a quick and flexible way to generate messages on Groups for model changes
|
a quick and flexible way to generate messages on Groups for model changes
|
||||||
|
|
|
@ -1,8 +1,18 @@
|
||||||
1.0.0 Release Notes
|
1.0.0 Release Notes
|
||||||
===================
|
===================
|
||||||
|
|
||||||
.. note::
|
.. contents:: Table of Contents
|
||||||
These release notes are in development. Channels 1.0.0 is not yet released.
|
:depth: 1
|
||||||
|
|
||||||
|
Channels 1.0.0 brings together a number of design changes, some breaking changes,
|
||||||
|
into our first fully stable release.
|
||||||
|
|
||||||
|
It was unfortunately not possible to make all of the changes backwards
|
||||||
|
compatible, though most code should not be too affected and the fixes are
|
||||||
|
generally quite easy.
|
||||||
|
|
||||||
|
You **must also update Daphne** to at least 1.0.0 to have this release of
|
||||||
|
Channels work correctly.
|
||||||
|
|
||||||
|
|
||||||
Major Features
|
Major Features
|
||||||
|
@ -19,6 +29,8 @@ while they send over a message on ``websocket.connect``, and your application
|
||||||
must either accept or reject the connection before the handshake is completed
|
must either accept or reject the connection before the handshake is completed
|
||||||
and messages can be received.
|
and messages can be received.
|
||||||
|
|
||||||
|
You **must** update Daphne to at least 1.0.0 to make this work correctly.
|
||||||
|
|
||||||
This has several advantages:
|
This has several advantages:
|
||||||
|
|
||||||
* You can now reject WebSockets before they even finish connecting, giving
|
* You can now reject WebSockets before they even finish connecting, giving
|
||||||
|
@ -99,6 +111,34 @@ wish to use it. It needs some extra initial setup and uses a database for
|
||||||
persistance; see :doc:`/delay` for more information.
|
persistance; see :doc:`/delay` for more information.
|
||||||
|
|
||||||
|
|
||||||
|
Minor Changes
|
||||||
|
-------------
|
||||||
|
|
||||||
|
* Serializers can now specify fields as ``__all__`` to auto-include all fields,
|
||||||
|
and ``exclude`` to remove certain unwanted fields.
|
||||||
|
|
||||||
|
* ``runserver`` respects ``FORCE_SCRIPT_NAME``
|
||||||
|
|
||||||
|
* Websockets can now be closed with a specific code by calling ``close(status=4000)``
|
||||||
|
|
||||||
|
* ``enforce_ordering`` no longer has a ``slight`` mode (because of the accept
|
||||||
|
flow changes), and is more efficient with session saving.
|
||||||
|
|
||||||
|
* ``runserver`` respects ``--nothreading`` and only launches one worker, takes
|
||||||
|
a ``--http-timeout`` option if you want to override it from the default ``60``,
|
||||||
|
|
||||||
|
* A new ``@channel_and_http_session`` decorator rehydrates the HTTP session out
|
||||||
|
of the channel session if you want to access it inside receive consumers.
|
||||||
|
|
||||||
|
* Streaming responses no longer have a chance of being cached.
|
||||||
|
|
||||||
|
* ``request.META['SERVER_PORT']`` is now always a string.
|
||||||
|
|
||||||
|
* ``http.disconnect`` now has a ``path`` key so you can route it.
|
||||||
|
|
||||||
|
* Test client now has a ``send_and_consume`` method.
|
||||||
|
|
||||||
|
|
||||||
Backwards Incompatible Changes
|
Backwards Incompatible Changes
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
||||||
|
@ -123,6 +163,8 @@ in the handshaking phase forever and you'll never get any messages.
|
||||||
All built-in Channels consumers (e.g. in the generic consumers) have been
|
All built-in Channels consumers (e.g. in the generic consumers) have been
|
||||||
upgraded to do this.
|
upgraded to do this.
|
||||||
|
|
||||||
|
You **must** update Daphne to at least 1.0.0 to make this work correctly.
|
||||||
|
|
||||||
|
|
||||||
Databinding group_names
|
Databinding group_names
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
Loading…
Reference in New Issue
Block a user