1. Produkti
  2.   E-pasts
  3.   Python
  4.   flanker

flanker

 
 

Atvērtā koda Python bibliotēka e-pasta parsēšanai

Parsējiet e-pasta adreses, validējiet adreses un parsējiet MIME ziņojumus, izmantojot atvērtā koda bezmaksas Python API.

Kas ir flanker?

flanker ir atvērtā koda Python bibliotēka, ko izstrādājusi Mailgun, lai parsētu e-pasta adreses un MIME ziņojumus. Tā nodrošina stabilus rīkus e-pasta adrešu validēšanai, sarežģītu adrešu sarakstu parsēšanai un strukturētu datu izguvei no MIME ziņojumiem. Izstrādāta ražošanas lietošanai, flanker atbalsta gan Python 2.7, gan Python 3.6+, padarot to par ideālu izstrādātājiem, kas veido e-pastu intensīvas lietojumprogrammas, piemēram, pasta apstrādes cauruļvadu, CRM integrācijas un paziņojumu sistēmas.

Bibliotēka sastāv no diviem galvenajiem moduļiem: `flanker.addresslib` e-pasta adrešu parsēšanai un validēšanai, un `flanker.mime` MIME ziņojumu parsēšanai. Tā atbalsta stingrus un laužīgus parsēšanas režīmus, DNS/MX ierakstu validēšanu un detalizētu kļūdu ziņošanu. Ar tīru API un minimālām atkarībām flanker ļauj izstrādātājiem uzticami apstrādāt e-pasta datus, nepaļaujoties uz ārējiem bināriem vai sarežģītām atkarībām. Plašais tās lietojums Mailgun infrastruktūrā nodrošina stabilitāti un veiktspēju augstas apjoma vidēs.

Previous Next

Sākšana ar flanker

Lai sāktu darbu ar flanker, vispirms jāinstalē Python galvenes. Ubuntu sistēmā izpildiet `sudo apt-get install python-dev`; Fedora gadījumā izmantojiet `sudo yum install python-devel`. Pēc tam instalējiet, izmantojot pip: `pip install flanker`. Alternatīvi, klonējiet [flanker GitHub](https://github.com/mailgun/flanker) repozitoriju un izpildiet `pip install -e .`. Bibliotēka ir viegla, ar minimālām atkarībām, un gatava ražošanas lietošanai. Plaša dokumentācija un API atsauces ir pieejamas projekta GitHub repozitorijā.

Instalējiet flanker, izmantojot PIP vai 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 .

Parsēt un pārbaudīt e-pasta adreses

flanker nodrošina jaudīgus rīkus e-pasta adrešu parsēšanai un validēšanai. Jūs varat parsēt vienu adresi ar parādāmo vārdu, validēt pret DNS/MX ierakstiem un pārbaudīt ESP gramatikas noteikumus. Bibliotēka atbalsta stingru un laužīgu parsēšanas režīmu, un var atgriezt parsētās adreses vai `None` nederīgiem ievades datiem. Tā arī apstrādā adrešu sarakstus, atsevišķi atgriežot parsētās adreses un neparsējamus fragmentus. Tas padara to par ideālu risinājumu lietotāju ievades tīrīšanai, masveida importu validēšanai un datu integritātes nodrošināšanai e-pasta vadītajos darba plūsmos.

Kā parsēt un pārbaudīt e-pasta adreses, izmantojot 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']

Parsēt MIME ziņojumus

flanker’s MIME parsing module (`flanker.mime`) ļauj izstrādātājiem parsēt neapstrādātus e-pasta ziņojumus strukturētos Python objektos. Jūs varat izvilkt galvenes, atkodēt ķermeņus, noteikt satura tipus un viegli pārvietoties pa multipart struktūrām. Bibliotēka automātiski apstrādā kodējumu, rakstzīmju kopas konvertēšanu un ligzdotus MIME daļas. Ar tādiem predikātiem kā `is_multipart()` un `is_singlepart()`, jūs varat programmatiski pārbaudīt ziņojuma struktūru un attiecīgi apstrādāt katru daļu — ideāli piemērots e-pasta klientu, arhivēšanas sistēmu vai automatizētu apstrādes cauruļvadu izveidei.

Kā parsēt MIME ziņojumus un izvilkt galvenes un ķermeņus?

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

Izvilkt galvenes un metadatus

flanker nodrošina plašu piekļuvi e-pasta galvenēm un metadatiem, izmantojot savu MIME parsēšanas API. Galvenes tiek atgrieztas kā Unicode daudzvērtību vārdnīca, kas atbalsta reģistrneatkarīgu meklēšanu un strukturētas vērtības (piemēram, `Content-Type` parsēts tipā un parametros). Jūs varat viegli izgūt sūtītāju, saņēmēju, tēmu, datumu un pielāgotas galvenes. Tas ir īpaši noderīgs e-pasta indeksēšanai, surogātpasta filtrēšanai, atbilstības auditam un meklētājam draudzīgu e-pasta arhīvu izveidei, kur precīza galveņu parsēšana ir kritiska.

Kā izvilkt e-pasta galvenes un metadatus, izmantojot 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>

Apstrādāt daudzdaļas ziņojumus un pielikumus

flanker vienkāršo darbu ar sarežģītiem multipart ziņojumiem, ieskaitot tos, kuriem ir iekļautas daļas un pielikumi. Jūs varat iterēt pāri `msg.parts`, lai piekļūtu katram MIME daļai, pārbaudītu tās satura tipu un atkodētu ķermeni. Bibliotēka automātiski apstrādā base64 un quoted‑printable atkodēšanu, rakstzīmju kopas konvertēšanu un robežu noteikšanu. Tas ļauj vienkārši izvilkt text/plain un text/html versijas, saglabāt pielikumus vai pārveidot ziņojumus pārsūtīšanai vai arhivēšanai — ideāli e-pasta klientiem, dublēšanas rīkiem un atbilstības sistēmām.

Kā apstrādāt multipart ziņojumus un izvilkt pielikumus?

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