Documentation – Програмування з Thunderbird

Python-Net: Читання електронних листів з MBOX у Python

Mon, 01 Jan 0001 00:00:00 +0000

Mozilla Thunderbird — популярний відкритий крос‑платформений клієнт електронної пошти, розроблений Mozilla Foundation. Він зберігає листи у власній файловій структурі та керує індексами повідомлень і підпапками за допомогою пропрітарних форматів файлів. Aspose.Email може працювати зі структурами сховища пошти Thunderbird. Зокрема, API містить MboxrdStorageReader клас, який дозволяє розробникам читати повідомлення з файлів сховища пошти Mozilla Thunderbird. У цій статті пояснюється, як читати повідомлення зі сховища електронної пошти Thunderbird за допомогою Aspose.Email.

Як читати повідомлення з файлів MBOX

Щоб читати повідомлення зі сховища пошти Thunderbird, виконайте наступні кроки:

Відкрийте файл сховища Thunderbird.
Створіть екземпляр MboxrdStorageReader клас і передайте файловий потік у його конструктор.
Викличте read_next_message() метод для отримання першого повідомлення.
Використовуйте цикл while з read_next_message() для ітерації по всіх повідомленнях.
Закрийте всі файлові потоки після обробки.

Наступний фрагмент коду демонструє, як читати всі повідомлення з файлу сховища пошти Thunderbird:

Отримати властивості електронної пошти з повідомлень MBOX

Aspose.Email надає MboxStorageReader клас для читання повідомлень та MboxLoadOptions клас для завантаження файлів MBOX. MboxMessageInfo клас містить різні властивості для доступу та відображення конкретних деталей повідомлення, включаючи:

date: Повертає дату повідомлення.
from_address: Повертає адресу відправника.
subject: Повертає тему повідомлення.
to: Повертає адреси отримувачів.
cc: Повертає адреси отримувачів CC.
bcc: Повертає адреси отримувачів BCC.

Наступний фрагмент коду демонструє, як витягнути та відобразити деталі повідомлення з файлу MBOX:

import aspose.email as ae

reader = ae.storage.mbox.MboxStorageReader.create_reader(file_name, ae.storage.mbox.MboxLoadOptions())

for mbox_message_info in reader.enumerate_message_info():
    print(f"Subject: {mbox_message_info.subject}")
    print(f"Date: {mbox_message_info.date}")
    print(f"From: {mbox_message_info.from_address}")
    print(f"To: {mbox_message_info.to}")
    print(f"CC: {mbox_message_info.cc}")
    print(f"Bcc: {mbox_message_info.bcc}")

Витягнути повідомлення за ID з файлів MBOX

Aspose.Email дозволяє витягати повідомлення з файлу MBOX за допомогою entry ID. Наступні методи та властивості полегшують цей процес:

enumerate_message_info(): Ітерується по кожному повідомленню у файлі MBOX.
extract_message(): Витягує кожне повідомлення за його Entry ID.
entry_id: Отримує ідентифікатор запису.

Нижче наведений приклад коду демонструє використання цих можливостей для читання та витягнення повідомлень з MBOX‑файлу:

Створіть читача MBOX за допомогою MboxStorageReader.create_reader() метод. Вкажіть файл для обробки та передайте MboxLoadOptions для налаштування параметрів завантаження.
Перерахувати повідомлення, ітеруючись по кожному mbox_message_info шляхом виклику enumerate_message_info() у читача. Це надає доступ до метаданих кожного листа у файлі MBox.
Витягнути окремі повідомлення. Для кожного запису інформації про повідомлення витягніть сам лист за допомогою методу extract_message(). Передайте entry_id з mbox_message_info та EmlLoadOptions() для налаштування завантаження електронної пошти.

import aspose.email as ae

reader = ae.storage.mbox.MboxStorageReader.create_reader("my.mbox", ae.storage.mbox.MboxLoadOptions())

for mbox_message_info in reader.enumerate_message_info():
    eml = reader.extract_message(mbox_message_info.entry_id, ae.EmlLoadOptions())

Налаштування параметрів завантаження при читанні файлів MBOX

Aspose.Email EmlLoadOptions клас дозволяє налаштувати процес завантаження MailMessage з формату EML. Наприклад, ви можете встановити параметр збереження вкладень TNEF під час завантаження файлу EML, задавши preserve_tnef_attachments властивість EmlLoadOptions клас.

Щоб прочитати наступне електронне повідомлення з файлу MBOX з вказаними параметрами завантаження, використовуйте read_next_message метод MboxStorageReader клас. Крім того, ви можете конвертувати файл у формат PST за допомогою mbox_to_pst метод MailStorageConverter клас.

Наступний приклад коду демонструє, як використовувати ці методи та властивості для управління файлами сховища електронної пошти, включаючи читання повідомлень у форматі MBOX, збереження вкладень TNEF та конвертацію повідомлень з MBOX у формат PST:

import aspose.email as ae

reader = ae.storage.mbox.MboxrdStorageReader(fileName, ae.storage.mbox.MboxLoadOptions())

# Read messages preserving tnef attachments.
load_options = ae.EmlLoadOptions()
load_options.preserve_tnef_attachments = True
eml = reader.read_next_message(load_options)
ae.storage.MailStorageConverter.MboxMessageOptions(load_options)

# Convert messages from mbox to pst preserving tnef attachments.
pst = ae.storage.MailStorageConverter.mbox_to_pst("Input.mbox", "Output.pst")

Встановити бажане кодування тексту для читання файлів MBOX

