1. Produkter
  2.   E-mail
  3.   Python
  4.   flanker

flanker

 
 

Open Source Python-bibliotek til e-mail parsing

Parse e-mailadresser, valider adresser og parse MIME-beskeder via Open Source gratis Python API.

Hvad er flanker?

flanker er et open source Python‑bibliotek udviklet af Mailgun til at parse e‑mailadresser og MIME‑beskeder. Det leverer robuste værktøjer til validering af e‑mailadresser, parsing af komplekse adresselister og udtrækning af strukturerede data fra MIME‑beskeder. Designet til produktionsbrug understøtter flanker både Python 2.7 og Python 3.6+, hvilket gør det ideelt for udviklere, der bygger e‑mail‑tunge applikationer såsom mail‑behandlings‑pipelines, CRM‑integrationer og notifikationssystemer.

Biblioteket består af to kerne‑moduler: `flanker.addresslib` til parsing og validering af e‑mailadresser, og `flanker.mime` til parsing af MIME‑beskeder. Det understøtter strenge og lempelige parse‑tilstande, DNS/MX‑postvalidering og detaljeret fejlrapportering. Med sit rene API og minimale afhængigheder gør flanker det muligt for udviklere at pålideligt behandle e‑maildata uden at være afhængig af eksterne binære filer eller komplekse afhængigheder. Dets udbredte brug i Mailguns infrastruktur sikrer stabilitet og ydeevne i miljøer med højt volumen.

Previous Next

Kom i gang med flanker

For at komme i gang med flanker, skal du først have Python‑header‑filer installeret. På Ubuntu kører du `sudo apt-get install python-dev`; på Fedora bruger du `sudo yum install python-devel`. Installér derefter via pip: `pip install flanker`. Alternativt kan du klone [flanker GitHub](https://github.com/mailgun/flanker)‑repoen og køre `pip install -e .`. Biblioteket er letvægts, med minimale afhængigheder, og klar til produktionsbrug. Detaljeret dokumentation og API‑referencer er tilgængelige i projektets GitHub‑repository.

Installer flanker via PIP eller 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 .

Analyser og valider e-mailadresser

flanker leverer kraftfulde værktøjer til parsning og validering af e‑mailadresser. Du kan parse en enkelt adresse med visningsnavn, validere mod DNS/MX‑poster og tjekke ESP‑grammatikregler. Biblioteket understøtter strenge og lempelige parsningstilstande og kan returnere parse‑adresser eller `None` for ugyldige input. Det håndterer også adresselister og returnerer parse‑adresser og uparsbare fragmenter separat. Dette gør det ideelt til at rense brugerinput, validere masseimport og sikre dataintegritet i e‑mail‑baserede arbejdsgange.

Hvordan analyserer og validerer man e-mailadresser via 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']

Analyser MIME-beskeder

flankers MIME‑parsemodul (`flanker.mime`) gør det muligt for udviklere at parse rå e‑mail‑beskeder til strukturerede Python‑objekter. Du kan udtrække headers, dekode indhold, opdage indholdstyper og navigere i multipart‑strukturer med lethed. Biblioteket håndterer kodning, tegnsæt‑konvertering og indlejrede MIME‑dele automatisk. Med prædikater som `is_multipart()` og `is_singlepart()` kan du programmatisk inspicere beskedstrukturen og behandle hver del tilsvarende—ideelt til at bygge e‑mail‑klienter, arkiveringssystemer eller automatiserede behandlings‑pipelines.

Hvordan parser man MIME-beskeder og udtrækker overskrifter og brødtekst?

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

Udtræk overskrifter og metadata

flanker giver rig adgang til e‑mail‑headers og metadata via sit MIME‑parse‑API. Headers returneres som en Unicode‑multi‑value‑dictionary, der understøtter case‑insensitive opslag og strukturerede værdier (f.eks. `Content-Type` parsed til type og parametre). Du kan nemt hente afsender, modtager, emne, dato og brugerdefinerede headers. Dette er især nyttigt til e‑mail‑indeksering, spam‑filtrering, overholdelses‑audit, og opbygning af søgevenlige e‑mail‑arkiver, hvor præcis header‑parsing er kritisk.

Hvordan udtrækker man e‑mail‑overskrifter og metadata via 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>

Håndter multipart-beskeder og vedhæftede filer

flanker forenkler arbejdet med komplekse multipart-beskeder, inklusive dem med indlejrede dele og vedhæftede filer. Du kan iterere over `msg.parts` for at få adgang til hver MIME-del, inspicere dens indholdstype og dekode dens krop. Biblioteket håndterer automatisk base64- og quoted‑printable‑dekodning, tegnsætningskonvertering og grænsedetektion. Dette gør det ligetil at udtrække text/plain‑ og text/html‑versioner, gemme vedhæftede filer eller genopbygge beskeder til videresendelse eller arkivering – ideelt til e‑mailklienter, backupværktøjer og overholdelsessystemer.

Hvordan behandler man multipart‑beskeder og udtrækker vedhæftede filer?

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