Abrir o app

Guias › Python › Automações

Python Automações: Mensagens com modelo, Montar um e-mail, Enviar e-mails e mais (lições 21 a 25)

Python é uma das linguagens de programação mais usadas para automatizar tarefas, analisar dados e criar sistemas. Aqui você aprende do zero, com frases simples e exemplos curtos, e depois automatiza arquivos, e-mails e consultas na internet.

Neste guia você vai ver as lições 21 a 25 do curso de Python (nível Automações). Cada lição explica o assunto em quatro partes: o que é, para que serve, como usar e o que você vai ver na tela. No final, há um projeto para juntar tudo o que aprendeu.

Lição 21: Mensagens com modelo

string.Template guarda um texto com lugares marcados por $nome. O método substitute(dicionario) preenche todos de uma vez, e $$ escreve um cifrão de verdade. É a base da mala direta.

O que é

Um modelo de mensagem é um texto com buracos para preencher, como "Olá, $nome!". O Template guarda o modelo e o substitute() preenche os buracos com os dados de cada pessoa.

Para que serve

Serve para a mala direta: mandar a mesma mensagem para centenas de pessoas, cada uma com o seu nome, o seu valor e a sua data.

Como você vai usar

Leia o modelo do arquivo com Template(open('modelo.txt').read()). Para cada linha do CSV, chame modelo.substitute(l). Um cifrão de verdade se escreve $$.

O que vai aparecer

Três mensagens preenchidas, cada uma com os dados de um cliente, separadas por linhas de ---.

Exemplo

from string import Template
modelo = Template('Ola, $nome! Seu pedido $pedido saiu hoje.')
print(modelo.substitute(nome='Ana', pedido=123))
print(modelo.substitute({'nome': 'Bia', 'pedido': 456}))

Lição 22: Montar um e-mail

EmailMessage monta a mensagem: msg["To"], msg["Subject"] e set_content() para o texto. add_attachment() junta um arquivo. Ainda não enviamos nada: só montamos a mensagem.

O que é

Um e-mail é um objeto com partes: quem manda (From), para quem (To), o assunto (Subject), o texto e, às vezes, anexos. O EmailMessage monta tudo isso, mas ainda não envia.

Para que serve

Serve para o robô preparar avisos, relatórios e boletos prontos para serem mandados, com o arquivo anexado.

Como você vai usar

Crie msg = EmailMessage(), preencha msg['To'] e msg['Subject'], escreva o corpo com set_content(...) e junte o arquivo com add_attachment(dados, maintype='text', subtype='plain', filename='relatorio.txt').

O que vai aparecer

Os dados do e-mail (de, para, assunto), o texto do corpo e a lista com o nome do anexo.

Exemplo

from email.message import EmailMessage
msg = EmailMessage()
msg['From'] = 'robo@exemplo.com'
msg['To'] = 'ana@exemplo.com'
msg['Subject'] = 'Relatorio pronto'
msg.set_content('Oi, Ana. O relatorio esta pronto.')
print(msg['To'], '|', msg['Subject'])
print(msg.get_content())

Lição 23: Enviar e-mails

smtplib.SMTP conecta no servidor de e-mail: starttls() protege a conversa, login() entra e send_message() envia. Neste treino o servidor é de mentira e guarda tudo em smtplib.caixa; no mundo real, só muda o endereço do servidor e a senha, que deve vir de uma variável de ambiente.

O que é

O SMTP é a "agência dos correios" dos e-mails. Para mandar uma carta você se conecta na agência, protege a conversa (starttls), mostra quem é (login) e entrega a mensagem (send_message).

Para que serve

Serve para o robô mandar e-mails sozinho: avisos de boleto, relatórios do dia, alertas de erro.

Como você vai usar

Use with smtplib.SMTP('smtp.exemplo.com', 587) as s:, depois s.starttls(), s.login(usuario, senha) e s.send_message(msg) para cada cliente. A senha vem de os.environ['SENHA_SMTP'], nunca escrita no código.

O que vai aparecer

O número de e-mails enviados (3) e, embaixo, o destinatário e o assunto do último.

Exemplo

