
flanker
Atviro kodo Python biblioteka el. pašto analizavimui
Analizuokite el. pašto adresus, patikrinkite adresus ir analizuokite MIME žinutes naudojant atviro kodo nemokamą Python API.
Kas yra flanker?
flanker yra atviro kodo Python biblioteka, sukurta Mailgun, skirta el. pašto adresų ir MIME žinučių analizavimui. Ji suteikia patikimus įrankius el. pašto adresų tikrinimui, sudėtingų adresų sąrašų analizavimui ir struktūruotų duomenų išgavimui iš MIME žinučių. Sukurta naudoti gamyboje, flanker palaiko tiek Python 2.7, tiek Python 3.6+, todėl yra idealus kūrėjams, kuriant el. paštu intensyvias programas, tokias kaip pašto apdorojimo kanalai, CRM integracijos ir pranešimų sistemos.
Biblioteka susideda iš dviejų pagrindinių modulių: `flanker.addresslib` – el. pašto adresų analizavimui ir tikrinimui, ir `flanker.mime` – MIME žinučių analizavimui. Ji palaiko griežtą ir lankstų analizės režimus, DNS/MX įrašų tikrinimą ir išsamų klaidų pranešimą. Dėl švarios API ir minimalios priklausomybės, flanker leidžia kūrėjams patikimai apdoroti el. pašto duomenis nenaudojant išorinių binarinių failų ar sudėtingų priklausomybių. Jos plačiai naudojimas Mailgun infrastruktūroje užtikrina stabilumą ir našumą didelio apimties aplinkoje.
Pradžia su flanker
Norėdami pradėti naudoti flanker, pirmiausia turite įdiegti Python antraštes. Ubuntu sistemoje vykdykite `sudo apt-get install python-dev`; Fedora – naudokite `sudo yum install python-devel`. Tada įdiekite per pip: `pip install flanker`. Alternatyviai, klonuokite [flanker GitHub](https://github.com/mailgun/flanker) saugyklą ir vykdykite `pip install -e .`. Biblioteka yra lengva, su minimaliomis priklausomybėmis, ir paruošta gamybos naudojimui. Išsamus dokumentacija ir API nuorodos prieinamos projekto GitHub saugykloje.
Įdiekite flanker per PIP arba 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 .
Analizuoti ir patikrinti el. pašto adresus
flanker suteikia galingus įrankius el. pašto adresų analizavimui ir tikrinimui. Galite analizuoti vieną adresą su rodomuoju vardu, patikrinti pagal DNS/MX įrašus ir patikrinti ESP gramatikos taisykles. Biblioteka palaiko griežtą ir lankstų analizės režimus ir gali grąžinti išanalizuotus adresus arba `None` neteisingiems įvestims. Ji taip pat tvarko adresų sąrašus, atskirai grąžindama išanalizuotus adresus ir neanalizuojamus fragmentus. Tai daro ją idealia naudoti vartotojų įvesties valymui, masinių importų tikrinimui ir duomenų vientisumo užtikrinimui el. pašto pagrindu veikiančiuose procesų srautuose.
Kaip analizuoti ir patikrinti el. pašto adresus naudojant 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']
Analizuoti MIME žinutes
flanker’s MIME analizės modulis (`flanker.mime`) leidžia kūrėjams analizuoti neapdorotas el. laiškų žinutes į struktūruotus Python objektus. Galite išgauti antraštes, dekoduoti turinį, aptikti turinio tipus ir lengvai naršyti po daugelio dalių struktūras. Biblioteka automatiškai tvarko kodavimą, šriftų konversiją ir įdėtines MIME dalis. Naudodami predikatus, tokius kaip `is_multipart()` ir `is_singlepart()`, galite programiškai patikrinti žinutės struktūrą ir apdoroti kiekvieną dalį atitinkamai – puiku kuriant el. pašto klientus, archyvavimo sistemas arba automatizuotas apdorojimo konvejerius.
Kaip analizuoti MIME žinutes ir išgauti antraštes bei turinį?
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}")
Išgauti antraštes ir metaduomenis
flanker suteikia išsamų priėjimą prie el. laiškų antraščių ir metaduomenų per savo MIME analizės API. Antraštės grąžinamos kaip Unicode daugiaverčių žodynas, palaikantis ne jautrius įvesties atvejus ir struktūruotas reikšmes (pvz., `Content-Type` išskaidytas į tipą ir parametrus). Galite lengvai gauti siuntėją, gavėją, temą, datą ir pasirinktines antraštes. Tai ypač naudinga el. laiškų indeksavimui, šlamšto filtravimui, atitikties auditui ir kuriant paieškai pritaikytus el. pašto archyvus, kur tikslus antraščių analizavimas yra kritiškas.
Kaip išgauti el. pašto antraštes ir metaduomenis naudojant 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>
Tvarkyti daugelio dalių žinutes ir priedus
flanker supaprastina darbą su sudėtingomis daugelio dalių žinutėmis, įskaitant tas, kuriose yra įdėtos dalys ir priedai. Galite iteruoti per `msg.parts`, kad pasiektumėte kiekvieną MIME dalį, patikrintumėte jos turinio tipą ir iškoduotumėte kūną. Biblioteka automatiškai tvarko base64 ir quoted‑printable dekodavimą, koduotės konversiją ir ribų aptikimą. Tai leidžia lengvai išgauti text/plain ir text/html versijas, išsaugoti priedus arba atkurti žinutes persiuntimui ar archyvavimui – puiku el. pašto klientams, atsarginių kopijų įrankiams ir atitikties sistemoms.
Kaip apdoroti daugelio dalių žinutes ir išgauti priedus?
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)}")
