Introduction

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.Він розкриває записи про власність верхнього рівня, зберігання одержувачів та прикріплений зберігання окремо, що робить його практичним для великої інспекції файлів і трубопровідники для валідації.

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")

```python
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")

Повернення та повернення: завантажити, змінити і зберегти.

Because MapiMessage підставки from_file() для завантаження та save() для написання, повний Цикл читання-зміни-запису вимагає лише декількох рядків. Названі властивості, вписані енуми та Упрацювання струнних кодів в Unicode доступно через: set_property, PropertyId, і MapiNamedProperty.

with msg.MapiMessage.from_file(“original.msg”) as message: message.set_property(msg.PropertyId.SUBJECT, “Updated Subject”) message.save(“updated.msg”)

```python
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 січня 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

Every .msg файл є контейнером Compound File Binary (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.

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”)

---

```python
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-foss

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)

---

```bash
pip install aspose-email-foss>=26.3

from 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)

Підтримувані формати

Відкритий код та ліцензія

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.

Починати з

• Починати з
• Посібник розробника
• Статті Бази знань
• Довідник API

Пов’язані ресурси

• Aspose.Email — Enterprise Blog