{"id":23039,"date":"2019-07-16T00:00:00","date_gmt":"2019-07-16T00:00:00","guid":{"rendered":"https:\/\/www.mailgun.com\/blog\/we-just-open-sourced-flanker-our-python-email-address-and-mime-parsing-library-2\/"},"modified":"2026-09-16T01:28:00","modified_gmt":"2026-09-16T01:28:00","slug":"we-just-open-sourced-flanker-our-python-email-address-and-mime-parsing-library","status":"publish","type":"blog","link":"https:\/\/www.mailgun.com\/pt\/blog\/product\/we-just-open-sourced-flanker-our-python-email-address-and-mime-parsing-library\/","title":{"rendered":"Acabamos de lan\u00e7ar o flanker em c\u00f3digo aberto, nossa biblioteca em Python de an\u00e1lise de MIME e endere\u00e7os de e-mail"},"content":{"rendered":"\n

Em junho, lan\u00e7amos o nosso\u00a0servi\u00e7o de valida\u00e7\u00e3o de endere\u00e7os Guardpost<\/a>. Desde ent\u00e3o, muitos clientes do Mailgun v\u00eam usando o Guardpost para validar seus endere\u00e7os de e-mail e reduzir seus cadastros falsos, bem como as taxas de devolu\u00e7\u00e3o. Em junho, prometemos que lan\u00e7ar\u00edamos em c\u00f3digo aberto nossa biblioteca de an\u00e1lise de MIME e endere\u00e7os escrita em Python, e \u00e9 isso que estamos fazendo hoje. Continue lendo para ver os detalhes ou, se quiser ir direto ao ponto,\u00a0aqui est\u00e1 o reposit\u00f3rio no Github<\/a>, que inclui um\u00a0Guia de in\u00edcio r\u00e1pido<\/a>,\u00a0Manual do usu\u00e1rio<\/a>\u00a0e\u00a0Guia de API<\/a>. Voc\u00ea tamb\u00e9m pode instalar o flanker via pip.<\/p>\n\n\n\n

Apresentamos o Flanker<\/h2>\n\n\n\n

O Flanker consiste em duas partes:<\/p>\n\n\n\n

    \n
  1. mime: esta \u00e9 a nossa biblioteca de an\u00e1lise de MIME. Por que isso \u00e9 t\u00e3o incr\u00edvel? Nossa biblioteca de an\u00e1lise de MIME pode ser at\u00e9 20x mais r\u00e1pida dependendo do seu conjunto de dados.<\/li>\n\n\n\n
  2. addresslib: esta \u00e9 a biblioteca de an\u00e1lise de endere\u00e7os que \u00e9 a base do Guardpost<\/a> . Voc\u00ea pode us\u00e1-la para analisar endere\u00e7os ou listas de endere\u00e7os com base estritamente na gram\u00e1tica RFC, ou para validar endere\u00e7os e listas com base nas verifica\u00e7\u00f5es adicionais. As verifica\u00e7\u00f5es adicionais incluem pesquisa de DNS, exist\u00eancia de MX, gram\u00e1tica espec\u00edfica do provedor de servi\u00e7os de e-mail (ESP) e corre\u00e7\u00e3o ortogr\u00e1fica.<\/li>\n<\/ol>\n\n\n\n

    Mais sobre Mime<\/h2>\n\n\n\n

    O Mailgun analisa muito MIME e, portanto, requer um pacote de manipula\u00e7\u00e3o de MIME r\u00e1pido e eficiente. Quando iniciamos o Mailgun, usamos a biblioteca de an\u00e1lise padr\u00e3o do Python, mas logo percebemos que precis\u00e1vamos de algo mais previs\u00edvel. Como a biblioteca padr\u00e3o era bastante r\u00e1pida para mensagens pequenas, mas muito pior para mensagens maiores, n\u00f3s escrevemos o Flanker. Onde o flanker realmente se destaca \u00e9 na an\u00e1lise de cabe\u00e7alhos. O Flanker n\u00e3o analisa a mensagem inteira se o seu interesse for apenas nos cabe\u00e7alhos; isso d\u00e1 a voc\u00ea acesso r\u00e1pido a eles se a sua mensagem MIME for de 1 KB ou 10 MB. Dependendo da mensagem MIME processada, o\u00a0flanker.mime\u00a0pode ser at\u00e9\u00a020x mais r\u00e1pido<\/b>\u00a0que o pacote padr\u00e3o de an\u00e1lise de MIME do Python, usar\u00a0~50% menos mem\u00f3ria<\/b> e fazer at\u00e9\u00a0730x menos chamadas de fun\u00e7\u00e3o<\/b>. Voc\u00ea pode ver todos os benchmarks que executamos\u00a0aqui<\/a>.<\/p>\n\n\n\n

    O que mais h\u00e1 de diferente entre o\u00a0flanker.mime\u00a0e o\u00a0email.parser?\u00a0<\/p>\n\n\n\n

    \"Screen_Shot_2019-08-27_at_11\"<\/figure>\n\n\n\n

    Mais sobre o\u00a0addresslib<\/em><\/h3>\n\n\n\n

    A an\u00e1lise no addresslib \u00e9 um recurso muito poderoso e voc\u00ea pode explorar a documenta\u00e7\u00e3o para ver tudo o que pode fazer. Outro recurso muito legal do addresslib \u00e9 a fun\u00e7\u00e3o de valida\u00e7\u00e3o. Esta \u00e9 uma parte importante do nosso servi\u00e7o de verifica\u00e7\u00e3o de e-mail.<\/p>\n\n\n\n

    A valida\u00e7\u00e3o inclui as etapas de an\u00e1lise descritas na documenta\u00e7\u00e3o, al\u00e9m de:<\/p>\n\n\n\n

    Pesquisa de DNS<\/h2>\n\n\n\n

    Depois que um endere\u00e7o \u00e9 analisado, o validador tenta fazer uma pesquisa de DNS no dom\u00ednio. Os registros MX s\u00e3o verificados primeiro; se n\u00e3o existirem, o validador recorrer\u00e1 aos registros A. Se n\u00e3o existirem registros MX nem A, o endere\u00e7o ser\u00e1 considerado inv\u00e1lido. Por padr\u00e3o, o\u00a0flanker\u00a0usa a biblioteca\u00a0dnsq\u00a0(tamb\u00e9m escrita pelo Mailgun) para realizar pesquisas de DNS; no entanto, o uso do\u00a0dnsq\u00a0n\u00e3o \u00e9 obrigat\u00f3rio. Qualquer biblioteca de pesquisa de DNS pode ser usada, desde que esteja em conformidade com a mesma interface de um dicion\u00e1rio\u00a0Python. Consulte\u00a0flanker\/addresslib\/drivers\/dns_lookup.py<\/a>\u00a0para ver um exemplo.<\/p>\n\n\n\n

    Exist\u00eancia de\u00a0MX<\/h2>\n\n\n\n

    Se a pesquisa de DNS na etapa anterior tiver retornado um registro MX ou A v\u00e1lido, esse endere\u00e7o ser\u00e1 verificado para garantir que um Mail Exchanger responda na porta\u00a025. Se nenhum Mail Exchanger responder, o dom\u00ednio ser\u00e1 considerado inv\u00e1lido. As pesquisas de DNS e verifica\u00e7\u00f5es de exist\u00eancia de MX s\u00e3o custosas, e o resultado das duas etapas acima pode ser armazenado em cache para melhorar o desempenho. O Flanker,\u00a0por padr\u00e3o, usa o Redis para esse cache, mas o uso do Redis n\u00e3o \u00e9 obrigat\u00f3rio. De forma semelhante \u00e0 biblioteca de pesquisa de DNS, qualquer cache pode ser usado aqui, desde que a interface seja a mesma de um dicion\u00e1rio Python. Consulte\u00a0flanker\/addresslib\/drivers\/redis_cache.py<\/a>\u00a0para ver um exemplo.<\/p>\n\n\n\n

    Gram\u00e1tica personalizada<\/h2>\n\n\n\n

    Grandes ESPs raramente (ou nunca) oferecem suporte a toda a gram\u00e1tica que a RFC permite para endere\u00e7os de e-mail; na verdade, a maioria tem uma gram\u00e1tica bastante restritiva. Por exemplo, um endere\u00e7o do Yahoo! Mail deve ter entre 4 e 32 caracteres e pode usar apenas caracteres alfanum\u00e9ricos, ponto (.)\u00a0e sublinhado (_). Se o Mail Exchanger da etapa anterior for igual ao Mail Exchanger de um ESP, com gram\u00e1tica conhecida, o validador executar\u00e1 essa verifica\u00e7\u00e3o adicional na parte local do endere\u00e7o. Gram\u00e1ticas personalizadas podem ser adicionadas inserindo-se um plug-in do ESP espec\u00edfico no diret\u00f3rio\u00a0flanker\/addresslib\/plugins. Consulte o\u00a0Manual do usu\u00e1rio<\/a>\u00a0para obter mais informa\u00e7\u00f5es.<\/p>\n\n\n\n

    Sugest\u00e3o alternativa<\/h2>\n\n\n\n

    Uma etapa separada, mas relacionada, \u00e9 a corre\u00e7\u00e3o ortogr\u00e1fica na parte do dom\u00ednio de um endere\u00e7o de e-mail. Isso pode ser usado para corrigir erros de digita\u00e7\u00e3o comuns, como\u00a0gmal.com\u00a0em vez de\u00a0gmail.com. O corretor ortogr\u00e1fico usa o\u00a0difflib,\u00a0que usa o\u00a0Ratcliff-Obershelp<\/a>\u00a0como algoritmo para calcular a similaridade de duas strings. Este \u00e9 um algoritmo muito r\u00e1pido e preciso para corre\u00e7\u00e3o ortogr\u00e1fica de dom\u00ednio. Consulte a nossa\u00a0post anterior<\/a>\u00a0sobre este t\u00f3pico.<\/p>\n\n\n\n

    Pr\u00f3ximos passos<\/em><\/h3>\n\n\n\n

    Voc\u00ea pode fazer um fork do flanker e come\u00e7ar a us\u00e1-lo hoje mesmo. Estamos muito empolgados em ver a comunidade usando e contribuindo com ele. Como o Flanker \u00e9 uma parte fundamental do Mailgun, isso significa que n\u00f3s o manteremos e melhoraremos ativamente enquanto existirmos.<\/p>\n\n\n\n

    \u00c1reas onde voc\u00ea pode contribuir:<\/em><\/h3>\n\n\n\n

    Queremos muito incentivar novos profissionais de desenvolvimento a contribuir com o Flanker e com softwares de c\u00f3digo aberto em geral. Aqui est\u00e3o dois itens no nosso roteiro que s\u00e3o f\u00e1ceis de resolver e onde novos profissionais podem se envolver e come\u00e7ar a contribuir:<\/p>\n\n\n\n

      \n
    1. Mais gram\u00e1tica espec\u00edfica de ESP. S\u00f3 conseguimos cobrir um n\u00famero limitado de ESPs. Se voc\u00ea sabe o que o seu ESP permite para as partes locais, contribua com um plug-in. Esta \u00e9 uma \u00f3tima maneira de come\u00e7ar a aprender sobre gram\u00e1tica e an\u00e1lise sint\u00e1tica.<\/li>\n\n\n\n
    2. Corre\u00e7\u00e3o autom\u00e1tica de erros. Algumas coisas que v\u00eam \u00e0 mente: se voc\u00ea esquecer de fechar o seu endere\u00e7o de e-mail com um colchete angular (<), o validador deve detectar e corrigir isso para voc\u00ea. Se voc\u00ea esquecer de colocar entre aspas um caractere especial como um par\u00eantese em seu nome de exibi\u00e7\u00e3o, devemos coloc\u00e1-lo entre aspas para voc\u00ea, garantindo que ele seja renderizado corretamente por clientes de e-mail.<\/li>\n<\/ol>\n\n\n\n

      Bom envio!<\/p>\n\n\n\n

      Os Mailgunners<\/p>\n\n\n\r\n