Documentation – Робота з POP3 клієнтом

Python-Net: Підключення до POP3‑сервера у Python

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

Підключитися до POP3‑сервера, використовуючи базову автентифікацію

Aspose.Email for Python API надає Pop3Client class, який дозволяє застосункам керувати поштовими скриньками через Post Office Protocol Version 3 (POP3). Використовуйте цей клас для встановлення з’єднання з POP3‑сервером. Він слугує основним інтерфейсом для розробників, які хочуть включити управління POP3 у свої .NET‑застосунки. У цій статті наведено рекомендації щодо ефективного використання класу Pop3Client.

Наступний фрагмент коду демонструє, як встановити з’єднання з POP3‑почтовим сервером, використовуючи Aspose.Email Pop3Client class. Він ілюструє процес налаштування з’єднання з необхідними параметрами, такими як адреса сервера, облікові дані користувача, налаштування безпеки та номер порту. Це налаштування необхідне для безпечного отримання листів з облікового запису Gmail.

Створіть екземпляр Pop3Client.
Вкажіть хост, ім’я користувача, пароль, порт та параметри безпеки.

Підключитися до POP3‑сервера з SSL

Щоб підключитися до POP3‑сервера з SSL, використайте Aspose.Email Pop3Client class і встановіть параметри безпеки та порт. Наступний фрагмент коду демонструє, як підключитися до POP3‑сервера з підтримкою SSL:

Підключитися до POP3‑сервера за допомогою автентифікації APOP

APOP (Authenticated Post Office Protocol) — це захищений метод отримання листів з поштового сервера. Він розширює традиційний протокол POP3, додаючи рівень автентифікації, який захищає облікові дані користувача.

Замість надсилання вашого імені користувача та пароля у відкритому вигляді, APOP використовує хешоване значення під час процесу автентифікації. Після входу клієнт створює хеш, використовуючи секретний ключ (пароль користувача) та значення challenge (унікальний рядок, створений сервером).

Підключитися до POP3‑сервера через проксі

Проксі‑сервери діють як посередники між вашим поштовим клієнтом і сервером під час спілкування з зовнішнім світом. Замість прямого підключення до поштового сервера ваші запити проходять через проксі, що дає декілька переваг, включно з маскуванням вашої IP‑адреси та доступом до обмеженого вмісту. Використання проксі‑серверів може підвищити конфіденційність і безпеку, особливо під час доступу до електронної пошти через публічні мережі.

Aspose.Email підтримує використання проксі‑серверів, зокрема версії 4, 4a та 5 протоколу SOCKS. Ця можливість дозволяє розробникам створювати застосунки, які ефективно спілкуються з поштовими серверами через проксі. Його Pop3Client class дозволяє застосункам отримувати доступ і маніпулювати повідомленнями за допомогою Post Office Protocol Version 3 (POP3). Один корисний метод — getmailboxinfo(), який отримує основну інформацію про поштову скриньку, таку як кількість повідомлень та загальний розмір, спрощуючи управління обліковими записами електронної пошти.

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

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("pop.domain.com", "username", "password")
# Set proxy address, Port and Proxy
proxy_address = "192.168.203.142"
proxy_port = 1080
proxy = ae.clients.SocksProxy(proxy_address, proxy_port, ae.clients.SocksVersion.SOCKS_V5)
client.socks_proxy = proxy
mailboxInfo = client.get_mailbox_info()

Підтримка HTTP‑проксі

Існує різноманітність типів проксі, включаючи HTTP‑проксі, SOCKS‑проксі та інші, кожен з них служить різним цілям і забезпечує різний рівень функціональності. Конкретні кроки та налаштування можуть відрізнятися залежно від типу проксі. Нижче наведений приклад коду демонструє, як налаштувати Pop3Client з додатковою конфігурацією HTTP‑проксі та отриманням інформації про поштову скриньку:

import aspose.email as ae

