Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-06-18 07:32:45 +00:00
Code Issues Projects Releases Packages Wiki Activity

[3.14] gh-123138: Updated email.headerregistry docs to include required keyword parse_tree (GH-134450) (GH-150624)

Browse source 
(cherry picked from commit 2c20f9ce17)

Co-authored-by: Gustaf <79180496+gostak-dd@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2026-06-02 11:26:04 +02:00 • committed by GitHub
parent 68a35a9785
commit 8ee3bcf6d8
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 4 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

7
Doc/library/email.headerregistry.rst
View file

@ -96,9 +96,10 @@ headers.
``kwds`` is a dictionary containing one pre-initialized key, ``defects``.
``defects`` is an empty list. The parse method should append any detected
defects to this list. On return, the ``kwds`` dictionary *must* contain
values for at least the keys ``decoded`` and ``defects``. ``decoded``
should be the string value for the header (that is, the header value fully
decoded to unicode). The parse method should assume that *string* may
values for at least the keys ``decoded``, ``defects`` and ``parse_tree``.
``decoded`` should be the string value for the header (that is, the header
value fully decoded to unicode). ``parse_tree`` is set to the parse tree obtained
from parsing the header. The parse method should assume that *string* may
contain content-transfer-encoded parts, but should correctly handle all valid
unicode characters as well so that it can parse un-encoded header values.