Bevezetés
Aspose.Email FOSS for Python is a free, MIT-licensed library for creating, reading, and Outlook-kompatibilis üzenetfájlok Pythonban történő átalakítása. PyPI-n elérhető, mint: aspose-email-foss, működik Windows, macOS, Linux, Docker és szerver nélküli környezetekben. nem függ a Microsoft Office-tól, és nincs saját futási idő.
A könyvtár két fő területet foglal magában: a magas szintű MAPI réteg (MapiMessage) munkavégzésre. A szöveget a következőkben kell megadni: réteg (MsgReader, CFBReader, CFBStorage, CFBStream) amely a nyersanyagot kiaknázza. A fájl bináris tartályok, amelyek alátámasztják minden .msg - Az aktát.
Ez a cikk az 26.3 verzióban elérhető kulcsfontosságú funkciókat mutatja be, amelyek a megerősített API felületre épülnek.
Fő jellemzői
Magas szintű üzenet létrehozása a MapiMessage-val
MapiMessage az Outlook-kompatibilis üzenetek létrehozásának elsődleges belépési pontja a Hívj! MapiMessage.create() a címzetteket és az adatszolgáltatókat. A következőkben a fentiek az alábbiak szerint kerülnek elhelyezésre: .msg - Az aktát.
from aspose.email_foss import msg
message = msg.MapiMessage.create(
"Quarterly status update",
"Hello team,\n\nPlease review the attached summary.\n\nRegards,\nEngineering",
)
message.set_property(msg.PropertyId.SENDER_NAME, "Build Agent")
message.set_property(msg.PropertyId.SENDER_EMAIL_ADDRESS, "agent@example.com")
message.add_recipient("alice@example.com", display_name="Alice Example")
message.add_recipient(
"carol@example.com",
display_name="Carol Example",
recipient_type=msg.RECIPIENT_TYPE_CC,
)
message.add_attachment("report.txt", b"Summary content here.\n", mime_type="text/plain")
message.save("output.msg")
Az MSG fájlok olvasása és ellenőrzése
MsgReader A program a jelenlegi és az új technológiákhoz strukturált hozzáférést biztosít. .msg fájl, anélkül hogy teljesen betöltötték volna. egy MapiMessage.A felderítés a legmagasabb szintű ingatlanok, az átvevő tárolóhelyek és a… A szerkezetátalakítási és fejlesztési rendszerekhez kapcsolódó, a rendszerben található elemek esetében az alábbiak alkalmazandók: a hitelesítési csővezetékek.
from aspose.email_foss import msg
with msg.MsgReader.from_file("output.msg") as reader:
header = reader.top_level_header
print(f"Recipients : {header.recipient_count}")
print(f"Attachments: {header.attachment_count}")
for entry in reader.iter_recipient_storages():
_, props = reader.parse_subobject_property_stream(entry.stream_id)
print(f" Recipient storage {entry.name}: {len(props)} property entries")
MSG-megtérítés: töltse fel, módosítsa és mentse meg
Mert… MapiMessage támaszkodó from_file() a rakodásra és save() a betűzéshez, egy teljes a read-modify-write ciklus csak néhány sorot igényel. A megnevezett tulajdonságok, az írott enumok és Unicode szalagkezelés elérhető a set_property, PropertyId,és a következők: MapiNamedProperty.
from aspose.email_foss import msg
with msg.MapiMessage.from_file("original.msg") as message:
message.set_property(msg.PropertyId.SUBJECT, "Updated Subject")
message.save("updated.msg")
EML / RFC 5322 Átalakítás
MapiMessage.to_email_message() egy töltött MSG-t szabványos Pythonra alakítja át. email.message.EmailMessage objektum, amely lehetővé teszi az RFC 5322 exportját .eml formátum használata A standard könyvtár, a fordított irány (MapiMessage.from_email_message()) konstrukciói a) A MapiMessage a következők: EmailMessage.
from pathlib import Path
from aspose.email_foss import msg
with msg.MapiMessage.from_file("message.msg") as message:
eml_bytes = message.to_email_bytes()
Path("message.eml").write_bytes(eml_bytes)
# Reverse: load EML into MapiMessage
import email
raw_eml = Path("message.eml").read_bytes()
email_obj = email.message_from_bytes(raw_eml)
mapi = msg.MapiMessage.from_email_message(email_obj)
mapi.save("from_eml.msg")
CFB konténer áthaladás
Minden egyes .msg A fájl egy összetett bináris (CFB) tároló. CFBReader előirányzik: Az olvasható hozzáférés a címtárak, lehetővé teszi listát tároló és folyó, sétál az hierarchiát, és kivonja a nyers áramlások bájtjai nélkül támaszkodva az MsgReader.
from aspose.email_foss.cfb import CFBReader
with CFBReader.from_file("message.msg") as reader:
print(f"CFB version : {reader.major_version}")
print(f"Sector size : {reader.sector_size}")
for depth, entry in reader.iter_tree():
indent = " " * depth
size = entry.stream_size if entry.is_stream() else "-"
print(f"{indent}{entry.name} [size={size}]")
A rögzítés kezelése
A mellékletek a következő formában kerülnek hozzáadásra: MapiMessage.add_attachment() (bináris adatok esetében) vagy MapiMessage.add_embedded_message_attachment() (az összefonódott MSG üzenetek esetében). elfogad egy fájlnevet, nyers bájtokat és opcionális MIME-típust.
from aspose.email_foss import msg
message = msg.MapiMessage.create("Attachment demo", "See files below.")
message.add_attachment("data.csv", b"id,value\n1,100\n", mime_type="text/csv")
inner = msg.MapiMessage.create("Nested message", "This is embedded.")
message.add_embedded_message_attachment(inner, "nested.msg")
message.save("with_attachments.msg")
Gyors kezdés
pip install aspose-email-fossfrom aspose.email_foss import msg
# Create and save a minimal MSG
message = msg.MapiMessage.create("Hello World", "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")
# Load it back and convert to EML
with msg.MapiMessage.from_file("hello.msg") as loaded:
print(loaded.get_property_value(msg.PropertyId.SUBJECT))
eml = loaded.to_email_bytes()
open("hello.eml", "wb").write(eml)
Támogatott formátumok
| Formátum | A Bizottság | Olvasd! | Írj! |
|---|---|---|---|
| Bináris összetett fájl | .cfb | ✓ | ✓ |
| Outlook üzenet | .msg | ✓ | ✓ |
| EML / RFC 5322 | .eml | ✓ | ✓ |
Nyitott forráskódú és licenckészítés
Aspose.Email FOSS for Python is released under the MIT License. The source repository is A következőkben találhatók: Github.com/aspose-email-foss és a A csomagot a PyPI-n úgy teszik közzé, hogy: aspose-email-foss.Kereskedelmi felhasználás, módosítás és Az újbóli elosztás mind megengedett az MIT feltételei szerint.
