مقدمة

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

تخزين ملف مركب ثنائي (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-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"])

الصيغ المدعومة

تنسيقامتدادقراءةكتابة
رسالة.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 بالاستخدام في التطبيقات التجارية دون رسوم ملكية أو متطلبات إسناد بخلاف تضمين الرخصة.


البدء

الموارد ذات الصلة