Docs: note inbound attachments doesn't include inlines

Closes #389
This commit is contained in:
Mike Edmunds
2024-08-07 12:30:09 -07:00
parent 13fa505257
commit 53dcc1e1b8

View File

@@ -242,6 +242,10 @@ Normalized inbound message
A `list` of all attachments to the message, or an empty list if there are
no attachments. See :ref:`inbound-attachments` below a description of the values.
Note that inline images (which appear intermixed with a message's body text)
are generally not included in :attr:`!attachments`. Use :attr:`inlines`
to access inline images.
If the inbound message includes an attached message, :attr:`!attachments`
will include the attached message and all of *its* attachments, recursively.
Consider Python's :meth:`~email.message.EmailMessage.iter_attachments` as an
@@ -249,8 +253,9 @@ Normalized inbound message
.. attribute:: inlines
A `list` of all inline content parts in the message, or an empty list if none.
See :ref:`inbound-attachments` below for a description of the values.
A `list` of all inline images (or other inline content) in the message,
or an empty list if none. See :ref:`inbound-attachments` below for
a description of the values.
Like :attr:`attachments`, this will recursively descend into any attached messages.