
flanker
Відкрита бібліотека Python для парсингу електронної пошти
Парсинг електронних адрес, валідація адрес та парсинг MIME‑повідомлень за допомогою відкритого безкоштовного API Python.
Що таке flanker?
flanker — це бібліотека Python з відкритим кодом, розроблена Mailgun для розбору електронних адрес та MIME‑повідомлень. Вона надає потужні інструменти для перевірки електронних адрес, розбору складних списків адрес і витягнення структурованих даних з MIME‑повідомлень. Розроблена для використання у продакшн‑середовищах, flanker підтримує як Python 2.7, так і Python 3.6+, що робить її ідеальною для розробників, які створюють додатки з великою кількістю електронної пошти, такі як конвеєри обробки листів, інтеграції CRM та системи сповіщень.
Бібліотека складається з двох основних модулів: `flanker.addresslib` для розбору та перевірки електронних адрес і `flanker.mime` для розбору MIME‑повідомлень. Вона підтримує строгі та м’які режими розбору, перевірку записів DNS/MX та детальне повідомлення про помилки. Завдяки чистому API та мінімальним залежностям, flanker дозволяє розробникам надійно обробляти дані електронної пошти без потреби у зовнішніх бінарних файлах чи складних залежностях. Широке використання у інфраструктурі Mailgun забезпечує стабільність і продуктивність у середовищах з великим обсягом трафіку.
Початок роботи з flanker
Щоб розпочати роботу з flanker, спочатку потрібно встановити заголовки Python. На Ubuntu виконайте `sudo apt-get install python-dev`; на Fedora використайте `sudo yum install python-devel`. Потім встановіть через pip: `pip install flanker`. Альтернативно, клонувати репозиторій [flanker GitHub](https://github.com/mailgun/flanker) і виконати `pip install -e .`. Бібліотека легка, має мінімальні залежності та готова до використання у продакшені. Детальна документація та посилання на API доступні у репозиторії GitHub проєкту.
Встановіть flanker через PIP або GitHub
# Ubuntu: install Python headers
sudo apt-get install python-dev
# Install via pip
pip install flanker
# Or clone and install from GitHub
git clone git@github.com:mailgun/flanker.git
cd flanker
pip install -e .
Розбір та перевірка електронних адрес
flanker надає потужні інструменти для розбору та валідації електронних адрес. Ви можете розпарсити одну адресу з відображуваним ім'ям, перевірити її проти записів DNS/MX та перевірити правила граматики ESP. Бібліотека підтримує строгі та м'які режими розбору і може повертати розпарсені адреси або `None` для недійсних вводів. Вона також обробляє списки адрес, повертаючи розпарсені адреси та не розпарсовані фрагменти окремо. Це робить її ідеальною для очищення вводу користувачів, валідації масових імпортів та забезпечення цілісності даних у робочих процесах, що базуються на електронній пошті.
Як розбирати та перевіряти електронні адреси за допомогою Python?
from flanker.addresslib import address
# Parse single address with display name
addr = address.parse('John Doe <john@example.com>')
print(addr) # John Doe <john@example.com>
# Validate with DNS/MX checks
valid = address.validate_address('john@mailgun.com')
print(valid) # john@mailgun.com
# Parse list and separate valid/unparseable
parsed, failed = address.parse_list(['john@example.com, @invalid'], as_tuple=True)
print(parsed, failed) # [john@example.com], ['@invalid']
Розбір MIME-повідомлень
Модуль парсингу MIME у flanker (`flanker.mime`) дозволяє розробникам аналізувати необроблені електронні листи у структуровані об’єкти Python. Ви можете витягувати заголовки, декодувати тіла, визначати типи вмісту та легко орієнтуватися у багаточастинних структурах. Бібліотека автоматично обробляє кодування, конвертацію набору символів та вкладені MIME-частини. За допомогою предикатів, таких як `is_multipart()` і `is_singlepart()`, ви можете програмно досліджувати структуру повідомлення та обробляти кожну частину відповідно — ідеально підходить для створення поштових клієнтів, систем архівування або автоматизованих конвеєрів обробки.
Як розбирати MIME‑повідомлення та витягати заголовки та тіла?
from flanker import mime
# Parse raw MIME message
msg = mime.from_string(raw_message)
# Extract headers
headers = msg.headers.items()
# Check content type
is_multipart = msg.content_type.is_multipart()
# Decode body (handles multipart automatically)
for part in msg.parts:
print(f"Content-Type: {part.content_type}")
print(f"Body: {part.body}")
Витягування заголовків та метаданих
flanker забезпечує широкий доступ до заголовків електронної пошти та метаданих через свій API парсингу MIME. Заголовки повертаються як багатозначний словник Unicode, підтримуючи нечутливі до регістру пошуки та структуровані значення (наприклад, `Content-Type`, розібраний на тип і параметри). Ви можете легко отримати відправника, одержувача, тему, дату та користувацькі заголовки. Це особливо корисно для індексації електронної пошти, фільтрації спаму, аудиту відповідності та створення пошукових архівів електронної пошти, де критично важливий точний парсинг заголовків.
Як витягти заголовки електронної пошти та метадані за допомогою Python?
from flanker import mime
msg = mime.from_string(raw_message)
# Get all headers as list of tuples
for key, value in msg.headers.items():
print(f"{key}: {value}")
# Access structured content-type
ctype = msg.content_type
print(f"Type: {ctype.type}, Boundary: {ctype.boundary}")
# Get raw header value
raw_from = msg.headers.get('From')
print(raw_from) # Bob <bob@example.com>
Обробка багаточастинних повідомлень та вкладень
flanker спрощує роботу зі складними multipart повідомленнями, включаючи ті, що містять вкладені частини та прикріплення. Ви можете ітерувати `msg.parts`, щоб отримати доступ до кожної MIME‑частини, перевірити її тип вмісту та декодувати тіло. Бібліотека автоматично обробляє декодування base64 та quoted‑printable, конвертацію кодування символів і виявлення меж. Це робить простим витягування версій text/plain і text/html, збереження прикріплень або перебудову повідомлень для пересилання чи архівування — ідеально підходить для поштових клієнтів, інструментів резервного копіювання та систем відповідності.
Як обробляти багаточастинні повідомлення та витягати вкладення?
from flanker import mime
msg = mime.from_string(raw_message)
# Iterate over parts
for part in msg.parts:
if part.content_type.is_text():
print(f"Text part: {part.body}")
elif part.content_type.is_attachment():
filename = part.content_type.filename
payload = part.body
print(f"Attachment: {filename}, size: {len(payload)}")
