
flanker
E-poçt Parçalamaq üçün Açıq Mənbəli Python Kitabxanası
E-poçt Ünvanlarını Parçalayın, Ünvanları Doğrulayın və Açıq Mənbəli Pulsuz Python API vasitəsilə MIME Mesajlarını Parçalayın.
Flanker nədir?
flanker, Mailgun tərəfindən e-poçt ünvanlarını və MIME mesajlarını təhlil etmək üçün hazırlanmış açıq mənbəli Python kitabxanasıdır. O, e-poçt ünvanlarını təsdiqləmək, mürəkkəb ünvan siyahılarını təhlil etmək və MIME mesajlarından strukturlaşdırılmış məlumatları çıxarmaq üçün güclü alətlər təqdim edir. İstehsal mühiti üçün nəzərdə tutulmuş flanker, həm Python 2.7, həm də Python 3.6+ versiyalarını dəstəkləyir, bu da e-poçt yönümlü tətbiqlər, məsələn, poçt emalı boru kəmərləri, CRM inteqrasiyaları və bildiriş sistemləri yaradan inkişafçılar üçün ideal edir.
Kitabxana iki əsas moduldan ibarətdir: `flanker.addresslib` e-poçt ünvanlarını təhlil etmək və təsdiqləmək üçün, və `flanker.mime` MIME mesajlarını təhlil etmək üçün. O, sərt və yumşaq təhlil rejimlərini, DNS/MX qeydlərinin təsdiqlənməsini və ətraflı səhv hesabatını dəstəkləyir. Təmiz API‑si və minimal asılılıqları ilə flanker, inkişafçılara xarici ikili fayllara və ya mürəkkəb asılılıqlara ehtiyac duymadan e-poçt məlumatlarını etibarlı şəkildə emal etməyə imkan verir. Mailgun‑un infrastrukturunda geniş yayılmış istifadəsi yüksək həcmli mühitlərdə sabitlik və performans təmin edir.
Flanker ilə başlamaq
flanker ilə başlamaq üçün əvvəlcə Python başlıqları quraşdırılmalıdır. Ubuntu-da `sudo apt-get install python-dev` əmrini icra edin; Fedora-da isə `sudo yum install python-devel` istifadə edin. Daha sonra pip vasitəsilə quraşdırın: `pip install flanker`. Alternativ olaraq, [flanker GitHub](https://github.com/mailgun/flanker) deposunu klonlayın və `pip install -e .` əmrini icra edin. Kitabxana yüngüldür, asılılıqları azdır və istehsal mühitində istifadəyə hazırdır. Ətraflı sənədləşdirmə və API istinadları layihənin GitHub deposunda mövcuddur.
Flankeri PIP və ya GitHub vasitəsilə quraşdırın
# 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 .
E-poçt ünvanlarını təhlil edin və doğrulayın
flanker e‑poçt ünvanlarını təhlil və təsdiq etmək üçün güclü alətlər təqdim edir. Göstərilən ad ilə tək ünvanı təhlil edə, DNS/MX qeydlərinə qarşı təsdiq edə və ESP qrammatika qaydalarını yoxlaya bilərsiniz. Kitabxana sərt və yumşaq təhlil rejimlərini dəstəkləyir və etibarsız girişlər üçün təhlil edilmiş ünvanları və ya `None` dəyərini qaytara bilir. Həmçinin ünvan siyahılarını idarə edir, təhlil edilmiş ünvanları və təhlil edilə bilməyən fraqmentləri ayrı-ayrılıqda qaytarır. Bu, istifadəçi girişlərini təmizləmək, toplu idxalları təsdiq etmək və e‑poçt əsaslı iş axınlarında məlumat bütövlüyünü təmin etmək üçün ideal edir.
Python vasitəsilə e-poçt ünvanlarını necə təhlil edib doğrulamaq olar?
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 mesajlarını təhlil edin
flanker‑in MIME təhlil modulu (`flanker.mime`) tərtibatçılara xam e‑poçt mesajlarını strukturlaşdırılmış Python obyektlərinə çevirməyə imkan verir. Başlıqları çıxara, məzmunu dekodlaya, məzmun növlərini aşkara çıxara və çox hissəli strukturlarda asanlıqla naviqasiya edə bilərsiniz. Kitabxana kodlaşdırmanı, simvol dəsti konversiyasını və iç-içə MIME hissələrini avtomatik idarə edir. `is_multipart()` və `is_singlepart()` kimi predikatlarla mesaj strukturunu proqramlı şəkildə yoxlaya və hər bir hissəni uyğun şəkildə emal edə bilərsiniz—e‑poçt müştəriləri, arxivləşdirmə sistemləri və ya avtomatlaşdırılmış emal boru kəmərləri yaratmaq üçün ideal.
MIME mesajlarını necə təhlil etmək və Başlıqları & Bədənləri çıxarmaq?
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}")
Başlıqları və metadata çıxarın
flanker, MIME təhlil API‑si vasitəsilə e‑poçt başlıqları və meta‑məlumatlarına zəngin çıxış təmin edir. Başlıqlar Unicode çox dəyərli lüğət kimi qaytarılır, böyük‑kiçik hərfə həssas olmayan axtarışları və strukturlaşdırılmış dəyərləri (məsələn, `Content-Type` növ və parametrlərə ayrılmış) dəstəkləyir. Göndərəni, alıcıyı, mövzunu, tarixi və xüsusi başlıqları asanlıqla əldə edə bilərsiniz. Bu, e‑poçt indeksləşdirməsi, spam filtrasiya, uyğunluq auditləri və dəqiq başlıq təhlilinin vacib olduğu axtarış‑dostu e‑poçt arxivləri yaratmaq üçün xüsusilə faydalıdır.
Python vasitəsilə e-poçt başlıqları və metadata necə çıxarmaq?
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>
Çox hissəli mesajları və əlavələri idarə edin
flanker mürəkkəb çox hissəli mesajlarla, o cümlədən iç-içə hissələr və əlavələrlə işləməyi sadələşdirir. Siz `msg.parts` üzərində iterasiya edərək hər bir MIME hissəsinə daxil ola, onun məzmun tipini yoxlaya və bədənini dekodlaya bilərsiniz. Kitabxana avtomatik olaraq base64 və quoted-printable dekodlaşdırmasını, xarakter dəsti çevirməsini və sərhəd aşkarlamasını idarə edir. Bu, text/plain və text/html versiyalarını çıxarmağı, əlavələri saxlamağı və ya mesajları yönləndirmə və ya arxivləşdirmə üçün yenidən qurmağı asanlaşdırır—e-poçt müştəriləri, ehtiyat nüsxə alətləri və uyğunluq sistemləri üçün ideal.
Çox hissəli mesajları necə emal etmək və əlavə faylları çıxarmaq?
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)}")
