Introduktion
Aspose.Email FOSS for Python is now available on PyPI: a free, MIT-licensed library for creating, reading, and converting Outlook .msg filer helt i Python, utan beroende av Microsoft Office eller någon inbyggd filändelse. Installera det med pip install aspose-email-foss>=26.3 och börja arbeta med MSG- och CFB-behållare omedelbart.
Biblioteket riktar sig mot Python 3.10 och senare. Det implementerar Compound File Binary (CFB)-formatet och MSG‑meddelandeformatet från grunden, vilket ger dig deterministisk kontroll över hur e‑postmeddelanden serialiseras och läses. Eftersom implementationen är ren Python kör den identiskt på Windows, macOS, Linux och i containeriserade miljöer.
Aspose.Email FOSS is designed for developers building email processing pipelines, compliance archival tools, forensic analysis workflows, or any application that needs to create or inspect Outlook-compatible message files without a running Exchange or Outlook installation.
Viktiga funktioner
Skapa MSG‑filer
Bygg Outlook-kompatibla .msg filer från grunden med MapiMessage.create(). Ställ in standard MAPI-egenskaper som ämne, avsändare, leveranstid och visningsfält via PropertyId enum. Lägg till mottagare med add_recipient() och filbilagor med add_attachment(), spara sedan resultatet till disk.
from aspose.email_foss import msg
message = msg.MapiMessage.create(
"Quarterly status update and rollout plan",
"Hello team,\n\nPlease find the latest rollout summary attached.\n\nRegards,\nEngineering",
)
message.set_property(msg.PropertyId.SENDER_NAME, "Build Agent")
message.set_property(msg.PropertyId.SENDER_EMAIL_ADDRESS, "build.agent@example.com")
message.set_property(msg.PropertyId.INTERNET_MESSAGE_ID, "<example-001@example.com>")
message.add_recipient("alice@example.com", display_name="Alice Example")
message.add_recipient("bob@example.com", display_name="Bob Example")
message.add_recipient(
"carol@example.com",
display_name="Carol Example",
recipient_type=msg.RECIPIENT_TYPE_CC,
)
message.add_attachment("hello.txt", b"sample attachment\n", mime_type="text/plain")
message.save("example-message.msg")
Läs och konvertera MSG till EML
Läs in en befintlig .msg fil med MapiMessage.from_file() och konvertera den till ett standard Python EmailMessage objekt via to_email_message(). Därifrån serialiseras till EML-bytes för lagring eller vidarebefordran via SMTP.
from aspose.email_foss import msg
with msg.MapiMessage.from_file("example-message.msg") as loaded:
email_message = loaded.to_email_message()
eml_bytes = email_message.as_bytes()
with open("example-message.eml", "wb") as f:
f.write(eml_bytes)
Inspektera MSG‑internals
Använd MsgReader och dess underliggande CFBReader för att inspektera den binära strukturen i en MSG-fil. Åtkomst till CFB-metadata (version, sektorstorlek, antal katalogposter) och iterera över MAPI-egenskapsposter på binär nivå.
from aspose.email_foss import msg
reader = msg.MsgReader.from_file("example-message.msg")
cfb = reader.cfb_reader
print(f"CFB major_version={cfb.major_version}")
print(f"sector_size={cfb.sector_size}")
print(f"directory_entries={cfb.directory_entry_count}")
for entry in reader.iter_top_level_fixed_length_properties():
tag = entry.property_tag
print(f"tag=0x{tag:08X} flags=0x{entry.flags:08X} value={entry.value.hex()}")
reader.close()
Lågnivå‑CFB‑åtkomst
Läs och gå igenom någon Compound File Binary-behållare med CFBReader. Enumerera lagringar och strömmar, lös upp sökvägar efter namn, och extrahera rå strömdatan för anpassad bearbetning.
from aspose.email_foss.cfb import CFBReader
reader = CFBReader.from_file("example-message.msg")
for entry in reader.iter_storages():
print(f"Storage: {entry.name}")
for entry in reader.iter_streams():
data = reader.get_stream_data(entry.stream_id)
print(f"Stream: {entry.name} size={len(data)}")
reader.close()
Snabbstart
Installera biblioteket och skapa din första MSG-fil på under tio rader:
pip install aspose-email-foss>=26.3
from aspose.email_foss import msg
message = msg.MapiMessage.create("Hello from Python", "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")
with msg.MapiMessage.from_file("hello.msg") as loaded:
eml = loaded.to_email_message()
print(eml["Subject"])
Stödda format
| Format | Importera | Exportera |
|---|---|---|
| MSG | Ja | Ja |
| CFB | Ja | Ja |
Öppen källkod & licensiering
Aspose.Email FOSS for Python is released under the MIT License. Du kan använda den i personliga, interna och kommersiella projekt utan restriktioner. Källkoden finns tillgänglig på GitHub.
