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

flanker

 
 

Biblioteca Python de Código Aberto para Análise de Email

Analise Endereços de Email, Valide Endereços e Analise Mensagens MIME via API Python Gratuita de Código Aberto.

O que é flanker?

flanker é uma biblioteca Python de código aberto desenvolvida pela Mailgun para analisar endereços de e‑mail e mensagens MIME. Ela fornece ferramentas robustas para validar endereços de e‑mail, analisar listas de endereços complexas e extrair dados estruturados de mensagens MIME. Projetada para uso em produção, flanker suporta tanto Python 2.7 quanto Python 3.6+, tornando‑a ideal para desenvolvedores que criam aplicações intensivas em e‑mail, como pipelines de processamento de correio, integrações de CRM e sistemas de notificação.

A biblioteca consiste em dois módulos principais: `flanker.addresslib` para analisar e validar endereços de e‑mail, e `flanker.mime` para analisar mensagens MIME. Ela suporta modos de análise estritos e permissivos, validação de registros DNS/MX e relatórios detalhados de erros. Com sua API limpa e dependências mínimas, flanker permite que os desenvolvedores processem dados de e‑mail de forma confiável sem depender de binários externos ou dependências complexas. Seu uso disseminado na infraestrutura da Mailgun garante estabilidade e desempenho em ambientes de alto volume.

Previous Next

Começando com flanker

Para começar a usar o flanker, você precisa ter os cabeçalhos do Python instalados primeiro. No Ubuntu, execute `sudo apt-get install python-dev`; no Fedora, use `sudo yum install python-devel`. Em seguida, instale via pip: `pip install flanker`. Alternativamente, clone o repositório [flanker GitHub](https://github.com/mailgun/flanker) e execute `pip install -e .`. A biblioteca é leve, com dependências mínimas, e está pronta para uso em produção. Documentação detalhada e referências da API estão disponíveis no repositório GitHub do projeto.

Instalar flanker via PIP ou 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 .

Analisar e validar endereços de e‑mail

flanker fornece ferramentas poderosas para analisar e validar endereços de e‑mail. Você pode analisar um único endereço com nome de exibição, validar contra registros DNS/MX e verificar regras gramaticais de ESP. A biblioteca suporta modos de análise estrito e permissivo, e pode retornar endereços analisados ou `None` para entradas inválidas. Também lida com listas de endereços, retornando endereços analisados e fragmentos não analisáveis separadamente. Isso a torna ideal para limpar a entrada do usuário, validar importações em massa e garantir a integridade dos dados em fluxos de trabalho baseados em e‑mail.

Como analisar e validar endereços de e‑mail 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']

Analisar mensagens MIME

O módulo de análise MIME do flanker (`flanker.mime`) permite que desenvolvedores analisem mensagens de email brutas em objetos Python estruturados. Você pode extrair cabeçalhos, decodificar corpos, detectar tipos de conteúdo e navegar em estruturas multipartes com facilidade. A biblioteca lida automaticamente com codificação, conversão de conjunto de caracteres e partes MIME aninhadas. Com predicados como `is_multipart()` e `is_singlepart()`, você pode inspecionar programaticamente a estrutura da mensagem e processar cada parte de acordo—ideal para construir clientes de email, sistemas de arquivamento ou pipelines de processamento automatizado.

Como analisar mensagens MIME e extrair cabeçalhos e corpos?

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

Extrair cabeçalhos e metadados

O flanker fornece acesso avançado a cabeçalhos de email e metadados por meio de sua API de análise MIME. Os cabeçalhos são retornados como um dicionário Unicode de múltiplos valores, suportando buscas sem distinção entre maiúsculas e minúsculas e valores estruturados (por exemplo, `Content-Type` analisado em tipo e parâmetros). Você pode recuperar remetente, destinatário, assunto, data e cabeçalhos personalizados com facilidade. Isso é especialmente útil para indexação de emails, filtragem de spam, auditoria de conformidade e construção de arquivos de email otimizados para busca, onde a análise precisa dos cabeçalhos é crítica.

Como extrair cabeçalhos de e‑mail e metadados 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>

Manipular mensagens multipartes e anexos

flanker simplifica o trabalho com mensagens multipart complexas, incluindo aquelas com partes aninhadas e anexos. Você pode iterar sobre `msg.parts` para acessar cada parte MIME, inspecionar seu tipo de conteúdo e decodificar seu corpo. A biblioteca lida automaticamente com decodificação base64 e quoted‑printable, conversão de charset e detecção de limites. Isso torna simples extrair as versões text/plain e text/html, salvar anexos ou reconstruir mensagens para encaminhamento ou arquivamento — ideal para clientes de email, ferramentas de backup e sistemas de conformidade.

Como processar mensagens multipartes e extrair anexos?

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)}")
 Português