diff options
| author | Georges Toth <georges@trypill.org> | 2020-10-27 00:31:06 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-10-27 00:31:06 (GMT) |
| commit | 303aac8c56609290e122eecc14c038e9b1e4174a (patch) | |
| tree | 625fa73aa444a2c2ec59ec1bfebbc33108eafc82 /Doc/library/email.utils.rst | |
| parent | 8e3b9f92835654943bb59d9658bb52e1b0f40a22 (diff) | |
| download | cpython-303aac8c56609290e122eecc14c038e9b1e4174a.zip cpython-303aac8c56609290e122eecc14c038e9b1e4174a.tar.gz cpython-303aac8c56609290e122eecc14c038e9b1e4174a.tar.bz2 | |
bpo-30681: Support invalid date format or value in email Date header (GH-22090)
I am re-submitting an older PR which was abandoned but is still relevant, #10783 by @timb07.
The issue being solved () is still relevant. The original PR #10783 was closed as
the final request changes were not applied and since abandoned.
In this new PR I have re-used the original patch plus applied both comments from the review, by @maxking and @pganssle.
For reference, here is the original PR description:
In email.utils.parsedate_to_datetime(), a failure to parse the date, or invalid date components (such as hour outside 0..23) raises an exception. Document this behaviour, and add tests to test_email/test_utils.py to confirm this behaviour.
In email.headerregistry.DateHeader.parse(), check when parsedate_to_datetime() raises an exception and add a new defect InvalidDateDefect; preserve the invalid value as the string value of the header, but set the datetime attribute to None.
Add tests to test_email/test_headerregistry.py to confirm this behaviour; also added test to test_email/test_inversion.py to confirm emails with such defective date headers round trip successfully.
This pull request incorporates feedback gratefully received from @bitdancer, @brettcannon, @Mariatta and @warsaw, and replaces the earlier PR #2254.
Automerge-Triggered-By: GH:warsaw
Diffstat (limited to 'Doc/library/email.utils.rst')
| -rw-r--r-- | Doc/library/email.utils.rst | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/Doc/library/email.utils.rst b/Doc/library/email.utils.rst index 4d0e920..0e266b6 100644 --- a/Doc/library/email.utils.rst +++ b/Doc/library/email.utils.rst @@ -124,8 +124,10 @@ of the new API. .. function:: parsedate_to_datetime(date) The inverse of :func:`format_datetime`. Performs the same function as - :func:`parsedate`, but on success returns a :mod:`~datetime.datetime`. If - the input date has a timezone of ``-0000``, the ``datetime`` will be a naive + :func:`parsedate`, but on success returns a :mod:`~datetime.datetime`; + otherwise ``ValueError`` is raised if *date* contains an invalid value such + as an hour greater than 23 or a timezone offset not between -24 and 24 hours. + If the input date has a timezone of ``-0000``, the ``datetime`` will be a naive ``datetime``, and if the date is conforming to the RFCs it will represent a time in UTC but with no indication of the actual source timezone of the message the date comes from. If the input date has any other valid timezone |