1. محصولات
  2.   Aspose.Email
  3.   Aspose.Email FOSS for Python

Aspose.Email FOSS برای Python

خواندن، ایجاد و نوشتن فایل‌های Outlook MSG از Python — رایگان و منبع باز، نیازی به Microsoft Office نیست.

Aspose.Email FOSS for Python Aspose.Email FOSS
for Python

مستندات GitHub

کتابخانه منبع باز Python برای فایل‌های Outlook MSG

Aspose.Email FOSS برای Python یک کتابخانه ۱۰۰٪ رایگان با مجوز MIT است که به شما امکان می‌دهد فایل‌های Microsoft Outlook MSG را به‌صورت کامل از Python بخوانید و بنویسید، بدون نیاز به Microsoft Office، بدون اتوماسیون COM و بدون زمان‌اجرای مالکیتی. این کتابخانه یک API عمومی تمیز مبتنی بر مفاهیم MAPI (MapiMessage، MapiAttachment، MapiRecipient) را ارائه می‌دهد که توسط یک پارسر داخلی CFB (Compound File Binary) نوشته شده به‌صورت خالص Python پشتیبانی می‌شود.

از PyPI با pip install aspose-email-foss نصب کنید. نیازمند Python 3.10 یا بالاتر است.

این کتابخانه برای اسکریپت‌های بایگانی ایمیل، خطوط لولهٔ انطباق، ابزارهای مهاجرت و هر گردش کار سمت سرور که نیاز به تجزیه یا تولید فایل‌های Outlook MSG بدون وابستگی به Microsoft Office دارد، مناسب است.

خواندن و نوشتن فایل‌های MSG

  • بارگذاری فایل‌های MSG: هر فایل Outlook MSG را با MapiMessage.from_file() باز کنید.
  • دسترسی به داده‌های پیام: موضوع، بدنه، بدنه HTML، کلاس پیام و هدرهای حمل و نقل را بخوانید.
  • تکرار پیوست‌ها: متادیتای پیوست‌ها را با iter_attachments_info() مرور کنید یا به داده‌های باینری دسترسی پیدا کنید.
  • ایجاد پیام‌ها: فایل‌های MSG جدید را از ابتدا با MapiMessage.create() بسازید.
  • ذخیرهٔ فایل‌های MSG: با save() روی دیسک بنویسید یا بایت‌ها را با to_bytes() دریافت کنید.

برچسب ها: Email Foss

  • بایگانی ایمیل: فایل‌های MSG را برای گردش کارهای انطباق و نگهداری تجزیه و فهرست‌بندی کنید.
  • ابزارهای مهاجرت: فایل‌های MSG را به فرمت ایمیل RFC 5322 برای مهاجرت بین‌پلتفرمی تبدیل کنید.
  • اسکریپت‌های خودکارسازی: فایل‌های MSG را به‌صورت برنامه‌نویسی برای سیستم‌های اعلان تولید کنید.
  • CI/CD pipelines: ساختار فایل MSG را داخل کانتینرهای Docker اعتبارسنجی کنید.
  • Forensic analysis: ساختار سطح پایین CFB و ویژگی‌های MAPI را بررسی کنید.

دریافت‌کنندگان، پیوست‌ها و ویژگی‌ها

  • افزودن گیرندگان: گیرندگان To، CC و BCC را با نام‌های نمایشی و آدرس‌های ایمیل پیوست کنید.
  • پیوست‌های فایل: پیوست‌های فایل باینری را با انواع MIME اضافه کنید.
  • پیام‌های توکار: فایل‌های MSG را داخل سایر فایل‌های MSG به‌عنوان پیوست‌های پیام توکار قرار دهید.
  • ویژگی‌های MAPI: هر ویژگی MAPI را بر اساس شناسه ویژگی یا ویژگی نام‌دار بخوانید و بنویسید.
  • تبدیل ایمیل: بین فرمت MSG و ایمیل RFC 5322 با to_email_message() و from_email_message() تبدیل کنید.

تجربهٔ توسعه‌دهنده

Aspose.Email FOSS نصب‌ها با یک فرمان pip install aspose-email-foss انجام می‌شود. این بسته هیچ وابستگی خارجی ندارد و کاملاً Python است.

API مطابق با قراردادهای MAPI است: MapiMessage، MapiAttachment، MapiRecipient، MapiProperty. این کتابخانه تحت مجوز MIT، منبع باز است و گزارش‌های باگ و مشارکت‌ها را در GitHub می‌پذیرد.

یک فایل MSG را بارگذاری کنید و ویژگی‌های آن را بخوانید

با pip نصب کنید، سپس مسیر فایل را به MapiMessage.from_file() بدهید تا فرمت باینری MSG را تجزیه کنید. از طریق API سطح بالا به موضوع، بدنه و پیوست‌ها دسترسی پیدا کنید.

pip install aspose-email-foss

from aspose.email_foss.msg.message import MapiMessage

msg = MapiMessage.from_file("message.msg")
print(f"Subject: {msg.subject()}")
print(f"Body: {msg.body()}")

for att in msg.iter_attachments_info():
    print(f"Attachment: {att.storage_name()}")

یک فایل MSG جدید با پیوست‌ها ایجاد کنید

فایل‌های MSG را از ابتدا ایجاد کنید، دریافت‌کنندگان و پیوست‌ها را اضافه کنید و آن را روی دیسک ذخیره کنید.

from aspose.email_foss.msg.message import MapiMessage

msg = MapiMessage.create("Meeting Notes", "Please review attached.")
msg.add_recipient("alice@example.com", "Alice", "to")

with open("notes.pdf", "rb") as f:
    msg.add_attachment("notes.pdf", f.read(), "application/pdf")

msg.save("output.msg")

سوالات متداول

Aspose.Email FOSS برای Python چیست؟

این یک کتابخانه رایگان با مجوز MIT Python برای خواندن و نوشتن فایل‌های Microsoft Outlook MSG است که بدون نیاز به Microsoft Office، خودکارسازی COM یا هر زمان‌اجرای مالکیتی کار می‌کند.

کدام فرمت‌های ایمیل پشتیبانی می‌شوند؟

فایل‌های MSG (Outlook) در قالب CFB نسخه 3 و 4. این کتابخانه همچنین می‌تواند بین فرمت MSG و فرمت ایمیل RFC 5322 تبدیل انجام دهد.

چگونه آن را نصب کنم؟

دستور pip install aspose-email-foss را اجرا کنید. نیاز به Python 3.10 یا بالاتر دارد.

آیا می‌توانم فایل‌های EML را بخوانم؟

به‌صورت مستقیم نیست. از MapiMessage.from_email_message() برای تبدیل از یک شیء EmailMessage که از محتوای EML ساخته شده استفاده کنید.

آیا می‌توانم فایل‌های MSG را از ابتدا ایجاد کنم؟

بله. از MapiMessage.create(subject, body) برای ساخت یک پیام جدید استفاده کنید، سپس دریافت‌کنندگان و پیوست‌ها را قبل از ذخیره‌سازی اضافه کنید.

آیا ایمنی در برابر همزمانی (thread-safety) پشتیبانی می‌شود؟

هر نمونهٔ MapiMessage مستقل است. عملیات همزمان بر روی نمونه‌های جداگانه ایمن هستند.

کجا می‌توانم کد منبع را پیدا کنم؟

این کتابخانه تحت مجوز MIT است و در GitHub به آدرس aspose-email-foss/Aspose.Email-FOSS-for-Python میزبانی می‌شود.

  

منابع پشتیبانی و آموزش

 فارسی