Clarified ambigious section of lifespan["state"] spec

techntools · Mar 4, 2023 · 627e29b · 627e29b
1 parent ec63b10
commit 627e29b
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 6 deletions.
diff --git a/specs/lifespan.rst b/specs/lifespan.rst
@@ -59,12 +59,6 @@ lifespan protocol. If you want to log an error that occurs during lifespan
 startup and prevent the server from starting, then send back
 ``lifespan.startup.failed`` instead.
 
-The ``extensions["lifespan.state"]`` dict is an empty namespace.
-Applications can store arbitrary data in this namespace.
-A *shallow copy* of this dictionary will get passed into each request handler.
-This key will only be set if the server supports this extension.
-
-
 Lifespan State
 --------------
 

diff --git a/specs/www.rst b/specs/www.rst
@@ -312,6 +312,10 @@ metadata (mostly from the HTTP request line and headers):
 * ``subprotocols`` (*Iterable[Unicode string]*) -- Subprotocols the
   client advertised. Optional; if missing defaults to empty list.
 
+* ``state`` Optional(*dict[Unicode string, Any]*) -- A copy of the
+  namespace passed into the lifespan corresponding to this request. (See :doc:`lifespan`).
+  Optional; if missing the server does not support this feature.
+
 
 Connect - ``receive`` event
 '''''''''''''''''''''''''''