Exact

Exact Union RegExp

Dan Lenski 60181f4ed0 gh-67022: Document bytes/str inconsistency in email.header.decode_header() and suggest email.headerregistry.HeaderRegistry as a sane alternative (#92900) ... * gh-67022: Document bytes/str inconsistency in email.header.decode_header() This function's possible return types have been surprising and error-prone for the entirety of its Python 3.x history. It can return either: 1. `typing.List[typing.Tuple[bytes, typing.Optional[str]]]` of length >1 2. or `typing.List[typing.Tuple[str, None]]`, of length exactly 1 This means that any user of this function must be prepared to accept either `bytes` or `str` for the first member of the 2-tuples it returns, which is a very surprising behavior in Python 3.x, particularly given that the second member of the tuple is supposed to represent the charset/encoding of the first member. This patch documents the behavior of this function, and adds test cases to demonstrate it. As discussed in bpo-22833, this cannot be changed in a backwards-compatible way, and some users of this function depend precisely on the existing behavior. Add warnings about obsolescence of 'email.header.decode_header' and 'email.header.make_header' functions. Recommend use of `email.headerregistry.HeaderRegistry` instead, as suggested in https://github.com/python/cpython/pull/92900#discussion_r1112472177		2025-06-15 15:29:38 -04:00
..
data
__init__.py
__main__.py
test__encoded_words.py
test__header_value_parser.py	gh-134155: fix AttributeError in email._header_value_parser.get_address (#134194)	2025-06-05 13:28:11 -04:00
test_asian_codecs.py
test_contentmanager.py	gh-71339: Use new assertion methods in the email tests (GH-129055)	2025-04-14 09:25:58 +03:00
test_defect_handling.py	gh-71339: Use new assertion methods in the email tests (GH-129055)	2025-04-14 09:25:58 +03:00
test_email.py	gh-67022: Document bytes/str inconsistency in email.header.decode_header() and suggest email.headerregistry.HeaderRegistry as a sane alternative (#92900)	2025-06-15 15:29:38 -04:00
test_generator.py
test_headerregistry.py	gh-98188: Fix EmailMessage.get_payload to decode data when CTE value has extra text (#127547)	2025-01-05 20:32:16 -05:00
test_inversion.py
test_message.py	gh-127794: Validate email header names according to RFC 5322 (#127820)	2025-03-30 12:29:29 +00:00
test_parser.py
test_pickleable.py
test_policy.py
test_utils.py	gh-118761: Add test_lazy_import for more modules (#133057)	2025-05-05 22:46:05 +00:00
torture_test.py