
flanker
Leabharlann Python Foinse Oscailte le haghaidh Parsáil Ríomhphoist
Parsaigh Seoltaí Ríomhphoist, Bailíochtú Seoltaí & Parsaigh Teachtaireachtaí MIME trí API Python Saor Foinse Oscailte.
Cad é flanker?
Is leabharlann Python foinse oscailte é flanker a d'fhorbair Mailgun chun seoltaí ríomhphoist agus teachtaireachtaí MIME a pharsáil. Soláthraíonn sé uirlisí láidre chun seoltaí ríomhphoist a bhailíochtú, liostaí seoltaí casta a pharsáil, agus sonraí struchtúrtha a bhaint as teachtaireachtaí MIME. Dearadh é le húsáid i dtáirgeadh, tacaíonn flanker le Python 2.7 agus Python 3.6+, rud a fhágann go bhfuil sé foirfe do fhorbróirí a thógann feidhmchláir tromchúiseacha ríomhphoist ar nós píblíní próiseála poist, comhtháite CRM, agus córais fógra.
Tá an leabharlann comhdhéanta de dhá mhodúl croí: `flanker.addresslib` chun seoltaí ríomhphoist a pharsáil agus a bhailíochtú, agus `flanker.mime` chun teachtaireachtaí MIME a pharsáil. Tacaíonn sé le módanna parsála dian agus éadrom, bailíochtú taifid DNS/MX, agus tuairisciú miontuairisceanna. Le a API glan agus spleáchais íosta, cuireann flanker ar chumas forbróirí sonraí ríomhphoist a phróiseáil go iontaofa gan brath ar bhinaryanna seachtracha nó spleáchais chasta. Cinntíonn a úsáid forleathan i bhfrámaíocht Mailgun cobhsaíocht agus feidhmíocht i dtimpeallachtaí le mórmhéid.
Ag tosú le flanker
Chun tosú le flanker, ní mór duit ceanntásca Python a shuiteáil ar dtús. Ar Ubuntu, rith `sudo apt-get install python-dev`; ar Fedora, bain úsáid as `sudo yum install python-devel`. Ansin suiteáil trí pip: `pip install flanker`. Mar mhalairt, clónáil an [flanker GitHub](https://github.com/mailgun/flanker) agus rith `pip install -e .`. Tá an leabharlann éadrom, le spleáchais íosta, agus réidh le húsáid i dtáirgeadh. Tá doiciméadú mionsonraithe agus tagairtí API ar fáil i stór GitHub an tionscadail.
Suiteáil flanker trí PIP nó 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 .
Dípharsáil agus Bailíochtú Seoltaí Ríomhphoist
tá uirlisí cumhachtacha ag flanker le parsáil agus bailíochtú seoltaí ríomhphoist. Is féidir leat seoladh singil le hainm taispeána a pharsáil, bailíochtú i gcoinne taifid DNS/MX, agus rialacha gramadaí ESP a sheiceáil. Tacaíonn an leabharlann le módanna parsála dian agus éadrom, agus is féidir le seoltaí parsáilte nó `None` a thabhairt ar ais do ionchuranna neamhbhailí. Déileálann sé freisin le liostaí seoltaí, ag filleadh seoltaí parsáilte agus píosaí neamhpharsáilte ar leith. Déanann sé seo an-ideálta chun ionchur úsáideoirí a ghlanadh, iompórtálacha móra a bhailíochtú, agus sláine sonraí a chinntiú i sreabhanna oibre a bhraitheann ar ríomhphost.
Conas Dípharsáil agus Bailíochtú Seoltaí Ríomhphoist trí 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']
Dípharsáil Teachtaireachtaí MIME
cuireann modúl parsála MIME le flanker (`flanker.mime`) ar chumas forbróirí teachtaireachtaí ríomhphoist amh a pharsáil i rudaí struchtúrtha Python. Is féidir leat ceanntásca a bhaint, corpanna a dhíchódú, cineálacha ábhair a bhrath, agus struchtúir ilchuidí a nascleanúint go héasca. Déanann an leabharlann an t-ionchódú, an t-aistriú charset, agus na codanna MIME neadaithe a láimhseáil go huathoibríoch. Le predicátaí mar `is_multipart()` agus `is_singlepart()`, is féidir leat struchtúr an teachtaireachta a iniúchadh go cláir agus gach cuid a phróiseáil de réir sin—ideálach chun cliaint ríomhphoist a thógáil, córais cartlannaithe, nó píblíneanna próiseála uathoibríocha a chruthú.
Conas Teachtaireachtaí MIME a Pharsáil agus Ceanntásca & Corpanna a Bhain amach?
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}")
Bain Ceanntásca agus Meiteashonraí
cuireann flanker rochtain shaibhir ar cheanntásca ríomhphoist agus meiteashonraí tríd a API parsála MIME. Tá na ceanntásca ar ais mar fhoclóir illuachmhar Unicode, ag tacú le cuardaigh gan aire ar chás agus le luachanna struchtúrtha (m.sh., `Content-Type` parsáilte i gcineál agus paraiméadair). Is féidir leat an seoltóir, an faighteoir, an ábhar, an dáta, agus ceanntásca saincheaptha a aisghabháil go héasca. Tá sé seo thar a bheith úsáideach le haghaidh innéacsú ríomhphoist, scagadh spama, iniúchadh comhlíonta, agus tógáil cartlanna ríomhphoist atá cairdiúil don chuardach áit a bhfuil parsáil chianntáscanna cruinn ríthábhachtach.
Conas Ceanntásca Ríomhphoist agus Meiteashonraí a Bhain amach trí 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>
Láimhseáil Teachtaireachtaí Ilchodach agus Iatáin
Déanann flanker an obair le teachtaireachtaí iolracha casta a shimpliú, lena n-áirítear cinn neadaithe agus iatáin. Is féidir leat dul trí `msg.parts` chun gach cuid MIME a rochtain, a chineál ábhair a iniúchadh, agus a chorp a dhíchódú. Déanann an leabharlann láithreach déileáil le díchódú base64 agus quoted‑printable, tiontú tacair charachtar, agus braith teorann. Déanann sé seo sé simplí téacs/plain agus leaganacha text/html a bhaint, iatáin a shábháil, nó teachtaireachtaí a aththógáil le haghaidh seoladh ar aghaidh nó cartlannú—ideálach do chliaint ríomhphoist, uirlisí cúltaca, agus córais comhlíonta.
Conas Teachtaireachtaí Ilchodach a Phróiseáil agus Iatáin a Bhain amach?
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)}")
