flanker

 
 

Avoimen lähdekoodin Python-kirjasto sähköpostin jäsentämiseen

Jäsennä sähköpostiosoitteet, vahvista osoitteet & jäsennä MIME-viestit avoimen lähdekoodin ilmaisen Python-API:n kautta.

Mikä on flanker?

flanker on avoimen lähdekoodin Python-kirjasto, jonka on kehittänyt Mailgun sähköpostiosoitteiden ja MIME-viestien jäsentämiseen. Se tarjoaa vankat työkalut sähköpostiosoitteiden vahvistamiseen, monimutkaisten osoiteluetteloiden jäsentämiseen ja rakenteellisen datan poimimiseen MIME-viesteistä. Tuotantokäyttöön suunniteltu flanker tukee sekä Python 2.7:ää että Python 3.6+:aa, mikä tekee siitä ihanteellisen kehittäjille, jotka rakentavat sähköpostia hyödyntäviä sovelluksia, kuten postinkäsittelyputkia, CRM-integraatioita ja ilmoitusjärjestelmiä.

Kirjasto koostuu kahdesta ydinkomponentista: `flanker.addresslib` sähköpostiosoitteiden jäsentämiseen ja vahvistamiseen, ja `flanker.mime` MIME-viestien jäsentämiseen. Se tukee tiukkaa ja löysää jäsentämistilaa, DNS/MX-tietueiden vahvistamista sekä yksityiskohtaista virheraportointia. Selkeän API:n ja vähäisten riippuvuuksien ansiosta flanker mahdollistaa kehittäjille luotettavan sähköpostidatan käsittelyn ilman ulkoisten binäärien tai monimutkaisten riippuvuuksien tarvetta. Sen laaja käyttö Mailgunin infrastruktuurissa takaa vakauden ja suorituskyvyn suurten volyymien ympäristöissä.

Previous Next

Aloita flankerin käyttö

Jotta pääset alkuun flankerin kanssa, sinun on ensin asennettava Python-otsakkeet. Ubuntussa suorita `sudo apt-get install python-dev`; Fedora:ssa käytä `sudo yum install python-devel`. Asenna sitten pipin avulla: `pip install flanker`. Vaihtoehtoisesti kloonaa [flanker GitHub](https://github.com/mailgun/flanker) -repo ja suorita `pip install -e .`. Kirjasto on kevyt, sillä on minimaaliset riippuvuudet, ja se on valmis tuotantokäyttöön. Yksityiskohtainen dokumentaatio ja API-viitteet ovat saatavilla projektin GitHub-repossa.

Asenna flanker PIP:n tai GitHubin kautta

# 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 .

Jäsennä ja vahvista sähköpostiosoitteet

flanker tarjoaa tehokkaita työkaluja sähköpostiosoitteiden jäsentämiseen ja validointiin. Voit jäsentää yksittäisen osoitteen näyttönimen kanssa, validoida DNS/MX-tietueita vastaan ja tarkistaa ESP-syntaksisäännöt. Kirjasto tukee tiukkaa ja löysää jäsentämistilaa, ja se voi palauttaa jäsennetyt osoitteet tai `None` virheellisille syötteille. Se käsittelee myös osoitelistoja, palauttaen jäsennetyt osoitteet ja jäsentämättömät fragmentit erikseen. Tämä tekee siitä ihanteellisen käyttäjän syötteen puhdistamiseen, massatuontien validointiin ja tietojen eheyden varmistamiseen sähköpostipohjaisissa työnkuluissa.

Kuinka jäsentää ja vahvistaa sähköpostiosoitteet Pythonin avulla?

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']

Jäsennä MIME-viestit

flankerin MIME-jäsennysmoduuli (`flanker.mime`) mahdollistaa kehittäjille raakaviestien jäsentämisen rakenteellisiksi Python-objekteiksi. Voit poimia otsikot, purkaa rungot, tunnistaa sisältötyypit ja navigoida moniosaisissa rakenteissa helposti. Kirjasto käsittelee koodauksen, merkistömuunnoksen ja sisäkkäiset MIME-osat automaattisesti. Predikaattien kuten `is_multipart()` ja `is_singlepart()` avulla voit ohjelmallisesti tarkastella viestin rakennetta ja käsitellä kutakin osaa vastaavasti—ihanteellinen sähköpostiasiakkaiden, arkistointijärjestelmien tai automatisoitujen käsittelyputkien rakentamiseen.

Kuinka jäsentää MIME-viestejä ja poimia otsikot & rungot?

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}")

Poimi otsikot ja metadata

flanker tarjoaa laajan pääsyn sähköpostin otsakkeisiin ja metatietoihin MIME-jäsennys-API:n kautta. Otsakkeet palautetaan Unicode-monoarvoisena sanakirjana, joka tukee kirjainkoolla riippumattomia hakuja ja rakenteellisia arvoja (esim. `Content-Type` purettuna tyyppiin ja parametreihin). Voit hakea lähettäjän, vastaanottajan, aiheen, päivämäärän ja mukautetut otsakkeet helposti. Tämä on erityisen hyödyllistä sähköpostien indeksoinnissa, roskapostisuodatuksessa, vaatimustenmukaisuuden tarkastuksessa ja hakukoneystävällisten sähköpostivarastojen rakentamisessa, joissa tarkka otsakkeiden jäsentäminen on kriittistä.

Kuinka poimia sähköpostin otsikot ja metatiedot Pythonin avulla?

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>

Käsittele moniosaisia viestejä ja liitteitä

flanker yksinkertaistaa monimutkaisten multipart-viestien käsittelyä, mukaan lukien sisäkkäiset osat ja liitteet. Voit iteratoida `msg.parts`-kokoelman läpi päästäksesi käsiksi jokaiseen MIME-osaan, tarkastella sen sisältötyyppiä ja dekoodata sen rungon. Kirjasto käsittelee automaattisesti base64- ja quoted-printable-dekoodauksen, merkistömuunnoksen ja rajan tunnistamisen. Tämä tekee tekstin/plain- ja text/html-versioiden poimimisesta, liitteiden tallentamisesta tai viestien uudelleenrakentamisesta edelleenlähettämistä tai arkistointia varten suoraviivaista – ihanteellinen sähköpostiasiakkaille, varmuuskopiointityökaluille ja vaatimustenmukaisuuden järjestelmille.

Kuinka käsitellä moniosaisia viestejä ja poimia liitteet?

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)}")
 Suomen