https://github.com/python/cpython/commit/24de6a4f29aba5efeb9340b5b33a04ae3a219fff
commit: 24de6a4f29aba5efeb9340b5b33a04ae3a219fff
branch: 3.15
author: Miss Islington (bot) <[email protected]>
committer: StanFromIreland <[email protected]>
date: 2026-10-18T10:53:24Z
summary:

[3.15] Add a security warning to the `mailbox` docs (GH-149295) (#159667)

(cherry picked from commit c5cbe312ca3272022378f11b15349d3ea4ff028e)

Co-authored-by: Stan Ulbrych <[email protected]>
Co-authored-by: R. David Murray <[email protected]>

files:
M Doc/library/mailbox.rst

diff --git a/Doc/library/mailbox.rst b/Doc/library/mailbox.rst
index 5b9741bdbcad19e..0399b55721c8345 100644
--- a/Doc/library/mailbox.rst
+++ b/Doc/library/mailbox.rst
@@ -15,6 +15,12 @@ accessing and manipulating on-disk mailboxes and the 
messages they contain.
 :class:`~email.message.Message` class with format-specific state and behavior.
 Supported mailbox formats are Maildir, mbox, MH, Babyl, and MMDF.
 
+.. warning::
+
+   The :mod:`!mailbox` module is designed for use in trusted environments,
+   where data from untrusted sources is never passed to the module's API
+   calls and only trusted users have access to the filesystems accessible
+   to the module.
 
 .. seealso::
 

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to