Εισαγωγή
Aspose.Email FOSS για Python (aspose-email-foss) είναι μια βιβλιοθήκη Python αδειοδοτημένη υπό MIT για εργασία με αρχεία Outlook MSG, μηνύματα RFC-5322 EML, και δομές αποθήκευσης Compound File Binary (CFB). Η βιβλιοθήκη δεν απαιτεί εγγενείς επεκτάσεις και εγκαθίσταται απευθείας από PyPI.
Η βιβλιοθήκη καλύπτει ένα κοινό κενό ανάπτυξης Python: την ανάγνωση και εγγραφή αρχείων Outlook .msg χωρίς να απαιτείται εγκατάσταση του Outlook ή ιδιόκτητο SDK. Επίσης, εκθέτει τη πλήρη μορφή κοντέινερ CFB που υποκρύπτει τα αρχεία .msg, καθιστώντας την κατάλληλη για εργασίες που κυμαίνονται από τη μετεγκατάσταση μηνυμάτων έως την επιθεώρηση αποθήκευσης.
Η βιβλιοθήκη διανέμεται με μια τυποποιημένη επιφάνεια API που καλύπτει την κατασκευή μηνυμάτων MAPI, τη διαχείριση παραληπτών και συνημμένων, τη σειριοποίηση ιδιοτήτων και τις αναδρομές εγγράφων CFB.
Βασικά Χαρακτηριστικά
Δημιουργία και Σειριοποίηση Αρχείων MSG
MapiMessage.create() δημιουργεί ένα νέο μήνυμα MAPI από μια γραμμή θέματος και σώματος. Από εκεί μπορείτε να προσθέσετε τυποποιημένες ιδιότητες, παραλήπτες και δυαδικά συνημμένα, και στη συνέχεια να σειριοποιήσετε το αποτέλεσμα σε bytes χρησιμοποιώντας 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()
Ανάγνωση Υπάρχων Αρχείων MSG
MapiMessage.from_file() διαβάζει ένα υπάρχον αρχείο .msg από το δίσκο. Μπορείτε επίσης να επαναδημιουργήσετε ένα μήνυμα από ακατέργαστα bytes περνώντας ένα CFBReader μέσω MsgReader και 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")
Μετατροπή μεταξύ MAPI και RFC-5322 EML
MapiMessage.from_email_message() μετατρέπει ένα τυπικό αντικείμενο Python email.message.EmailMessage σε μήνυμα MAPI, διατηρώντας το θέμα, τους παραλήπτες, το σώμα και τα συνημμένα. Η αντίστροφη μετατροπή χρησιμοποιεί το 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"])
Αποθήκευση Compound File Binary (CFB)
Η βιβλιοθήκη περιλαμβάνει μια ανεξάρτητη στρώση CFB (CFBReader, CFBWriter, CFBDocument, CFBStorage, CFBStream) για ανάγνωση και εγγραφή της μορφής Compound File Binary ανεξάρτητα από το MAPI. Αυτό είναι χρήσιμο για την επιθεώρηση της ακατέργαστης δομής αποθήκευσης των αρχείων .msg ή για τη δημιουργία προσαρμοσμένων κοντέινερ compound file.
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))
Πρόσβαση σε Ιδιότητες MAPI
iter_properties() επιστρέφει όλες τις ιδιότητες MAPI σε ένα μήνυμα ως αντικείμενα MapiProperty. Οι ονομαστικές ιδιότητες (PidLidTag και PidNameTag) είναι προσβάσιμες μέσω MapiNamedProperty. Το MapiPropertyCollection παρέχει πρόσβαση ιδιοτήτων τύπου dict.
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])
Γρήγορη Έναρξη
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"])
Υποστηριζόμενες Μορφές
| Μορφή | Επέκταση | Ανάγνωση | Εγγραφή |
|---|---|---|---|
| Μήνυμα | .msg | ✓ | ✓ |
| CFB | .cfb | ✓ | ✓ |
| eml | .eml | ✓ | ✓ |
Τα αρχεία MSG διαβάζονται μέσω του MapiMessage.from_file() και του MsgReader. Το EML προσπελάζεται μέσω της γέφυρας μετατροπής from_email_message()/to_email_message(). Τα containers CFB διαχειρίζονται άμεσα από το CFBReader και το CFBWriter.
Ανοιχτός Κώδικας & Άδειες
Aspose.Email FOSS για Python κυκλοφορεί υπό την άδεια MIT. Ο κώδικας είναι διαθέσιμος στο GitHub και το πακέτο διανέμεται μέσω PyPI με το όνομα aspose-email-foss. Η άδεια MIT επιτρέπει τη χρήση σε εμπορικές εφαρμογές χωρίς δικαιώματα ή απαιτήσεις αποδείξεων πέραν της ένταξης της άδειας.