Giới thiệu

Aspose.Email FOSS cho Python (aspose-email-foss) là một thư viện Python được cấp phép MIT để làm việc với các tệp Outlook MSG, các tin nhắn RFC-5322 EML, và cấu trúc lưu trữ Compound File Binary (CFB). Thư viện không yêu cầu phần mở rộng gốc và được cài đặt trực tiếp từ PyPI.

Thư viện giải quyết một khoảng trống phát triển Python phổ biến: đọc và ghi các tệp Outlook .msg mà không cần cài đặt Outlook đang chạy hoặc SDK độc quyền. Nó cũng tiết lộ định dạng container CFB đầy đủ mà các tệp .msg dựa trên, khiến nó phù hợp cho các nhiệm vụ từ di chuyển tin nhắn đến kiểm tra lưu trữ.

Thư viện đi kèm với một giao diện API đã được định kiểu, bao gồm việc xây dựng tin nhắn MAPI, quản lý người nhận và tệp đính kèm, tuần tự hóa thuộc tính, và vòng quay tài liệu CFB.


Các tính năng chính

Tạo và tuần tự hóa các tệp MSG

MapiMessage.create() tạo một tin nhắn MAPI mới từ tiêu đề và nội dung dạng chuỗi. Từ đó bạn có thể thêm các thuộc tính đã định kiểu, người nhận và tệp đính kèm nhị phân, sau đó tuần tự hóa kết quả thành byte bằng cách sử dụng 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()

Đọc các tệp MSG hiện có

MapiMessage.from_file() đọc một tệp .msg hiện có từ đĩa. Bạn cũng có thể tái tạo một tin nhắn từ các byte thô bằng cách truyền một CFBReader qua MsgReader và 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")

Chuyển đổi giữa MAPI và RFC-5322 EML

MapiMessage.from_email_message() chuyển đổi một đối tượng Python email.message.EmailMessage tiêu chuẩn thành tin nhắn MAPI, bảo toàn tiêu đề, người nhận, nội dung và tệp đính kèm. Việc chuyển đổi ngược lại sử dụng 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"])

Lưu trữ Compound File Binary (CFB)

Thư viện bao gồm một lớp CFB độc lập (CFBReader, CFBWriter, CFBDocument, CFBStorage, CFBStream) để đọc và ghi định dạng Compound File Binary một cách độc lập với MAPI. Điều này hữu ích cho việc kiểm tra cấu trúc lưu trữ thô của các tệp .msg hoặc để xây dựng các container tệp hợp chất tùy chỉnh.

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

Truy cập thuộc tính MAPI

iter_properties() trả về tất cả các thuộc tính MAPI trên một tin nhắn dưới dạng các đối tượng MapiProperty. Các thuộc tính có tên (PidLidTag và PidNameTag) có thể truy cập thông qua MapiNamedProperty. MapiPropertyCollection cung cấp cách truy cập thuộc tính kiểu dictionary.

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

Bắt đầu nhanh

pip install aspose-email-foss
import 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"])

Định dạng được hỗ trợ

Định dạngPhần mở rộngĐọcGhi
Tin nhắn.msg✓✓
CFB.cfb✓✓
eml.eml✓✓

Các tệp MSG được đọc thông qua MapiMessage.from_file() và MsgReader. EML được truy cập qua cầu chuyển đổi from_email_message() / to_email_message(). Các container CFB được xử lý trực tiếp bởi CFBReader và CFBWriter.


Mã nguồn mở & Giấy phép

Aspose.Email FOSS cho Python được phát hành theo Giấy phép MIT. Mã nguồn có sẵn trên GitHub và gói được phân phối qua PyPI với tên aspose-email-foss. Giấy phép MIT cho phép sử dụng trong các ứng dụng thương mại mà không có phí bản quyền hoặc yêu cầu ghi công ngoài việc bao gồm giấy phép.


Bắt đầu

Tài nguyên liên quan