Introducción
Aspose.Email FOSS para Python (aspose-email-foss) es una biblioteca Python bajo licencia MIT para trabajar con archivos Outlook MSG, mensajes RFC-5322 EML y estructuras de almacenamiento Compound File Binary (CFB). La biblioteca no requiere extensiones nativas y se instala directamente desde PyPI.
La biblioteca aborda una brecha común de desarrollo de Python: leer y escribir archivos Outlook .msg sin requerir una instalación de Outlook en ejecución o un SDK propietario. También expone el formato completo del contenedor CFB que subyace a los archivos .msg, lo que la hace adecuada para tareas que van desde la migración de mensajes hasta la inspección de almacenamiento.
La biblioteca se distribuye con una interfaz tipada de API que cubre la construcción de mensajes MAPI, la gestión de destinatarios y adjuntos, la serialización de propiedades y los recorridos de documentos CFB.
Características clave
Creación y serialización de archivos MSG
MapiMessage.create() crea un nuevo mensaje MAPI a partir de una cadena de asunto y cuerpo. A partir de ahí, puedes añadir propiedades tipadas, destinatarios y adjuntos binarios, y luego serializar el resultado a bytes usando 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()
Lectura de archivos MSG existentes
MapiMessage.from_file() lee un archivo .msg existente desde el disco. También puedes reconstruir un mensaje a partir de bytes sin procesar pasando un CFBReader a través de MsgReader y 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")
Conversión entre MAPI y RFC-5322 EML
MapiMessage.from_email_message() convierte un objeto email.message.EmailMessage Python estándar en un mensaje MAPI, conservando el asunto, los destinatarios, el cuerpo y los archivos adjuntos. La conversión inversa utiliza 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"])
Almacenamiento Compound File Binary (CFB)
La biblioteca incluye una capa CFB independiente (CFBReader, CFBWriter, CFBDocument, CFBStorage, CFBStream) para leer y escribir el formato Compound File Binary de forma independiente de MAPI. Esto es útil para inspeccionar la estructura de almacenamiento sin procesar de los archivos .msg o para crear contenedores de archivos compuestos personalizados.
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))
Acceso a propiedades MAPI
iter_properties() devuelve todas las propiedades MAPI de un mensaje como objetos MapiProperty. Las propiedades nombradas (PidLidTag y PidNameTag) son accesibles a través de MapiNamedProperty. MapiPropertyCollection ofrece acceso a propiedades similar a un diccionario.
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])
Inicio rápido
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"])
Formatos compatibles
| Formato | Extensión | Leer | Escribir |
|---|---|---|---|
| Mensaje | .msg | ✓ | ✓ |
| CFB | .cfb | ✓ | ✓ |
| eml | .eml | ✓ | ✓ |
Los archivos MSG se leen a través de MapiMessage.from_file() y MsgReader. EML se accede mediante el puente de conversión from_email_message() / to_email_message(). Los contenedores CFB se manejan directamente por CFBReader y CFBWriter.
Código abierto & licencias
Aspose.Email FOSS para Python se lanza bajo la Licencia MIT. El código fuente está disponible en GitHub y el paquete se distribuye a través de PyPI bajo el nombre aspose-email-foss. La licencia MIT permite el uso en aplicaciones comerciales sin regalías ni requisitos de atribución más allá de la inclusión de la licencia.