flanker

 
 

Отворена Python библиотека за разбиране на имейли

Разбор на имейл адреси, валидиране на адреси и разбиране на MIME съобщения чрез отворен безплатен Python API.

Какво е flanker?

flanker е отворена Python библиотека, разработена от Mailgun за парсиране на имейл адреси и MIME съобщения. Тя предоставя мощни инструменти за валидиране на имейл адреси, парсиране на сложни списъци с адреси и извличане на структурирани данни от MIME съобщения. Проектирана за продукционна употреба, flanker поддържа както Python 2.7, така и Python 3.6+, което я прави идеална за разработчиците, създаващи приложения с голямо количество имейли, като пощенски процесинг пайплайни, CRM интеграции и системи за известия.

Библиотеката се състои от два основни модула: `flanker.addresslib` за парсиране и валидиране на имейл адреси и `flanker.mime` за парсиране на MIME съобщения. Тя поддържа строг и нестрог режим на парсиране, валидиране на DNS/MX записи и подробни доклади за грешки. Със своя чист API и минимални зависимости, flanker позволява на разработчиците надеждно да обработват имейл данни без да разчитат на външни бинарни файлове или сложни зависимости. Широкото ѝ използване в инфраструктурата на Mailgun осигурява стабилност и производителност в среди с висок обем.

Previous Next

Започване с 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 обекти. Можете да извличате заглавки, декодирате тела, откривате типове съдържание и лесно навигирате в multipart структури. Библиотеката автоматично се грижи за кодиране, конверсия на набор от знаци и вложени 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, запазването на прикачени файлове или възстановяването на съобщения за препращане или архивиране — идеално за имейл клиенти, инструменти за резервно копиране и системи за съответствие.

Как да обработим multipart съобщения и да извлечем прикачени файлове?

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)}")
 Български