proxy = ae.clients.HttpProxy("18.222.124.59", 8080)
client = ae.clients.pop3.Pop3Client("pop.domain.com", "username", "password")
client.socks_proxy = proxy
mailboxInfo = client.get_mailbox_info()

Підключитися до сервера за допомогою автентифікації CRAM-MD5

CRAM-MD5 (механізм автентифікації challenge‑response з MD5) часто використовується в поштових протоколах, таких як POP3 та IMAP, де важлива безпечна автентифікація. Він забезпечує вищий рівень безпеки порівняно з передачею паролів у відкритому вигляді. Aspose.Email for .NET дозволяє користувачам безпечно автентифікуватися та отримувати доступ до поштових серверів, що підтримують цей метод автентифікації.

client.allowed_authentication = ae.clients.pop3.Pop3KnownAuthenticationType.CRAM_MD5

Налаштувати тайм‑аут поштових операцій

Aspose.Email надає властивість ’timeout’ для Pop3Client class для отримання або встановлення тайм‑ауту поштових операцій з метою запобігання зависанню чи блокуванню, обробки мережевих або серверних проблем, підвищення реактивності та забезпечення ефективного управління ресурсами. Наступний приклад коду показує, як реалізувати властивість у проєкті:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
#  60 seconds
client.timeout = 60000

Використовувати криптографічні протоколи з POP3‑клієнтом

Aspose.Email підтримує криптографічні протоколи SSL (застарілий) та TLS для забезпечення безпеки зв’язку. Ви можете увімкнути криптографічне шифрування, щоб захистити обмін даними між вашим застосунком і поштовими серверами.

NOTE: It's important to know that you can only configure protocol versions supported by the .NET Framework. If your current .NET Framework version does not support certain protocol versions, those unsupported versions will be disregarded and skipped. This could result in a potential downgrade in TLS security level, and it's crucial to be aware that no exceptions will be raised in this situation. Developers should exercise caution to ensure the desired TLS security level is maintained based on the supported protocols in their .NET Framework environment.

Наступний приклад коду демонструє, як налаштувати POP3‑клієнт з конфігурацією протоколу шифрування TLS 1.3 для захищеного зв’язку:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS13

У випадку, коли зазначений протокол шифрування не підтримується у поточній версії .NET Framework, різниця у поведінці між методом ‘SetSupportedEncryptionUnsafe’ і властивістю ‘SupportedEncryption’ наступна:

Якщо використано властивість ‘SupportedEncryption’, поштовий клієнт знижує протокол шифрування до підтримуваного рівня.

Якщо використано метод ‘SetSupportedEncryptionUnsafe’, поштовий клієнт генерує виключення.

Python-Net: Видалення листів з POP3‑сервера у Python

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

Aspose.Email for .NET надає повний контроль над керуванням повідомлень на POP3‑сервері. Використовуючи Pop3Client class, розробники можуть підключатися до поштової скриньки та програмно виконувати безліч завдань із повідомленнями сервера, включаючи видалення конкретних листів або всіх їх. Це особливо корисно в серверних застосунках обробки пошти, де необхідне очищення після отримання чи за кастомною логікою.

У цій статті пояснюється, як видаляти повідомлення за допомогою POP3‑клієнта Aspose.Email у різних сценаріях.

Видалити лист за індексом

Наступний фрагмент коду показує, як видаляти всі повідомлення в поштовій скринці по черзі, використовуючи їх індекс. Номер індексу ніколи не повинен бути <=0 у Pop3Client.DeleteMessage.

Видалити всі листи

Також можливо викликати delete_messages() метод для видалення всіх повідомлень. Наступний фрагмент коду показує, як використовувати цей метод:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("imap.example.com", "username", "password")

# Delete all the messages
client.delete_messages()

Якщо з’єднання з POP3‑сервером втрачається одразу після операції видалення, то undelete_messages() метод більше не можна викликати для відновлення даних.

Скасувати операції видалення