Ви можете задати кодування тексту, яке буде використано під час завантаження файлу MBOX. preferred_text_encoding властивість MboxLoadOptions клас встановлює додаткову опцію і забезпечує коректне читання та обробку повідомлення з закодованим вмістом.

Наступний фрагмент коду показує, як використати цю функцію в проєкті:

import aspose.email as ae

load_options = ae.storage.mbox.MboxLoadOptions()
load_options.preferred_text_encoding = 'utf-8'
reader = ae.storage.mbox.MboxrdStorageReader("sample.mbox", load_options)
message = reader.read_next_message()

Отримати загальну кількість повідомлень у файлі MBOX

The MboxrdStorageReader клас, який забезпечує можливість читати кількість елементів у файлі MBox. Це можна використати для створення додатків, які показують прогрес процесу під час обробки такого файлу.

Отримати розмір конкретного повідомлення у MBOX

Python-Net: Запис повідомлень у файли Thunderbird MBOX за допомогою Aspose.Email

Mon, 01 Jan 0001 00:00:00 +0000

Якщо вам потрібно програмно додати нові повідомлення до файлу сховища пошти Thunderbird, Aspose.Email надає MboxrdStorageWriter клас, який спрощує це завдання. Цей клас дозволяє записувати повідомлення у існуючий файл MBOX.

Нижченаведені кроки описують, як використати MboxrdStorageWriter разом із MailMessage клас для створення та збереження повідомлень у форматі пошти Thunderbird. Також надано приклад коду, що демонструє процес.

Відкрийте файл сховища Thunderbird у FileStream.
Створіть екземпляр MboxrdStorageWriter класу і передайте вищезгаданий потік у конструктор.
Підготуйте нове повідомлення за допомогою MailMessage клас.
Викличте write_message() метод і передайте вищезазначене MailMessage екземпляр для додавання повідомлення у сховище Thunderbird.
Закрийте всі потоки.

Python-Net: Пошук та фільтрація листів MBOX у Python

Mon, 01 Jan 0001 00:00:00 +0000

Фільтрація повідомлень MBOX за темою та датою

Aspose.Email для Python через .NET забезпечує можливість фільтрувати або шукати повідомлення у файлах MBOX за допомогою запиту. Наступні методи дозволяють отримати лише ті повідомлення, які відповідають певним критеріям:

EnumerateMessages(MailQuery query) - повертає перераховувану колекцію MailMessage екземпляри, які відповідають зазначеному запиту.
EnumerateMessageInfo(MailQuery query) - повертає перераховувану колекцію MboxMessageInfo екземпляри, які відповідають зазначеному запиту.

Нижче наведений приклад коду покаже, як використати ці методи при фільтруванні повідомлень:

import datetime
from aspose.email.storage.mbox import MboxStorageReader, MboxLoadOptions
from aspose.email import MailQueryBuilder

# Create an MBOX reader with load options
reader = MboxStorageReader.create_reader("input.mbox", MboxLoadOptions())

# Build the mail query
mqb = MailQueryBuilder()
mqb.subject.contains("Project Update")
mqb.sent_date.before(datetime.date.today())

# Iterate over matching messages
for message in reader.enumerate_messages(mqb.get_query()):
    print("Subject:", message.subject)

Пагіноване отримання повідомлень MBOX

Aspose.Email для Python через .NET підтримує пагіноване читання файлів MBOX, що дозволяє ефективно обробляти великі архіви електронної пошти. Замість завантаження всього набору повідомлень у пам’ять, ви можете отримувати повідомлення маленькими, керованими порціями. Це особливо корисно при роботі з дуже великими архівними файлами, допомагаючи знизити використання пам’яті та підвищити продуктивність під час обробки.

Наступні методи можна використати для пагінованого отримання повідомлень MBOX:

enumerate_messages(start_index, count) - Отримує певну кількість MailMessage екземпляри.
enumerate_message_info(start_index, count) - Отримує відповідні MboxMessageInfo об’єкти.

Наступний приклад коду демонструє, як читати та отримувати повідомлення з файлу MBOX у керованих частинах за допомогою бібліотеки Aspose.Email:

from aspose.email.storage.mbox import MboxStorageReader, MboxLoadOptions

# Initialize MBOX reader with load options
reader = MboxStorageReader.create_reader("input.mbox", MboxLoadOptions())

# Define pagination parameters
start_index = 0
count = 10  # Retrieve messages in batches of 10

# Enumerate and display messages in the current batch
for message in reader.enumerate_messages(start_index, count):
    print("Subject:", message.subject)

Python-Net: Конвертувати MBOX у PST за допомогою Aspose.Email для Python через .NET

Mon, 01 Jan 0001 00:00:00 +0000

Конвертувати MBOX у PST збереженням або видаленням підпису

При конвертації файлів MBOX у формат PST ви можете захотіти виключити цифрові підписи з повідомлень для чистішого виводу або з метою сумісності. Aspose.Email надає зручну опцію для видалення цих підписів під час процесу конвертації, використовуючи remove_signature властивість MboxToPstConversionOptions клас.

Нижче наведений приклад демонструє, як увімкнути цю опцію у вашому Python‑проекті:

import aspose.email as ae

personalStorage = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)
conversion_options = ae.storage.MboxToPstConversionOptions()
conversion_options.remove_signature = True
ae.storage.MailStorageConverter.mbox_to_pst( ae.storage.mbox.MboxrdStorageReader("source.mbox", ae.storage.mbox.MboxLoadOptions()), personalStorage, "Inbox", conversion_options)