flanker

 
 

Ανοιχτή Πηγή Βιβλιοθήκη Python για Ανάλυση Email

Αναλύστε Διευθύνσεις Email, Επικυρώστε Διευθύνσεις & Αναλύστε Μηνύματα MIME μέσω Ανοιχτής Πηγής Δωρεάν API Python.

Τι είναι το flanker;

Το flanker είναι μια ανοιχτού κώδικα βιβλιοθήκη Python που αναπτύχθηκε από τη Mailgun για την ανάλυση διευθύνσεων email και μηνυμάτων MIME. Παρέχει ισχυρά εργαλεία για την επικύρωση διευθύνσεων email, την ανάλυση σύνθετων λιστών διευθύνσεων και την εξαγωγή δομημένων δεδομένων από μηνύματα MIME. Σχεδιασμένο για χρήση σε παραγωγή, το flanker υποστηρίζει τόσο την Python 2.7 όσο και την Python 3.6+, καθιστώντας το ιδανικό για προγραμματιστές που δημιουργούν εφαρμογές με έντονη χρήση email, όπως αγωγούς επεξεργασίας αλληλογραφίας, ενσωματώσεις CRM και συστήματα ειδοποιήσεων.

Η βιβλιοθήκη αποτελείται από δύο βασικές μονάδες: `flanker.addresslib` για την ανάλυση και επικύρωση διευθύνσεων email, και `flanker.mime` για την ανάλυση μηνυμάτων MIME. Υποστηρίζει αυστηρές και χαλαρές λειτουργίες ανάλυσης, επικύρωση εγγραφών DNS/MX και λεπτομερή αναφορά σφαλμάτων. Με το καθαρό API της και τις ελάχιστες εξαρτήσεις, το flanker επιτρέπει στους προγραμματιστές να επεξεργάζονται αξιόπιστα δεδομένα email χωρίς να εξαρτώνται από εξωτερικά εκτελέσιμα ή σύνθετες εξαρτήσεις. Η ευρεία χρήση του στην υποδομή της Mailgun εξασφαλίζει σταθερότητα και απόδοση σε περιβάλλοντα υψηλού όγκου.

Previous Next

Ξεκινώντας με το flanker

