Voltar para o blog

Python 4 min de leitura

Python para automação e web

Como usar Python para reduzir repetição operacional e acelerar pequenas entregas.

Python para automação e web

Python é útil quando uma tarefa repetitiva tem entrada, regra e saída bem definidas. Um exemplo comum é receber um arquivo de pedidos, contar os pagos e conferir seu valor total. Vamos fazer isso com a biblioteca padrão, sem planilha aberta e sem pacote adicional. Depois veremos como a mesma regra pode servir a uma aplicação web.

Um CSV pequeno para reproduzir o exercício

Crie um arquivo chamado pedidos.csv na mesma pasta do programa. Use ponto e vírgula como separador e ponto nos valores:

pedido_id;status;valor
101;pendente;29.90
102;pago;10.00
103;pago;15.50

Antes de automatizar, defina o esperado: há dois pedidos pagos e o total deles é R$ 25,50. O pedido pendente não entra na soma. Essa previsão permite verificar se o código resolveu o problema correto.

Leia, valide e resuma

Salve o código como resumo.py e execute python resumo.py na pasta dos arquivos.

import csv
from decimal import Decimal, InvalidOperation
from pathlib import Path

arquivo = Path("pedidos.csv")

def resumir_pedidos(caminho):
    quantidade = 0
    total = Decimal("0.00")

    with caminho.open(encoding="utf-8-sig", newline="") as entrada:
        leitor = csv.DictReader(entrada, delimiter=";")
        if leitor.fieldnames != ["pedido_id", "status", "valor"]:
            raise ValueError("Cabeçalho diferente do esperado")

        for numero_linha, linha in enumerate(leitor, start=2):
            if linha["status"] not in {"pago", "pendente"}:
                raise ValueError(f"Status inválido na linha {numero_linha}")
            try:
                valor = Decimal(linha["valor"])
            except (InvalidOperation, TypeError):
                raise ValueError(f"Valor inválido na linha {numero_linha}")
            if not valor.is_finite() or valor < 0 or valor.as_tuple().exponent < -2:
                raise ValueError(f"Valor monetário inválido na linha {numero_linha}")

            if linha["status"] == "pago":
                quantidade += 1
                total += valor

    return quantidade, total

try:
    quantidade, total = resumir_pedidos(arquivo)
    print(f"{quantidade} pedidos pagos | total R$ {total:.2f}")
except (OSError, ValueError) as erro:
    print(f"Não foi possível gerar o resumo: {erro}")

A saída esperada é “2 pedidos pagos | total R$ 25.50”. O programa usa ponto porque o formato numérico de saída do Python não aplica automaticamente a apresentação brasileira. Para mostrar “25,50” em uma interface, formate esse valor na camada de apresentação. Decimal é adequado para somas monetárias; float pode introduzir diferenças de arredondamento.

O leitor CSV interpreta a primeira linha como nomes de campos. newline vazio segue a recomendação do módulo csv da documentação oficial do Python. A codificação utf-8-sig também aceita arquivos UTF-8 que começam com marca de ordem de bytes. Se a origem usar vírgula decimal, não troque o separador às cegas: defina o formato aceito antes de converter.

Teste erros que aparecem no trabalho real

Mude um status para “pagoo”: o programa deve informar a linha inválida. Apague o arquivo: ele deve avisar que não conseguiu gerar o resumo. Troque um valor por letras: a soma não deve ser publicada como se estivesse correta. Uma automação que ignora linhas ruins sem avisar pode produzir um relatório aparentemente confiável e errado.

O próximo passo é receber o caminho do arquivo como argumento, salvar o resultado em outro arquivo e registrar quando a execução falhar. Para tarefas recorrentes, pense também em como evitar processamento duplicado e em quem terá acesso aos arquivos.

Onde entra a web

O cálculo não depende de uma página. Uma aplicação web pode receber um CSV, validar tamanho e permissões, chamar a função de resumo e devolver quantidade e total em JSON. A interface então mostra o resultado. Arquivos enviados por usuários exigem limites, armazenamento temporário, validação no servidor e cuidado para não expor dados de terceiros; abrir um arquivo local do servidor por um caminho fornecido pelo navegador não é uma solução segura.

Quando os pedidos deixam de vir de um CSV e passam a ser compartilhados por vários usuários, consulte o exemplo de pedidos e itens em SQL. Se ainda está praticando variáveis, condições e laços, volte ao guia de programação do zero e refaça a mesma regra com uma entrada menor.

Tags do artigo

  • python
  • automação
  • produtividade
  • backend

Mais conteúdos relacionados