mirror of
				https://github.com/django/daphne.git
				synced 2025-11-01 00:07:26 +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