[Python-checkins] bpo-11001: updated cookie docs (GH-13086)
Miss Islington (bot)
webhook-mailer at python.org
Tue May 7 13:05:27 EDT 2019
https://github.com/python/cpython/commit/91cc01f40eec03ece2d6b04ad9ea786e77707d8d
commit: 91cc01f40eec03ece2d6b04ad9ea786e77707d8d
branch: master
author: Julia Iliuk <julia.iluyk at gmail.com>
committer: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
date: 2019-05-07T10:05:20-07:00
summary:
bpo-11001: updated cookie docs (GH-13086)
Used **spookylukey**'s patch from 2011-01-24
https://bugs.python.org/issue11001
files:
M Doc/library/http.cookies.rst
diff --git a/Doc/library/http.cookies.rst b/Doc/library/http.cookies.rst
index f3457a0cdc7b..17792b200599 100644
--- a/Doc/library/http.cookies.rst
+++ b/Doc/library/http.cookies.rst
@@ -55,8 +55,9 @@ in Cookie name (as :attr:`~Morsel.key`).
.. class:: SimpleCookie([input])
This class derives from :class:`BaseCookie` and overrides :meth:`value_decode`
- and :meth:`value_encode` to be the identity and :func:`str` respectively.
-
+ and :meth:`value_encode`. SimpleCookie supports strings as cookie values.
+ When setting the value, SimpleCookie calls the builtin :func:`str()` to convert
+ the value to a string. Values received from HTTP are kept as strings.
.. seealso::
@@ -76,15 +77,16 @@ Cookie Objects
.. method:: BaseCookie.value_decode(val)
- Return a decoded value from a string representation. Return value can be any
- type. This method does nothing in :class:`BaseCookie` --- it exists so it can be
- overridden.
+ Return a tuple ``(real_value, coded_value)`` from a string representation.
+ ``real_value`` can be any type. This method does no decoding in
+ :class:`BaseCookie` --- it exists so it can be overridden.
.. method:: BaseCookie.value_encode(val)
- Return an encoded value. *val* can be any type, but return value must be a
- string. This method does nothing in :class:`BaseCookie` --- it exists so it can
+ Return a tuple ``(real_value, coded_value)``. *val* can be any type, but
+ ``coded_value`` will always be converted to a string.
+ This method does no encoding in :class:`BaseCookie` --- it exists so it can
be overridden.
In general, it should be the case that :meth:`value_encode` and
More information about the Python-checkins
mailing list