Введение
Aspose.Email FOSS for Python is a free, MIT-licensed library for creating, reading, and конвертирование файлов сообщений, совместимых с Outlook в чистом Python. Доступно на PyPI как aspose-email-foss, работает на Windows, macOS, Linux, Docker и безсерверных средах. без зависимости от Microsoft Office и без собственного времени выполнения.
Библиотека охватывает две основные области: высокоуровневый слой MAPI (MapiMessage) для работы с предметами сообщений, телами, получателями и приложениями; а также низкоуровневой структурной системой. слой (MsgReader, CFBReader, CFBStorage, CFBStream) , что подвергает воздействию сырое соединение. Файлы бинарные контейнеры, которые лежат в основе каждого файла. .msg Файл.
В этой статье рассматриваются ключевые функции, поставляемые в версии 26.3, основанные на подтвержденной поверхности API.
Основные особенности
Создание сообщений высокого уровня с помощью MapiMessage
MapiMessage является основной точкой входа для создания сообщений, совместимых с Outlook из Позвони. MapiMessage.create() с предметом и телом, добавить получателей и приложения, затем сохраняют непосредственно на .msg Файл.
from aspose.email_foss import msg
message = msg.MapiMessage.create(
"Quarterly status update",
"Hello team,\n\nPlease review the attached summary.\n\nRegards,\nEngineering",
)
message.set_property(msg.PropertyId.SENDER_NAME, "Build Agent")
message.set_property(msg.PropertyId.SENDER_EMAIL_ADDRESS, "agent@example.com")
message.add_recipient("alice@example.com", display_name="Alice Example")
message.add_recipient(
"carol@example.com",
display_name="Carol Example",
recipient_type=msg.RECIPIENT_TYPE_CC,
)
message.add_attachment("report.txt", b"Summary content here.\n", mime_type="text/plain")
message.save("output.msg")
Чтение и проверка файлов MSG
MsgReader обеспечивает структурированный доступ к существующему .msg файл без полной загрузки. в “А” MapiMessage.Он раскрывает записи о собственности верхнего уровня, хранилища получателей и приложениях, что делает его практичным для крупномасштабной проверки и трубопроводы по валидации.
from aspose.email_foss import msg
with msg.MsgReader.from_file("output.msg") as reader:
header = reader.top_level_header
print(f"Recipients : {header.recipient_count}")
print(f"Attachments: {header.attachment_count}")
for entry in reader.iter_recipient_storages():
_, props = reader.parse_subobject_property_stream(entry.stream_id)
print(f" Recipient storage {entry.name}: {len(props)} property entries")
MSG: загрузить, изменить и сохранить
Потому что… MapiMessage подпорки from_file() для погрузки и save() для записи, полный цикл read-modify-write требует всего нескольких строк. Названные свойства, вписанные enums и Управление строками Unicode доступно через: set_property, PropertyId, и MapiNamedProperty.
from aspose.email_foss import msg
with msg.MapiMessage.from_file("original.msg") as message:
message.set_property(msg.PropertyId.SUBJECT, "Updated Subject")
message.save("updated.msg")
EML / RFC 5322 Перевод
MapiMessage.to_email_message() преобразует загруженный MSG в стандартный Python. email.message.EmailMessage объект, позволяющий экспортировать в RFC 5322 .eml формат с использованием стандартной библиотеке.MapiMessage.from_email_message()) конструирует: а) в) MapiMessage от 1 января 2000 г. EmailMessage.
from pathlib import Path
from aspose.email_foss import msg
with msg.MapiMessage.from_file("message.msg") as message:
eml_bytes = message.to_email_bytes()
Path("message.eml").write_bytes(eml_bytes)
# Reverse: load EML into MapiMessage
import email
raw_eml = Path("message.eml").read_bytes()
email_obj = email.message_from_bytes(raw_eml)
mapi = msg.MapiMessage.from_email_message(email_obj)
mapi.save("from_eml.msg")
Проход контейнера CFB
Каждый . .msg файл - это контейнер с двусторонним (CFB) соединением. CFBReader предусматривает: доступ только для чтения к дереву каталогов, позволяя вам перечислить хранилища и потоки, ходить по иерархии, и извлечь сырой потока байтов без полагаться на MsgReader.
from aspose.email_foss.cfb import CFBReader
with CFBReader.from_file("message.msg") as reader:
print(f"CFB version : {reader.major_version}")
print(f"Sector size : {reader.sector_size}")
for depth, entry in reader.iter_tree():
indent = " " * depth
size = entry.stream_size if entry.is_stream() else "-"
print(f"{indent}{entry.name} [size={size}]")
Обработка прикрепления
Дополнительные документы добавляются через: MapiMessage.add_attachment() (для двоичных данных) или MapiMessage.add_embedded_message_attachment() (для вложенных сообщений MSG). принимать имя файла, необработанные байты и дополнительный тип MIME.
from aspose.email_foss import msg
message = msg.MapiMessage.create("Attachment demo", "See files below.")
message.add_attachment("data.csv", b"id,value\n1,100\n", mime_type="text/csv")
inner = msg.MapiMessage.create("Nested message", "This is embedded.")
message.add_embedded_message_attachment(inner, "nested.msg")
message.save("with_attachments.msg")
Быстрый старт .
pip install aspose-email-fossfrom aspose.email_foss import msg
# Create and save a minimal MSG
message = msg.MapiMessage.create("Hello World", "This is a test message.")
message.set_property(msg.PropertyId.SENDER_EMAIL_ADDRESS, "sender@example.com")
message.add_recipient("recipient@example.com", display_name="Recipient")
message.save("hello.msg")
# Load it back and convert to EML
with msg.MapiMessage.from_file("hello.msg") as loaded:
print(loaded.get_property_value(msg.PropertyId.SUBJECT))
eml = loaded.to_email_bytes()
open("hello.eml", "wb").write(eml)
Поддерживаемые форматы
| Формат: | Расширение | Читайте . | Написать . |
|---|---|---|---|
| Двойной файл соединения | .cfb | ✓ | ✓ |
| Сообщение Outlook | .msg | ✓ | ✓ |
| EML / RFC 5322 | .eml | ✓ | ✓ |
Открытый исходный код и лицензирование
Aspose.Email FOSS for Python is released under the MIT License. The source repository is доступна по адресу: github.com/aspose-email-foss (последнее изложение) и в Пакет опубликован на PyPI как: aspose-email-foss.Коммерческое использование, модификация и Перераспределение разрешено в соответствии с условиями MIT.
