Introducere
Aspose.Email FOSS pentru Python (aspose-email-foss) este o bibliotecă Python licențiată MIT pentru lucrul cu fișiere Outlook MSG, mesaje RFC-5322 EML și structuri de stocare Compound File Binary (CFB). Biblioteca nu necesită extensii native și se instalează direct de la PyPI.
Biblioteca abordează o lacună comună în dezvoltarea Python: citirea și scrierea fișierelor Outlook .msg fără a necesita o instalare Outlook activă sau un SDK proprietar. De asemenea, expune formatul complet al containerului CFB care stă la baza fișierelor .msg, făcându-l potrivit pentru sarcini variind de la migrarea mesajelor la inspectarea stocării.
Biblioteca este livrată cu o interfață API tipizată care acoperă construcția mesajelor MAPI, gestionarea destinatarilor și a atașamentelor, serializarea proprietăților și ciclurile complete ale documentelor CFB.
Caracteristici cheie
Crearea și serializarea fișierelor MSG
MapiMessage.create() construiește un nou mesaj MAPI dintr-un subiect și un șir de corp. De acolo poți adăuga proprietăți tipizate, destinatari și atașamente binare, apoi să serializi rezultatul în octeți utilizând 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()
Citirea fișierelor MSG existente
MapiMessage.from_file() citește un fișier .msg existent de pe disc. De asemenea, poți reconstrui un mesaj din octeți brute prin transmiterea unui CFBReader prin MsgReader și 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")
Conversia între MAPI și RFC-5322 EML
MapiMessage.from_email_message() convertește un obiect standard Python email.message.EmailMessage într-un mesaj MAPI, păstrând subiectul, destinatarii, corpul și atașamentele. Conversia inversă folosește 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"])
Stocare Compound File Binary (CFB)
Biblioteca include un strat CFB independent (CFBReader, CFBWriter, CFBDocument, CFBStorage, CFBStream) pentru citirea și scrierea formatului Compound File Binary independent de MAPI. Acest lucru este util pentru inspectarea structurii brute de stocare a fișierelor .msg sau pentru construirea de containere personalizate de fișiere compuse.
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))
Acces la proprietățile MAPI
iter_properties() returnează toate proprietățile MAPI ale unui mesaj ca obiecte MapiProperty. Proprietățile numite (PidLidTag și PidNameTag) sunt accesibile prin MapiNamedProperty. MapiPropertyCollection oferă acces la proprietăți în stil dicționar.
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])
Începe rapid
pip install aspose-email-fossimport 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"])
Formate acceptate
| Format | Extensie | Citire | Scriere |
|---|---|---|---|
| Mesaj | .msg | ✓ | ✓ |
| CFB | .cfb | ✓ | ✓ |
| eml | .eml | ✓ | ✓ |
Fișierele MSG sunt citite prin MapiMessage.from_file() și MsgReader. EML este accesat prin podul de conversie from_email_message() / to_email_message(). Containerele CFB sunt gestionate direct de CFBReader și CFBWriter.
Open Source și licențiere
Aspose.Email FOSS pentru Python este lansat sub licența MIT. Codul sursă este disponibil pe GitHub și pachetul este distribuit prin PyPI sub numele aspose-email-foss. Licența MIT permite utilizarea în aplicații comerciale fără redevențe sau cerințe de atribuire, în afara includerii licenței.