https://github.com/python/cpython/commit/c5cbe312ca3272022378f11b15349d3ea4ff028e
commit: c5cbe312ca3272022378f11b15349d3ea4ff028e
branch: main
author: Stan Ulbrych <[email protected]>
committer: StanFromIreland <[email protected]>
date: 2026-10-18T11:44:24+01:00
summary:

Add a security warning to the `mailbox` docs (#149295)

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