Вступ
Aspose.Email FOSS для Python (aspose-email-foss) — це бібліотека Python під ліцензією MIT для роботи з файлами Outlook MSG, RFC-5322 EML-повідомленнями та структурами сховища Compound File Binary (CFB). Бібліотека не потребує нативних розширень і встановлюється безпосередньо з PyPI.
Бібліотека усуває поширений прогалину у розробці Python: читання та запис файлів Outlook .msg без необхідності встановленого Outlook або пропрієтарного SDK. Вона також відкриває повний формат контейнера CFB, який лежить в основі файлів .msg, що робить її придатною для завдань від міграції повідомлень до інспекції сховища.
Бібліотека постачається з типізованим інтерфейсом API, який охоплює створення MAPI-повідомлень, управління одержувачами та вкладеннями, серіалізацію властивостей та кругові проходи документів CFB.
Ключові особливості
Створення та серіалізація MSG-файлів
MapiMessage.create() створює нове MAPI-повідомлення з рядків теми та тіла. Далі ви можете додати типізовані властивості, одержувачів та бінарні вкладення, а потім серіалізувати результат у байти за допомогою to_bytes().
import datetime
from aspose.email_foss.msg.mapi_message import MapiMessage, PropertyId
message = MapiMessage.create("Quarterly Report", "Please review the attached report.")
message.set_property(PropertyId.SENDER_NAME, "Alice")
message.set_property(PropertyId.SENDER_EMAIL_ADDRESS, "alice@example.com")
message.set_property(
PropertyId.MESSAGE_DELIVERY_TIME,
datetime.datetime(2026, 3, 15, 10, 30, tzinfo=datetime.timezone.utc),
)
message.add_recipient("bob@example.com", display_name="Bob")
message.add_attachment("report.pdf", b"%PDF-1.4 ...", mime_type="application/pdf")
raw_bytes = message.to_bytes()
Читання існуючих файлів MSG
MapiMessage.from_file() читає існуючий файл .msg з диска. Ви також можете відновити повідомлення з необроблених байтів, передаючи CFBReader через MsgReader та MsgDocument.
from aspose.email_foss.msg.mapi_message import MapiMessage
from aspose.email_foss.msg.reader import MsgReader, MsgDocument
from aspose.email_foss.cfb.reader import CFBReader
# Read from file path
msg = MapiMessage.from_file("message.msg")
print(msg.subject)
# Or reconstruct from bytes
msg2 = MapiMessage.from_msg_document(
MsgDocument.from_reader(MsgReader(CFBReader(raw_bytes)))
)
print(msg2.subject)
for att in msg2.attachments:
print(att.filename, len(att.data), "bytes")
Перетворення між MAPI та RFC-5322 EML
MapiMessage.from_email_message() перетворює стандартний об’єкт Python email.message.EmailMessage у повідомлення MAPI, зберігаючи тему, отримувачів, тіло та вкладення. Зворотне перетворення використовує to_email_message().
from email.message import EmailMessage
from aspose.email_foss.msg.mapi_message import MapiMessage
# Build a standard Python email
eml = EmailMessage()
eml["Subject"] = "Meeting notes"
eml["From"] = "alice@example.com"
eml["To"] = "bob@example.com"
eml.set_content("Notes from today's meeting.")
# Convert to MAPI and serialize as .msg
mapi = MapiMessage.from_email_message(eml)
with open("meeting-notes.msg", "wb") as f:
f.write(mapi.to_bytes())
# Round-trip back to EML
recovered = mapi.to_email_message()
print(recovered["Subject"])
Зберігання Compound File Binary (CFB)
Бібліотека містить окремий шар CFB (CFBReader, CFBWriter, CFBDocument, CFBStorage, CFBStream) для читання та запису формату Compound File Binary незалежно від MAPI. Це корисно для перегляду необробленої структури сховища файлів .msg або для створення власних контейнерів складних файлів.
from aspose.email_foss.cfb.writer import CFBWriter, CFBDocument, CFBStorage, CFBStream
from aspose.email_foss.cfb.reader import CFBReader
# Build a CFB document with nested storage
root = CFBStorage("Root Entry")
root.add_stream(CFBStream("Metadata", b"meta-payload"))
nested = root.add_storage(CFBStorage("Attachments"))
nested.add_stream(CFBStream("Attachment1", b"binary-content"))
doc = CFBDocument(root=root, major_version=3)
data = CFBWriter.to_bytes(doc)
# Read it back
reader = CFBReader(data)
entry = reader.resolve_path(["Attachments", "Attachment1"])
print(reader.get_stream_data(entry.stream_id))
Доступ до властивостей MAPI
iter_properties() повертає всі властивості MAPI у повідомленні у вигляді об’єктів MapiProperty. Іменовані властивості (PidLidTag та PidNameTag) доступні через MapiNamedProperty. MapiPropertyCollection забезпечує доступ до властивостей у вигляді словника.
from aspose.email_foss.msg.mapi_message import MapiMessage
msg = MapiMessage.from_file("message.msg")
for prop in msg.iter_properties():
print(hex(prop.property_id), prop.property_type, repr(prop.value)[:60])
Швидкий старт
pip install aspose-email-fossimport datetime
from aspose.email_foss.msg.mapi_message import MapiMessage, PropertyId
from aspose.email_foss.msg.reader import MsgReader, MsgDocument
from aspose.email_foss.cfb.reader import CFBReader
# Create a message
message = MapiMessage.create("Hello", "This is the body.")
message.set_property(PropertyId.SENDER_NAME, "Sender")
message.set_property(PropertyId.SENDER_EMAIL_ADDRESS, "sender@example.com")
message.add_recipient("recipient@example.com", display_name="Recipient")
message.add_attachment("note.txt", b"attachment content", mime_type="text/plain")
# Serialize and reload
raw = message.to_bytes()
reloaded = MapiMessage.from_msg_document(
MsgDocument.from_reader(MsgReader(CFBReader(raw)))
)
email = reloaded.to_email_message()
print("Subject:", email["Subject"])
print("From:", email["From"])
Підтримувані формати
| Формат | Розширення | Читати | Запис |
|---|---|---|---|
| Повідомлення | .msg | ✓ | ✓ |
| CFB | .cfb | ✓ | ✓ |
| eml | .eml | ✓ | ✓ |
Файли MSG читаються за допомогою MapiMessage.from_file() та MsgReader. EML доступний через from_email_message() / to_email_message() конверсійний міст. CFB-контейнери обробляються безпосередньо CFBReader та CFBWriter.
Відкритий код та ліцензування
Aspose.Email FOSS для Python випущено під ліцензією MIT. Джерело доступне на GitHub, а пакет розповсюджується через PyPI під назвою aspose-email-foss. Ліцензія MIT дозволяє використання у комерційних застосунках без роялті та вимог щодо атрибуції, окрім включення ліцензії.