import smtplib
from email.message import EmailMessage
msg = EmailMessage()
msg['From'] = 'robo@exemplo.com'
msg['To'] = 'ana@exemplo.com'
msg['Subject'] = 'Oi'
msg.set_content('Teste')
with smtplib.SMTP('smtp.exemplo.com', 587) as s:
    s.starttls()
    s.login('robo@exemplo.com', 'senha123')
    s.send_message(msg)
print(len(smtplib.caixa), 'enviado(s)')
Publicidade

Lição 24: Diário do robô: logging

logging é o diário de bordo do programa, com níveis: debug, info, warning, error. basicConfig(level=..., format=..., stream=sys.stdout) escolhe o que aparece e como. Quando o robô roda sozinho, é o log que conta o que aconteceu.

O que é

Log é o "diário de bordo" do programa. Cada anotação tem um nível de importância: info (só informando), warning (atenção) e error (deu problema).

Para que serve

Serve para entender o que o robô fez quando ninguém estava olhando, e descobrir onde deu errado sem precisar adivinhar.

Como você vai usar

Configure uma vez com logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s', stream=sys.stdout). Depois use logging.info(...) e logging.warning(...).

O que vai aparecer

Uma linha para cada arquivo, começando por INFO ou WARNING, e a linha final com o total de arquivos.

Exemplo

import logging, sys
logging.basicConfig(level=logging.INFO, format='%(levelname)s: %(message)s', stream=sys.stdout)
logging.info('robo iniciado')
logging.debug('detalhe que nao aparece')
logging.warning('disco quase cheio')

Lição 25: Tentar de novo quando falha

Robôs falham: a rede cai, o servidor demora. Com try/except você captura o erro, espera um pouco (time.sleep) e tenta de novo. Se as tentativas acabarem, avise em vez de travar. Neste treino o time.sleep passa o tempo na hora.

O que é

Às vezes um erro passa sozinho: a internet cai por um instante, o servidor está ocupado. Em vez de desistir, o robô espera um pouco e tenta de novo, esperando mais a cada falha.

Para que serve

Serve para o robô ser teimoso na medida certa: não trava na primeira falha, mas também não tenta para sempre.

Como você vai usar

Faça um for com o número de tentativas. Dentro, try: return funcao() e except ConnectionError: imprima, durma com time.sleep(espera) e dobre a espera com espera *= 2.

O que vai aparecer

Duas linhas de tentativas que falharam, depois a palavra dados e a soma do tempo esperado: 3.0 segundos.

Exemplo

import time
tentativas = 0
def instavel():
    global tentativas
    tentativas += 1
    if tentativas < 3:
        raise ConnectionError('sem rede')
    return 'ok'
for n in range(1, 5):
    try:
        print(instavel())
        break
    except ConnectionError as e:
        print('falhou:', e)
        time.sleep(2)

Projeto: robô de boletos com diário e retentativas

Você vai montar um robô de cobrança. O arquivo clientes.csv tem nome, email e valor. A função checar_servidor() já existe: ela falha com ConnectionError nas duas primeiras chamadas e, na terceira, devolve True.

  1. Configure o logging com basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s", stream=sys.stdout).
  2. Chame checar_servidor() em até 4 tentativas. A cada falha, registre logging.warning com tentativa N falhou (o N começa em 1) e espere 1 segundo (time.sleep). Quando funcionar, registre logging.info com servidor ok e pare.
  3. Leia clientes.csv com DictReader. Para cada cliente, monte o texto com string.Template (Ola, $nome! Seu boleto de $valor reais vence amanha.), crie um EmailMessage de robo@exemplo.com para o e-mail do cliente, com assunto Seu boleto, e envie por smtplib.SMTP("smtp.exemplo.com", 587), com starttls() e login usando a senha da variável de ambiente SENHA_SMTP. A cada envio, registre logging.info com enviado para e o e-mail.
  4. No final, imprima N e-mails na caixa (o N é len(smtplib.caixa)) e, na linha de baixo, o texto da última mensagem (get_content()).

O que este projeto usa: Mensagens com modelo, Montar um e-mail, Enviar e-mails, Diário do robô: logging, Tentar de novo quando falha.

No CodeUp esse projeto é feito no próprio app, com dicas e correção automática, e não tira vidas de ninguém.

Publicidade

Pratique de verdade. Ler é só o começo: no CodeUp você escreve o código, recebe a correção na hora e ganha pontos.

Começar grátis