Introduction
Aspose.Email FOSS pour Python (aspose-email-foss) est une bibliothèque Python sous licence MIT permettant de travailler avec les fichiers Outlook MSG, les messages RFC-5322 EML et les structures de stockage Compound File Binary (CFB). La bibliothèque ne nécessite aucune extension native et s’installe directement depuis PyPI.
La bibliothèque comble une lacune courante de développement Python : lire et écrire des fichiers Outlook .msg sans nécessiter d’installation d’Outlook en cours d’exécution ou de SDK propriétaire. Elle expose également le format complet du conteneur CFB qui sous-tend les fichiers .msg, ce qui la rend adaptée à des tâches allant de la migration de messages à l’inspection du stockage.
La bibliothèque est fournie avec une interface API typée couvrant la construction de messages MAPI, la gestion des destinataires et des pièces jointes, la sérialisation des propriétés et les allers-retours de documents CFB.
Fonctionnalités clés
Création et sérialisation de fichiers MSG
MapiMessage.create() crée un nouveau message MAPI à partir d’une chaîne contenant le sujet et le corps. À partir de là, vous pouvez ajouter des propriétés typées, des destinataires et des pièces jointes binaires, puis sérialiser le résultat en octets à l’aide de 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()
Lecture des fichiers MSG existants
MapiMessage.from_file() lit un fichier .msg existant sur le disque. Vous pouvez également reconstruire un message à partir d’octets bruts en passant un CFBReader à travers MsgReader et 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")
Conversion entre MAPI et RFC-5322 EML
MapiMessage.from_email_message() convertit un objet Python email.message.EmailMessage standard en message MAPI, en préservant le sujet, les destinataires, le corps et les pièces jointes. La conversion inverse utilise 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"])
Stockage Compound File Binary (CFB)
La bibliothèque inclut une couche CFB autonome (CFBReader, CFBWriter, CFBDocument, CFBStorage, CFBStream) pour lire et écrire le format Compound File Binary de manière indépendante de MAPI. Cela est utile pour inspecter la structure de stockage brute des fichiers .msg ou pour créer des conteneurs de fichiers compound personnalisés.
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))
Accès aux propriétés MAPI
iter_properties() renvoie toutes les propriétés MAPI d’un message sous forme d’objets MapiProperty. Les propriétés nommées (PidLidTag et PidNameTag) sont accessibles via MapiNamedProperty. MapiPropertyCollection fournit un accès aux propriétés de type dictionnaire.
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])
Démarrage rapide
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"])
Formats pris en charge
| Format | Extension | Lire | Écrire |
|---|---|---|---|
| Msg | .msg | ✓ | ✓ |
| CFB | .cfb | ✓ | ✓ |
| eml | .eml | ✓ | ✓ |
Les fichiers MSG sont lus via MapiMessage.from_file() et MsgReader. EML est accessible via le pont de conversion from_email_message()/to_email_message(). Les conteneurs CFB sont gérés directement par CFBReader et CFBWriter.
Open Source & Licence
Aspose.Email FOSS pour Python est publié sous la licence MIT. Le code source est disponible sur GitHub et le paquet est distribué via PyPI sous le nom aspose-email-foss. La licence MIT autorise l’utilisation dans des applications commerciales sans redevance ni exigence d’attribution au-delà de l’inclusion de la licence.