
flanker
E-posta Ayrıştırma için Açık Kaynak Python Kütüphanesi
E-posta Adreslerini Ayrıştırın, Adresleri Doğrulayın ve Açık Kaynak Ücretsiz Python API'si ile MIME Mesajlarını Ayrıştırın.
Flanker nedir?
flanker, Mailgun tarafından e-posta adreslerini ve MIME mesajlarını ayrıştırmak için geliştirilen açık kaynaklı bir Python kütüphanesidir. E-posta adreslerini doğrulamak, karmaşık adres listelerini ayrıştırmak ve MIME mesajlarından yapılandırılmış verileri çıkarmak için sağlam araçlar sunar. Üretim kullanımına yönelik tasarlanan flanker, Python 2.7 ve Python 3.6+ sürümlerini destekleyerek, posta işleme hatları, CRM entegrasyonları ve bildirim sistemleri gibi e-posta yoğun uygulamalar geliştiren geliştiriciler için ideal bir seçimdir.
Kütüphane, e-posta adreslerini ayrıştırmak ve doğrulamak için `flanker.addresslib` ve MIME mesajlarını ayrıştırmak için `flanker.mime` olmak üzere iki temel modülden oluşur. Katı ve esnek ayrıştırma modlarını, DNS/MX kaydı doğrulamasını ve ayrıntılı hata raporlamasını destekler. Temiz API'si ve minimum bağımlılıkları sayesinde flanker, geliştiricilerin harici ikili dosyalara veya karmaşık bağımlılıklara ihtiyaç duymadan e-posta verilerini güvenilir bir şekilde işlemelerini sağlar. Mailgun altyapısında yaygın kullanımı, yüksek hacimli ortamlarda istikrar ve performans garantiler.
Flanker ile Başlarken
flanker ile başlamadan önce Python başlıklarının yüklü olması gerekir. Ubuntu’da `sudo apt-get install python-dev` komutunu çalıştırın; Fedora’da ise `sudo yum install python-devel` kullanın. Ardından pip ile kurun: `pip install flanker`. Alternatif olarak, [flanker GitHub](https://github.com/mailgun/flanker) deposunu klonlayıp `pip install -e .` komutunu çalıştırabilirsiniz. Kütüphane hafiftir, minimum bağımlılığa sahiptir ve üretim kullanımına hazırdır. Ayrıntılı belgeler ve API referansları projenin GitHub deposunda mevcuttur.
flanker'ı PIP veya GitHub üzerinden kurun
# 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-posta Adreslerini Ayrıştır ve Doğrula
flanker, e-posta adreslerini ayrıştırmak ve doğrulamak için güçlü araçlar sunar. Tek bir adresi görüntü adıyla ayrıştırabilir, DNS/MX kayıtlarına karşı doğrulayabilir ve ESP dilbilgisi kurallarını kontrol edebilirsiniz. Kütüphane katı ve esnek ayrıştırma modlarını destekler ve geçersiz girdiler için ayrıştırılmış adresleri ya da `None` değerini döndürebilir. Ayrıca adres listelerini işler, ayrıştırılmış adresleri ve ayrıştırılamayan parçaları ayrı ayrı döndürür. Bu, kullanıcı girdilerini temizlemek, toplu ithalatları doğrulamak ve e-posta odaklı iş akışlarında veri bütünlüğünü sağlamak için idealdir.
Python ile E-posta Adreslerini Nasıl Ayrıştırıp Doğrularız?
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ı Ayrıştır
flanker’ın MIME ayrıştırma modülü (`flanker.mime`) geliştiricilerin ham e-posta mesajlarını yapılandırılmış Python nesnelerine ayrıştırmasını sağlar. Başlıkları çıkarabilir, gövdeleri çözebilir, içerik türlerini tespit edebilir ve çok parçalı yapılar arasında kolayca gezinebilirsiniz. Kütüphane kodlamayı, karakter seti dönüşümünü ve iç içe MIME bölümlerini otomatik olarak yönetir. `is_multipart()` ve `is_singlepart()` gibi öncüllerle, mesaj yapısını programlı olarak inceleyebilir ve her bölümü buna göre işleyebilirsiniz—e-posta istemcileri, arşivleme sistemleri veya otomatik işleme hatları oluşturmak için idealdir.
MIME Mesajlarını Nasıl Ayrıştırır ve Başlıkları & Gövdeleri Nasıl Çıkarırsınız?
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ıkları ve Metaverileri Çıkar
flanker, MIME ayrıştırma API'si aracılığıyla e-posta başlıkları ve meta verilere zengin erişim sağlar. Başlıklar, Unicode çok değerli bir sözlük olarak döndürülür; büyük/küçük harf duyarsız aramaları ve yapılandırılmış değerleri (örneğin, `Content-Type` tip ve parametrelere ayrıştırılır) destekler. Gönderen, alıcı, konu, tarih ve özel başlıkları kolayca alabilirsiniz. Bu, özellikle e-posta indeksleme, istenmeyen e-posta filtreleme, uyumluluk denetimi ve kesin başlık ayrıştırmanın kritik olduğu, arama dostu e-posta arşivleri oluşturmak için faydalıdır.
Python ile E-posta Başlıklarını ve Metaverileri Nasıl Çıkarırsınız?
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>
Çok Parçalı Mesajları ve Ekleri İşle
flanker, iç içe parçalar ve ekler dahil olmak üzere karmaşık çok parçalı mesajlarla çalışmayı basitleştirir. Her MIME parçasına erişmek, içerik tipini incelemek ve gövdesini çözümlemek için `msg.parts` üzerinde döngü yapabilirsiniz. Kütüphane, base64 ve quoted‑printable kod çözümlemesini, karakter seti dönüşümünü ve sınır tespitini otomatik olarak yönetir. Bu, text/plain ve text/html sürümlerini çıkarmayı, ekleri kaydetmeyi veya iletim ya da arşivleme için mesajları yeniden oluşturmayı kolaylaştırır—e‑posta istemcileri, yedekleme araçları ve uyumluluk sistemleri için idealdir.
Çok Parçalı Mesajları Nasıl İşlersiniz ve Ekleri Nasıl Çıkarırsınız?
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)}")
