From d86c2257a69a8d6c650c0db470499463131a569f Mon Sep 17 00:00:00 2001 From: Nick Burns Date: Fri, 15 Aug 2025 13:47:46 -0700 Subject: [PATCH] gh-92936: update `http.cookies` docs post GH-113663 (#137566) MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit * 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 <10796600+picnixz@users.noreply.github.com> * Update Doc/whatsnew/3.15.rst Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com> * spelling, quote * demonstrate json * Update Doc/library/http.cookies.rst Co-authored-by: Senthil Kumaran * Apply suggestions from code review Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> * shorter description --------- Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com> Co-authored-by: Senthil Kumaran Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --- Doc/library/http.cookies.rst | 11 ++++++++++- Doc/whatsnew/3.15.rst | 7 +++++++ 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/Doc/library/http.cookies.rst b/Doc/library/http.cookies.rst index 46efc45c5e7d..9e7648ef6d83 100644 --- 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 index 6c5ab1bb1a10..252d8966b745 100644 --- 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 ---- -- 2.47.3