Метод undelete_messages можна використати для скасування видалення електронних листів. Наступний фрагмент коду показує, як використовувати цей метод:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("imap.example.com", "username", "password")

# Cancel deletes
client.undelete_messages()

Python-Net: Додаткові можливості – POP3 клієнт

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

Перевірка облікових даних поштового сервера

Aspose.Email надає метод ‘validate_credentials()’ класу Pop3Client клас для перевірки облікових даних (ім’я користувача та пароль), наданих користувачем для доступу до POP3 серверу електронної пошти. Цей метод забезпечує правильність і дійсність облікових даних, дозволяючи успішно автентифікуватися та отримати доступ до поштової скриньки за допомогою протоколу POP3. Якщо надані дані невірні, метод може повернути помилку або викинути виключення, що вказує на невдалий процес входу.

Нижче наведений фрагмент коду демонструє метод верифікації, що надається API:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 40000
if client.validate_credentials():
# to do something

Python-Net: Перевірка облікових даних POP3 сервера у Python

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

Aspose.Email надає validate_credentials() метод Pop3Client клас для перевірки облікових даних користувача (ім’я та пароль) для POP3 сервера електронної пошти. Цей метод забезпечує дійсність облікових даних, дозволяючи успішну автентифікацію та доступ до поштової скриньки за протоколом POP3. Якщо дані неправильні, метод повертає ‘False’ або піднімає виключення, вказуючи на збій автентифікації.

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

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 40000
if client.validate_credentials():
# to do something

Python-Net: Перелік підтримуваних розширень POP3‑сервера

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

Aspose.Email надає Pop3Client class, який дозволяє отримати підтримувані розширення POP3‑сервера, такі як IDLE, UNSELECT, QUOTA тощо. Знання доступних розширень важливе для визначення, чи можна використовувати певні функції. get_capabilities() метод повертає типи підтримуваних розширень у вигляді масиву рядків.

Наступний приклад коду демонструє, як отримати розширення сервера за допомогою Pop3Client для сервера Gmail:

Python-Net: Отримання листів з POP3‑сервера у Python

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

Отримати інформацію про скриньку та кількість повідомлень

Aspose.Email API дозволяє виконувати різні операції з повідомленнями на сервері, включаючи отримання інформації про поштову скриньку, таку як кількість повідомлень та розмір скриньки, використовуючи get_mailbox_size() і get_mailbox_info() методи.

The get_mailbox_size() метод повертає розмір скриньки в байтах.
The get_mailbox_info() метод повертає об’єкт типу Pop3MailBoxInfo.

