Introduktion
Aspose.Email FOSS for Python is now available on PyPI: a free, MIT-licensed library for creating, reading, and converting Outlook .msg filer udelukkende i Python, uden afhængighed af Microsoft Office eller nogen native udvidelse. Installér det med pip install aspose-email-foss>=26.3 og begynd straks at arbejde med MSG- og CFB-beholdere.
Biblioteket har som mål Python 3.10 og senere. Det implementerer Compound File Binary (CFB)-formatet og MSG-beskedformatet fra bunden, hvilket giver dig deterministisk kontrol over, hvordan e‑mailbeskeder serialiseres og læses. Da implementeringen er ren Python, kører den identisk på Windows, macOS, Linux og i containeriserede 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.
Vigtige funktioner
Opret MSG‑filer
Byg Outlook-kompatible .msg filer fra bunden ved hjælp af MapiMessage.create(). Indstil standard MAPI-egenskaber som emne, afsender, leveringstid og visningsfelter via PropertyId enum. Tilføj modtagere med add_recipient() og filvedhæftninger med add_attachment(), og gem derefter resultatet til 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 og konverter MSG til EML
Indlæs en eksisterende .msg fil med MapiMessage.from_file() og konvertér den til en standard Python EmailMessage objekt via to_email_message(). Derfra kan du serialisere til EML-bytes til lagring eller videresendelse 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)
Inspicér MSG‑interne
Brug MsgReader og dens underliggende CFBReader til at inspicere den binære struktur af en MSG-fil. Få adgang til CFB-metadata (version, sektorstørrelse, antal mappeindgange) og iterér over MAPI-egenskabsindgange på binært niveau.
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()
Lavniveau CFB‑adgang
Læs og gennemse enhver Compound File Binary-container ved hjælp af CFBReader. Enumerér lagre og strømme, opløs stier efter navn, og udtræk rå strømdata til brugerdefineret behandling.
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()
Hurtig start
Installer biblioteket og opret din første MSG‑fil på under ti linjer:
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"])
Understøttede formater
| Format | Importér | Eksport |
|---|---|---|
| MSG | Ja | Ja |
| CFB | Ja | Ja |
Open source & licensiering
Aspose.Email FOSS for Python is released under the MIT License. Du må bruge den i personlige, interne og kommercielle projekter uden begrænsning. Kildekoden er tilgængelig på GitHub.
