gh-92936: update http.cookies docs post GH-113663 (#137566)

nburns · picnixz · orsenthil · web-flow · commit d86c2257a69a · 2025-08-15T13:47:46.000-07:00
* add versionchanged and example with quotes in cookie value

* update whatsnew with http.cookies change

* Update Doc/library/http.cookies.rst

Co-authored-by: Bénédikt Tran &lt;10796600+picnixz@users.noreply.github.com&gt;

* Update Doc/whatsnew/3.15.rst

Co-authored-by: Bénédikt Tran &lt;10796600+picnixz@users.noreply.github.com&gt;

* spelling, quote

* demonstrate json

* Update Doc/library/http.cookies.rst

Co-authored-by: Senthil Kumaran &lt;senthil@python.org&gt;

* Apply suggestions from code review

Co-authored-by: Adam Turner &lt;9087854+AA-Turner@users.noreply.github.com&gt;

* shorter description

---------

Co-authored-by: Bénédikt Tran &lt;10796600+picnixz@users.noreply.github.com&gt;
Co-authored-by: Senthil Kumaran &lt;senthil@python.org&gt;
Co-authored-by: Adam Turner &lt;9087854+AA-Turner@users.noreply.github.com&gt;
diff --git a/Doc/library/http.cookies.rst b/Doc/library/http.cookies.rst
@@ -28,8 +28,10 @@ The character set, :data:`string.ascii_letters`, :data:`string.digits` and
 in a cookie name (as :attr:`~Morsel.key`).
 
 .. versionchanged:: 3.3
-   Allowed ':' as a valid cookie name character.
+   Allowed '``:``' as a valid cookie name character.
 
+.. versionchanged:: next
+   Allowed '``"``' as a valid cookie value character.
 
 .. note::
 
@@ -314,3 +316,10 @@ The following example demonstrates how to use the :mod:`http.cookies` module.
    >>> print(C)
    Set-Cookie: number=7
    Set-Cookie: string=seven
+   >>> import json
+   >>> C = cookies.SimpleCookie()
+   >>> C.load(f'cookies=7; mixins="{json.dumps({"chips": "dark chocolate"})}"; state=gooey')
+   >>> print(C)
+   Set-Cookie: cookies=7
+   Set-Cookie: mixins="{"chips": "dark chocolate"}"
+   Set-Cookie: state=gooey
diff --git a/Doc/whatsnew/3.15.rst b/Doc/whatsnew/3.15.rst
@@ -267,6 +267,13 @@ http.client
   (Contributed by Alexander Enrique Urieles Nieto in :gh:`131724`.)
 
 
+http.cookies
+------------
+
+* Allow '``"``' double quotes in cookie values.
+  (Contributed by Nick Burns and Senthil Kumaran in :gh:`92936`.)
+
+
 math
 ----
 
