Giriş

Aspose.Email FOSS for Python (aspose-email-foss) MIT lisanslı bir Python kütüphanesidir ve Outlook MSG dosyaları, RFC-5322 EML mesajları ve Compound File Binary (CFB) depolama yapılarıyla çalışmak için kullanılır. Kütüphane herhangi bir yerel uzantı gerektirmez ve doğrudan PyPI üzerinden kurulur.

Kütüphane, yaygın bir Python geliştirme boşluğunu giderir: Outlook .msg dosyalarını, çalışan bir Outlook kurulumuna veya tescilli bir SDK’ya ihtiyaç duymadan okuma ve yazma. Ayrıca .msg dosyalarının temelini oluşturan tam CFB konteyner formatını ortaya çıkarır, bu da mesaj göçünden depolama denetimine kadar çeşitli görevler için uygun olmasını sağlar.

Kütüphane, MAPI mesaj oluşturma, alıcı ve ek yönetimi, özellik serileştirme ve CFB belge dönüşümleri kapsayan tiplenmiş bir API ara yüzüyle birlikte gelir.


Ana Özellikler

MSG Dosyaları Oluşturma ve Serileştirme

MapiMessage.create(), bir konu ve gövde dizesinden yeni bir MAPI mesajı oluşturur. Buradan tiplenmiş özellikler, alıcılar ve ikili ekler ekleyebilir, ardından sonucu to_bytes() kullanarak baytlara serileştirebilirsiniz.

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

Mevcut MSG Dosyalarını Okuma

MapiMessage.from_file() diskten mevcut bir .msg dosyasını okur. Ayrıca ham baytlardan bir mesajı, bir CFBReader‘yi MsgReader ve MsgDocument aracılığıyla geçirerek yeniden oluşturabilirsiniz.

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 ve RFC-5322 EML Arasında Dönüştürme

MapiMessage.from_email_message(), standart bir Python email.message.EmailMessage nesnesini bir MAPI mesajına dönüştürür, konu, alıcılar, gövde ve ekleri korur. Ters dönüşüm to_email_message() kullanır.

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

Kütüphane, MAPI’den bağımsız olarak Compound File Binary formatını okuma ve yazma için bağımsız bir CFB katmanı (CFBReader, CFBWriter, CFBDocument, CFBStorage, CFBStream) içerir. Bu, .msg dosyalarının ham depolama yapısını incelemek veya özel bileşik dosya kapsayıcıları oluşturmak için faydalıdır.

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 Özellik Erişimi

iter_properties(), bir mesajdaki tüm MAPI özelliklerini MapiProperty nesneleri olarak döndürür. Adlandırılmış özellikler (PidLidTag ve PidNameTag) MapiNamedProperty aracılığıyla erişilebilir. MapiPropertyCollection, sözlük benzeri özellik erişimi sağlar.

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

Hızlı Başlangıç

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

Desteklenen Biçimler

BiçimUzantıOkuYaz
Mesaj.msg✓✓
CFB.cfb✓✓
eml.eml✓✓

MSG dosyaları MapiMessage.from_file() ve MsgReader aracılığıyla okunur. EML, from_email_message() / to_email_message() dönüşüm köprüsü üzerinden erişilir. CFB kapsayıcıları doğrudan CFBReader ve CFBWriter tarafından işlenir.


Açık Kaynak & Lisanslama

Aspose.Email FOSS, Python için MIT Lisansı altında yayınlanmıştır. Kaynak GitHub üzerinde mevcuttur ve paket PyPI aracılığıyla aspose-email-foss adıyla dağıtılmaktadır. MIT lisansı, lisansın eklenmesi dışında telif hakkı veya atıf gereksinimi olmadan ticari uygulamalarda kullanılmasına izin verir.


Başlarken

İlgili Kaynaklar