소개

Aspose.Email FOSS for Python (aspose-email-foss)은 Outlook MSG 파일, RFC-5322 EML 메시지 및 복합 파일 바이너리(CFB) 저장 구조를 다루기 위한 MIT 라이선스 Python 라이브러리입니다. 이 라이브러리는 네이티브 확장이 필요 없으며 PyPI에서 직접 설치됩니다.

이 라이브러리는 일반적인 Python 개발 격차를 해결합니다: 실행 중인 Outlook 설치나 독점 SDK 없이 Outlook .msg 파일을 읽고 쓸 수 있습니다. 또한 .msg 파일의 기반이 되는 전체 CFB 컨테이너 형식을 공개하여 메시지 마이그레이션부터 저장소 검사에 이르는 다양한 작업에 적합합니다.

이 라이브러리는 MAPI 메시지 생성, 수신자 및 첨부 파일 관리, 속성 직렬화, 그리고 CFB 문서 라운드트립을 포괄하는 타입이 지정된 API 인터페이스를 제공합니다.


주요 기능

MSG 파일 생성 및 직렬화

MapiMessage.create()은(는) 제목 및 본문 문자열을 사용하여 새로운 MAPI 메시지를 구성합니다. 여기에서 타입이 지정된 속성, 수신자 및 바이너리 첨부 파일을 추가한 뒤, 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 파일을 읽습니다. 또한 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) 저장소

이 라이브러리에는 MAPI와 독립적으로 Compound File Binary 형식을 읽고 쓸 수 있는 독립형 CFB 레이어(CFBReader, CFBWriter, CFBDocument, CFBStorage, CFBStream)가 포함되어 있습니다. 이는 .msg 파일의 원시 저장 구조를 검사하거나 맞춤형 복합 파일 컨테이너를 구축할 때 유용합니다.

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은 사전 형태의 속성 접근을 제공합니다.

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-foss
import 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() 변환 브리지를 통해 접근합니다. CFB 컨테이너는 CFBReader와 CFBWriter에 의해 직접 처리됩니다.


오픈 소스 및 라이선스

Aspose.Email FOSS for Python은 MIT 라이선스 하에 출시되었습니다. 소스는 GitHub에서 이용 가능하며, 패키지는 PyPI를 통해 aspose-email-foss 이름으로 배포됩니다. MIT 라이선스는 라이선스 포함을 제외하고 로열티나 저작자 표시 요구 없이 상업 애플리케이션에서의 사용을 허용합니다.


시작하기

관련 리소스