Також можливо отримати кількість повідомлень за допомогою message_count властивість та розмір за допомогою властивості `occupied_size``. Нижче наведено зразковий код, який показує, як отримати інформацію про поштову скриньку. Він показує, як:

Створіть Pop3Client.
Підключитися до POP3 сервера.
Отримати розмір скриньки.
Отримати інформацію про скриньку.
Отримати кількість повідомлень у скриньці.
Отримати зайнятий розмір.

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

Наведений вище зразок коду демонструє, як отримати статистику поштової скриньки, таку як розмір або використаний простір, разом із загальною кількістю повідомлень у скринці. Наступний зразок коду покаже, як безпосередньо отримати кількість електронних листів у скриньці. Цей метод простіший і швидший, якщо вам потрібна лише кількість повідомлень.

Отримати лише заголовки листа

Aspose.Email дозволяє розробникам отримувати метадані електронних листів без завантаження повного вмісту повідомлення. У багатьох сценаріях корисно переглядати лише заголовки листа — такі як відправник, тема та дата отримання — щоб визначити, чи варто отримувати повідомлення. Такий підхід зменшує навантаження на сервер та підвищує продуктивність, особливо при роботі з великими скриньками через POP3 з’єднання.

Наступний зразок коду демонструє, як підключитися до POP3 сервера та отримати лише заголовки конкретного повідомлення за його порядковим номером. Ця легка операція допомагає приймати обґрунтовані рішення щодо того, які листи завантажувати, а які ігнорувати.

Завантажити електронні листи з сервера

Aspose.Email Pop3Client клас забезпечує можливість отримувати електронні листи з POP3 сервера та конвертувати їх у екземпляри MailMessage. Це можливо завдяки властивостям і методам MailMessage клас, який полегшує маніпуляції вмістом електронної пошти. Використовуючи fetch_message метод Pop3Client клас, ви можете отримати MailMessage екземпляр безпосередньо з POP3 сервера. Нижче наведено фрагмент коду, який демонструє, як отримати повний електронний лист з сервера:

Отримати підсумкову інформацію про повідомлення за унікальним ID

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

Перерахувати повідомлення, використовуючи кілька з’єднань

Для важких операцій Aspose.Email пропонує use_multi_connection властивість Pop3Client клас для використання кількох з’єднань під час отримання листів. Важливо зазначити, що увімкнення цього режиму не завжди гарантує підвищення продуктивності. Нижче наведено фрагмент коду, який показує, як встановити з’єднання з POP3 сервером, налаштувати клієнт для дозволу до 5 одночасних з’єднань і ввімкнути режим множинних з’єднань для отримання інформації про повідомлення, що зберігаються на сервері:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
message_info_coll = client.list_messages()

Python-Net: Отримання листів з POP3‑сервера у Python

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

Зберегти листи на диск без розбору

Щоб завантажити листи з POP3 сервера без розбору, ви можете використати save_message метод Aspose.Email Pop3Client клас. Нижче наведено фрагмент коду, який ілюструє, як зберегти лист, використовуючи його порядковий номер, в даному випадку номер 1. The save_message метод зберігає оригінальний формат EML без розбору:

Розбирати листи перед збереженням

Ви можете отримати конкретний електронний лист, використовуючи fetch_message метод Pop3Client клас, вказуючи потрібний порядковий номер для об’єкта клієнта. Наведений нижче зразок коду показує, як отримати певне повідомлення, а потім зберегти його, використовуючи тему як ім’я файлу, викликавши save метод об’єкта msg:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

# Fetch the message by its sequence number and Save the message using its subject as the file name
msg = client.fetch_message(1)
msg.save("first-message_out.eml", ae.SaveOptions.default_eml)

Фільтрування листів з сервера за критеріями

Aspose.Email Pop3Client class надає list_messages() метод, який отримує всі повідомлення зі скриньки. Щоб отримати лише повідомлення, що відповідають певній умові, використовуйте перевантажений list_messages(query) метод, який приймає MailQuery як аргумент. MailQuery клас надає різні властивості для зазначення умов запиту, наприклад, дата, тема, відправник, одержувач тощо.

Щоб створити вираз пошуку, використайте MailQueryBuilder клас. Спочатку визначте всі необхідні умови та обмеження, а потім заповніть об’єкт MailQuery запитом, створеним MailQueryBuilder. Pop3Client використовує цей об’єкт MailQuery для отримання відфільтрованої інформації з сервера.

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

Встановіть з’єднання з POP3 сервером Gmail за допомогою Pop3Client клас з вказаною адресою сервера, портом, ім’ям користувача та паролем. Параметри безпеки встановлені в AUTO для безпечного з’єднання.
Створіть екземпляр MailQueryBuilder для побудови критеріїв пошуку фільтрації листів.
Фільтрація за темою:
- Листи, що містять "Newsletter" у темі, вказані як умова фільтру.
Фільтрація за внутрішньою датою:
- Встановлено фільтр для листів, отриманих у поточну дату.
- Додано додатковий фільтр для отримання листів, отриманих протягом останнього тижня.
Фільтрація за відправником:
- Застосовано фільтри для пошуку листів з певної електронної адреси (saqib.razzaq@127.0.0.1) та включення листів з певного домену (SpecificHost.com).
Фільтрація за одержувачем:
- Вказано фільтр для пошуку листів, надісланих конкретному одержувачу.
Комбінувати запити за допомогою оператора OR, щоб шукати листи, які або відповідають заданій темі, або надіслані з певної адреси.
Чутливе до регістру фільтрування:
- Вказано чутливий до регістру фільтр для теми, що містить "Newsletter" (означений параметром True).
Перерахунок повідомлень:
- Метод list_messages() викликається з побудованим запитом для отримання відфільтрованих листів з скрині.
Нарешті виведіть кількість відфільтрованих повідомлень.

Фільтруйте електронні листи за датою

Щоб отримати повідомлення за датою доставки, використайте internal_date властивість, як показано у прикладі коду нижче:

import aspose.email as ae
from datetime import datetime

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.on(datetime.now())

Фільтруйте електронні листи за діапазоном дат

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

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
# Emails that arrived in last 7 days
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))

Фільтруйте електронні листи за відправником

Щоб отримати повідомлення від конкретного відправника, використайте from_address властивість, як показано у прикладі коду нижче:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("saqib.razzaq@127.0.0.1")

Фільтруйте електронні листи за доменом

Щоб отримати повідомлення з конкретного домену, використайте from_address властивість, як показано у прикладі коду нижче:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("SpecificHost.com")

Фільтруйте електронні листи за одержувачем

Щоб отримати повідомлення для конкретного одержувача, використайте to властивість, як показано у прикладі коду нижче:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.to.contains("recipient")

Створюйте складні запити пошуку

Іноді необхідно задовольнити більше ніж один запит. Aspose.Email дозволяє комбінувати запити в декілька виразів. Створіть MailQueryBuilder об’єкт і використати його властивості для побудови конкретних запитів.

Комбінувати запити за AND

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

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))
builder.from_address.contains("SpecificHost.com")

Комбінувати запити за OR

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

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.either(builder.subject.contains("test"), builder.from_address.contains("noreply@host.com"))

Застосовувати чутливі до регістру фільтри

API також забезпечує можливість фільтрування листів у скринці за чутливим до регістру критерієм. Наступні методи StringComparisonField клас забезпечує можливість пошуку листів з вказанням прапорців чутливості до регістру:

Метод Aspose.Email.StringComparisonField.contains(value, ignore_case) Метод Aspose.Email.StringComparisonField.equals(value, ignore_case) Метод Aspose.Email.StringComparisonField.not_contains(value, ignore_case) Метод Aspose.Email.StringComparisonField.not_equals(value, ignore_case)

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

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("noreply@host.com", True)

Python-Net: Робота з повідомленнями з сервера

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

Отримання інформації про скриньку

Ми можемо отримати інформацію про поштову скриньку, таку як кількість повідомлень та розмір скриньки, використовуючи методи GetMailBoxSize() і GetMailBoxInfo().

Метод GetMailBoxSize() повертає розмір поштової скриньки в байтах.
Метод GetMailBoxInfo() повертає об’єкт типу Pop3MailBoxInfo.

Також можна отримати кількість повідомлень за допомогою властивості MessageCount та розмір за допомогою властивості OccupiedSize. Нижче наведено зразковий код, який показує, як отримати інформацію про поштову скриньку. Він показує, як:

Створіть Pop3Client.
Підключитися до POP3 сервера.
Отримати розмір скриньки.
Отримати інформацію про скриньку.
Отримати кількість повідомлень у скриньці.
Отримати зайнятий розмір.

Отримання кількості листів у скринці

Наступний фрагмент коду показує, як підрахувати електронні листи в поштовій скриньці.

Aspose.Email дозволяє розробникам працювати з електронними листами різними способами. Наприклад, вони можуть отримати інформацію про заголовки перед тим, як вирішити, чи завантажувати лист. Або вони можуть отримати листи з сервера і зберегти їх без парсингу (швидше) або після парсингу (повільніше). У цій статті показано, як отримувати та конвертувати листи.

Отримання інформації про заголовки листа

Заголовки листа можуть надати нам інформацію про повідомлення, яку ми можемо використати для вирішення, чи завантажувати весь лист. Зазвичай заголовки містять відправника, тему, дату отримання тощо. (Заголовки листа докладно описані у розділі Налаштування заголовків листа. Ця тема стосується саме надсилання листів через SMTP, але інформація про заголовки залишається актуальною для POP3 листів). Нижче наведено приклади, які показують, як отримати заголовки листа з POP3 сервера за порядковим номером повідомлення.

Отримання електронних листів

Компонент класу Aspose.Email.Pop3 надає можливість отримувати електронні листи з POP3 сервера та розбирати їх у екземпляр MailMessage за допомогою компонентів MailMessage. Клас MailMessage містить кілька властивостей і методів для маніпуляцій вмістом листа. Використовуючи функцію FetchMessage класу Pop3Client, ви можете отримати екземпляр MailMessage безпосередньо з POP3 сервера. Нижче наведено фрагмент коду, який показує, як отримати повний лист з POP3 сервера.

Отримання короткої інформації про повідомлення за унікальним Id

POP3 клієнт API може отримувати підсумкову інформацію про повідомлення з сервера, використовуючи унікальний ідентифікатор повідомлення. Це забезпечує швидкий доступ до короткої інформації про повідомлення без попереднього отримання повного листа з сервера. Нижче наведено фрагмент коду, який показує, як отримати підсумкову інформацію про повідомлення.

Перелік повідомлень з MultiConnection

Для важких операцій Aspose.Email пропонує властивість ‘use_multi_connection’ класу Pop3Client клас для використання кількох з’єднань під час отримання листів. Однак використання цього режиму не обов’язково призведе до підвищення продуктивності. Нижче наведено фрагмент коду, який показує, як встановити з’єднання з POP3 сервером, налаштувати клієнт для дозволу до 5 одночасних з’єднань і ввімкнути режим множинних з’єднань для отримання інформації про повідомлення, присутні на сервері:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
message_info_coll = client.list_messages()

Отримання повідомлень з сервера та збереження їх на диск

Збереження повідомлення на диск без парсингу

Якщо ви хочете завантажити електронні листи з POP3 сервера без їх розбору, використовуйте функцію SaveMessage класу Pop3Client. Функція SaveMessage не розбирає лист, тому вона швидша за функцію FetchMessage. Нижче наведено фрагмент коду, який показує, як зберегти лист за його порядковим номером, в даному випадку номер 1. Метод SaveMessage зберігає лист у вихідному форматі EML без розбору.

Парсинг повідомлення перед збереженням

Використовуйте метод ‘fetch_message’ об’єкта клієнта, створеного за допомогою Pop3Client клас для отримання повідомлення з конкретним порядковим номером. Наведений нижче зразок коду демонструє, як отримати певне повідомлення та зберегти його, використовуючи тему як ім’я файлу, викликавши метод ‘save’ у об’єкту msg:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

# Fetch the message by its sequence number and Save the message using its subject as the file name
msg = client.fetch_message(1)
msg.save("first-message_out.eml", ae.SaveOptions.default_eml)

Фільтрація повідомлень за відправником, отримувачем або датою

Клас Pop3Client, описаний у розділі Підключення до POP3 сервера, надає метод list_messages(), який отримує всі повідомлення з поштової скриньки. Щоб отримати лише повідомлення, які відповідають певній умові, використовуйте перевантажений метод ListMessages(), який приймає об’єкт MailQuery як аргумент. Клас MailQuery забезпечує різні властивості для зазначення умов запиту, наприклад, дата, тема, відправник, одержувач тощо. Клас MailQueryBuilder використовується для побудови виразу пошуку. Спочатку задаються всі умови та обмеження, потім MailQuery заповнюється запитом, створеним MailQueryBuilder. Об’єкт класу MailQuery використовується Pop3Client для витягання відфільтрованої інформації з сервера. У цій статті показано, як фільтрувати електронні листи у скринці. Перший приклад ілюструє фільтрацію повідомлень за датою та темою. Ми також демонструємо, як фільтрувати за іншими критеріями та як будувати більш складні запити. Показано застосування фільтра дати й часу для отримання конкретних листів зі скриньки. Крім того, показано, як застосовувати чутливе до регістру фільтрування.

Фільтрація повідомлень зі скриньки

Щоб фільтрувати повідомлення зі скриньки:

Підключитися та ввійти на POP3 сервер.
Створіть екземпляр MailQuery і встановіть потрібні властивості.
Викличте метод Pop3Client.list_messages(MailQuery query) і передайте MailQuery у параметрах, щоб отримати лише відфільтровані повідомлення.

Нижче наведено фрагмент коду, який показує, як підключитися до POP3 скриньки та отримати повідомлення, які надійшли сьогодні і містять слово "newsletter" у темі.

Отримання повідомлень, які відповідають певним критеріям

Aspose.Email також дозволяє створювати складні критерії пошуку для запитів і фільтрації листів. Для цього використовуйте MailQueryBuilder клас і його властивості. Критерії отримання наступні:

Отримати листи за датою доставки.
Отримати листи у межах діапазону.
Отримати листи від конкретного відправника.
Отримати листи з певного домену.
Отримати листи для конкретного одержувача.

Поточна дата

Щоб отримати листи за датою доставки, використайте властивість ‘internal_date’, як показано у наведеному нижче прикладі коду:

import aspose.email as ae
from datetime import datetime

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.on(datetime.now())

Діапазон дат

Щоб отримати листи у межах діапазону дат, використайте ту ж властивість ‘internal_date’, вказавши діапазон дат, як показано у наведеному нижче прикладі коду:

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
# Emails that arrived in last 7 days
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))

Конкретний відправник

Щоб отримати листи від конкретного відправника, використайте властивість ‘from_address’, як показано у наведеному нижче прикладі коду:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("saqib.razzaq@127.0.0.1")

Певний домен

Щоб отримати листи з певного домену, використайте властивість ‘from_address’, як показано у наведеному нижче прикладі коду:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("SpecificHost.com")

Конкретний одержувач

Щоб отримати листи для конкретного одержувача, використайте властивість ’to’, як показано у наведеному нижче прикладі коду:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.to.contains("recipient")

Створення складних запитів

Іноді необхідно задовольнити більше ніж один запит. Aspose.Email робить це можливим, комбінуючи запити в кількох виразах. Створіть MailQueryBuilder об’єкт і використати його властивості для побудови конкретних запитів.

Комбінування запитів за допомогою AND

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

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))
builder.from_address.contains("SpecificHost.com")

Комбінування запитів за допомогою OR

Нижче наведено фрагмент коду, який показує, як комбінувати запити за допомогою OR.

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.either(builder.subject.contains("test"), builder.from_address.contains("noreply@host.com"))

Застосування чутливих до регістру фільтрів

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

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("noreply@host.com", True)

Python-Net: Увімкнути журналювання активності POP3‑сервера в Python

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

Журналювання активності дозволяє відстежувати та записувати дії, виконані POP3‑клієнтом під час підключення та взаємодії з POP3‑сервером. Увімкнення цієї функції полегшує діагностику, підвищує моніторинг безпеки та підтримує відповідність політикам збереження даних і конфіденційності.

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

Створіть екземпляр Pop3Client, вказуючи хост, порт, ім’я користувача та пароль, а також параметри безпеки.
Вкажіть шлях до файлу журналу, використовуючи log_file_name властивість.
За бажанням, налаштуйте параметри журналювання, встановивши use_date_in_log_file_name властивість, якщо потрібно.

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
# Set the path to the log file using the LogFileName property.
client.log_file_name = "C:\\Aspose.Email.Pop3.log"
# Set the UseDateInLogFileName property if it is necessary.
client.use_date_in_log_file_name = False