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.

Previous Next

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