Για να ξεκινήσετε με το flanker, πρέπει πρώτα να έχετε εγκατεστημένα τα headers της Python. Στο Ubuntu, εκτελέστε `sudo apt-get install python-dev`; στο Fedora, χρησιμοποιήστε `sudo yum install python-devel`. Στη συνέχεια εγκαταστήστε μέσω pip: `pip install flanker`. Εναλλακτικά, κλωνοποιήστε το αποθετήριο [flanker GitHub](https://github.com/mailgun/flanker) και εκτελέστε `pip install -e .`. Η βιβλιοθήκη είναι ελαφριά, με ελάχιστες εξαρτήσεις, και έτοιμη για παραγωγική χρήση. Αναλυτική τεκμηρίωση και αναφορές API διατίθενται στο αποθετήριο GitHub του έργου.

Εγκατάσταση του flanker μέσω PIP ή 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 .

Ανάλυση και Επικύρωση Διευθύνσεων Email

Το flanker παρέχει ισχυρά εργαλεία για την ανάλυση και την επικύρωση διευθύνσεων email. Μπορείτε να αναλύσετε μια μοναδική διεύθυνση με όνομα εμφάνισης, να επικυρώσετε έναντι των εγγραφών DNS/MX και να ελέγξετε τους κανόνες γραμματικής ESP. Η βιβλιοθήκη υποστηρίζει αυστηρές και χαλαρές λειτουργίες ανάλυσης και μπορεί να επιστρέψει τις αναλυμένες διευθύνσεις ή `None` για μη έγκυρες εισόδους. Επίσης διαχειρίζεται λίστες διευθύνσεων, επιστρέφοντας τις αναλυμένες διευθύνσεις και τα μη αναλύσιμα τμήματα ξεχωριστά. Αυτό την καθιστά ιδανική για τον καθαρισμό των εισροών χρηστών, την επικύρωση μαζικών εισαγωγών και τη διασφάλιση της ακεραιότητας των δεδομένων σε ροές εργασίας που βασίζονται σε email.

Πώς να Αναλύσετε και να Επικυρώσετε Διευθύνσεις Email μέσω 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']

Ανάλυση Μηνυμάτων MIME

Το μοντέλο ανάλυσης MIME του flanker (`flanker.mime`) επιτρέπει στους προγραμματιστές να αναλύουν ακατέργαστα μηνύματα email σε δομημένα αντικείμενα Python. Μπορείτε να εξάγετε κεφαλίδες, να αποκωδικοποιήσετε σώματα, να εντοπίσετε τύπους περιεχομένου και να περιηγηθείτε σε δομές multipart με ευκολία. Η βιβλιοθήκη διαχειρίζεται αυτόματα την κωδικοποίηση, τη μετατροπή charset και τα ένθετα μέρη MIME. Με προδιαγραφές όπως `is_multipart()` και `is_singlepart()`, μπορείτε προγραμματιστικά να ελέγχετε τη δομή του μηνύματος και να επεξεργάζεστε κάθε μέρος ανάλογα — ιδανικό για την κατασκευή πελατών email, συστημάτων αρχειοθέτησης ή αυτοματοποιημένων αγωγών επεξεργασίας.

Πώς να Αναλύσετε Μηνύματα MIME και να Εξάγετε Κεφαλίδες & Σώματα;

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

Εξαγωγή Κεφαλίδων και Μεταδεδομένων

Το flanker παρέχει πλούσια πρόσβαση σε κεφαλίδες email και μεταδεδομένα μέσω του API ανάλυσης MIME του. Οι κεφαλίδες επιστρέφονται ως λεξικό Unicode πολλαπλών τιμών, υποστηρίζοντας αναζητήσεις χωρίς διάκριση πεζών-κεφαλαίων και δομημένες τιμές (π.χ., `Content-Type` που αναλύεται σε τύπο και παραμέτρους). Μπορείτε να ανακτήσετε αποστολέα, παραλήπτη, θέμα, ημερομηνία και προσαρμοσμένες κεφαλίδες με ευκολία. Αυτό είναι ιδιαίτερα χρήσιμο για την ευρετηρίαση email, το φιλτράρισμα ανεπιθύμητης αλληλογραφίας, τον έλεγχο συμμόρφωσης και τη δημιουργία αρχείων email φιλικών προς την αναζήτηση, όπου η ακριβής ανάλυση των κεφαλίδων είναι κρίσιμη.

Πώς να Εξάγετε Κεφαλίδες Email και Μεταδεδομένα μέσω 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>

Διαχείριση Πολυμερικών Μηνυμάτων και Συνημμένων

Το flanker απλοποιεί την εργασία με σύνθετα μηνύματα multipart, συμπεριλαμβανομένων εκείνων με ένθετα τμήματα και συνημμένα. Μπορείτε να επαναλάβετε το `msg.parts` για να έχετε πρόσβαση σε κάθε τμήμα MIME, να ελέγξετε τον τύπο περιεχομένου του και να αποκωδικοποιήσετε το σώμα του. Η βιβλιοθήκη διαχειρίζεται αυτόματα την αποκωδικοποίηση base64 και quoted‑printable, τη μετατροπή charset και την ανίχνευση ορίων. Αυτό καθιστά εύκολο την εξαγωγή εκδόσεων text/plain και text/html, την αποθήκευση συνημμένων ή την ανασύνθεση μηνυμάτων για προώθηση ή αρχειοθέτηση—ιδανικό για πελάτες email, εργαλεία αντιγράφων ασφαλείας και συστήματα συμμόρφωσης.

Πώς να Επεξεργαστείτε Πολυμερές Μηνύματα και να Εξάγετε Συνημμένα;

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)}")
 Ελληνικά