Pular para o conteúdo principal

Arquivos CSV no Python: como preparar dados antes de automatizar pedidos

Você exporta uma lista de pedidos e imagina que a automação vai resolver o trabalho repetitivo. Ao abrir o arquivo, porém, encontra datas diferentes, campos vazios e códigos duplicados. Antes de culpar a programação, vale olhar para a matéria-prima do processo. Preparar os dados pode evitar que um erro pequeno seja repetido em muitos registros.

Profissional trabalha no notebook com caderno e pastas ao lado.
Profissional trabalha no notebook com caderno e pastas ao lado. Imagem ilustrativa gerada por IA.

O que vamos construir neste exercício?

Imagine que você quer conferir uma lista de pedidos antes de separar os que ainda estão pendentes. O trabalho parece simples, mas uma linha sem status ou um código repetido pode mudar a resposta. Vamos usar uma amostra pequena para enxergar esses problemas e tratá-los sem alterar dados reais.

CSV é um arquivo de texto que representa uma tabela, com campos separados por um caractere. O nome vem do inglês comma-separated values, mas o separador pode ser ponto e vírgula. O módulo csv da biblioteca padrão do Python ajuda a ler essa estrutura.

Neste exemplo, usamos apenas código e status. Não precisamos de nomes, telefones ou endereços para aprender a regra. A amostra é fictícia e será criada dentro do próprio programa, sem baixar arquivos nem instalar bibliotecas adicionais.

1. Observe os dados antes de escrever o programa

Imagine uma loja que vende canecas personalizadas e registra cada encomenda em uma planilha. Ao fechar o dia, a pessoa responsável exporta o controle em CSV para descobrir quais pedidos ainda precisam de atenção. A exportação deste exemplo tem só dois campos: código, que identifica o pedido, e status, que informa sua situação. Na rotina da loja, pendente significa que ainda falta preparar ou entregar a encomenda; concluído indica que ela já foi entregue. No arquivo de teste, esse último status está escrito como concluido, sem acento.

Na tabela, cada linha é um registro que chegou do controle da loja, mas nem toda linha corresponde a um pedido diferente. O 001 está pendente e aparece duas vezes, como poderia acontecer se o mesmo registro fosse copiado por engano. O 002 já foi entregue. O 003 está sem status, então é preciso consultar o controle antes de decidir se ele está pendente ou concluído.

Os códigos são tratados como texto para preservar os zeros à esquerda: 001 deve continuar como 001. A terceira coluna, O que conferir, é uma explicação para o leitor; ela não faz parte do CSV. No exercício, os dados fictícios são escritos no próprio código para simular a exportação sem abrir um arquivo real.

CódigoStatusO que conferir
001pendenteCandidato à lista de pendentes
002concluidoNão entra na lista de pendentes
003vazioInformação incompleta
001pendenteCódigo repetido

2. Combine as regras de conferência

Para este exercício, só aceitamos os status pendente e concluido. Removemos espaços no começo e no fim dos textos e comparamos o status em letras minúsculas. Isso não significa que toda diferença de escrita deva ser corrigida automaticamente: qualquer padronização precisa ter um significado definido.

A primeira ocorrência válida de um código é mantida; as seguintes vão para a lista de problemas. Essa é a regra didática do exemplo. Em uma operação real, um código repetido pode representar atualização, parcela ou erro de exportação. Investigue antes de apagar ou unir registros.

O cabeçalho deve ser exatamente codigo;status. Se vier diferente, o programa interrompe com uma mensagem. Uma coluna com nome inesperado não deve ser interpretada por adivinhação.

3. Execute uma leitura com conferência

Use um ambiente de Python 3 preparado para estudos. Copie o exemplo para um arquivo .py e execute pela opção do seu editor. Ele lê apenas o texto fictício abaixo e mostra o resultado na tela; não escreve nem modifica arquivos.

import csv
from io import StringIO

# Amostra fictícia: não usa nem altera arquivos reais.
dados = """codigo;status
001;pendente
002;concluido
003;
001;pendente
"""

leitor = csv.DictReader(StringIO(dados), delimiter=";")
if leitor.fieldnames != ["codigo", "status"]:
    raise ValueError("Confira o cabeçalho: codigo;status")

vistos = set()
pendentes = []
problemas = []

for linha, pedido in enumerate(leitor, start=2):
    codigo = (pedido.get("codigo") or "").strip()
    status = (pedido.get("status") or "").strip().lower()
    if None in pedido or not codigo or status not in {"pendente", "concluido"}:
        problemas.append(f"Linha {linha}: campos inválidos")
        continue
    if codigo in vistos:
        problemas.append(f"Linha {linha}: código repetido {codigo}")
        continue
    vistos.add(codigo)
    if status == "pendente":
        pendentes.append(codigo)

print("Pendentes:", ", ".join(pendentes) or "nenhum")
for problema in problemas:
    print(problema)

4. Entenda o papel de cada parte

StringIO permite tratar o texto da amostra como uma fonte de leitura. DictReader usa a primeira linha como nome das colunas; por isso conseguimos consultar codigo e status. O delimiter informa que os campos são separados por ponto e vírgula.

vistos é um conjunto de códigos já aceitos. pendentes guarda a resposta que queremos encontrar e problemas reúne os avisos de revisão. O for percorre os registros; enumerate fornece uma numeração iniciada em 2 para considerar a linha do cabeçalho. Na amostra, cada registro ocupa uma linha.

get permite consultar um campo; or "" trata a ausência como texto vazio, e strip remove espaços nas extremidades. A condição verifica campos obrigatórios, status permitido e campos excedentes. continue pula para o próximo registro quando encontra um problema.

A verificação de repetição ocorre depois da validação básica. Assim, uma linha inválida não reserva o código como se tivesse sido aceita. Essa ordem faz parte da regra do exemplo e precisa ser entendida antes de adaptar o programa.

5. Compare com a saída esperada

O resultado deve mostrar exatamente os três avisos abaixo. O pedido 001 aparece uma vez; 002 foi concluído; 003 exige revisão porque está sem status; a segunda ocorrência de 001 é sinalizada.

Pendentes: 001
Linha 4: campos inválidos
Linha 5: código repetido 001

6. Faça mudanças pequenas para aprender

Preencha o status de 003 com pendente e execute de novo. Ele deve entrar na lista e o aviso da linha 4 deve desaparecer. Depois altere o último código para 004: o aviso de repetição deve sumir e 004 também aparecerá entre os pendentes. Preveja a resposta antes de executar.

Para testar uma falha, troque o cabeçalho codigo por pedido. O programa deve interromper com a orientação para conferir o cabeçalho. Isso é preferível a produzir uma lista aparentemente correta usando campos errados.

Se aparecer um erro, leia a mensagem e confira a linha indicada, as aspas e os espaços de indentação. Se você ainda não conhece listas, condições e laços, pratique esses fundamentos antes de tentar adaptar tudo de uma vez.

7. Antes de passar para um arquivo real

Quando entender o exercício, você pode estudar a abertura de uma cópia de arquivo CSV. Será necessário definir caminho, codificação e delimitador conforme a exportação. A documentação orienta abrir arquivos usados pelo módulo csv com newline="". Não escolha a codificação por tentativa sem conferir a origem.

Este exemplo não valida datas, valores, formatos de código nem todas as possíveis irregularidades de um CSV. Ele também não decide o significado comercial das repetições. Amplie as regras conforme a tarefa e mantenha revisão humana dos casos que não foram previstos.

Preserve o arquivo original e gere resultados separados. Antes de usar a resposta para mensagens, cobranças ou mudanças em sistemas, confira a quantidade de registros e uma amostra dos resultados. Aprender a automatizar inclui reconhecer os limites do que o programa verifica.

Perguntas frequentes

Todo CSV usa vírgula? Não. Confira o delimitador do arquivo exportado.

Preciso usar uma biblioteca adicional? O módulo csv integra a biblioteca padrão do Python. Outras ferramentas podem ser úteis conforme a tarefa, mas não são obrigatórias para toda leitura simples.

Qual o próximo passo? Reproduza a amostra de quatro registros deste guia, confira a saída esperada e depois mude um caso por vez.

Quer aprofundar esse aprendizado?

Se você procura uma formação para organizar seus estudos, consulte a apresentação do Curso de Python. Compare a grade, os requisitos, o suporte e as condições atuais com o que você precisa aprender. A matrícula não garante clientes, emprego ou renda.

Este artigo contém link de afiliado. O blog poderá receber comissão por compras realizadas por ele. A indicação considera a apresentação pública da oferta, sem avaliação das aulas como aluno.

Fonte e leitura complementar

Python — leitura e escrita de arquivos CSV.

Comentários

Postagens mais visitadas deste blog

Produtos digitais no Canva: ideias, criação e como começar a vender

Você cria uma página no Canva, ajusta as cores e pensa: “Isso poderia ajudar outras pessoas também”. Talvez seja um planner para organizar encomendas, um catálogo para pequenos negócios ou um material que facilite os estudos. Entre essa ideia e um produto que alguém queira comprar, existe um trabalho importante: entender a necessidade, desenvolver uma entrega útil e testar se ela funciona fora do seu próprio computador. Produtos digitais criados no Canva podem ser arquivos prontos ou modelos editáveis , conforme o projeto e as condições de licenciamento. O valor está na utilidade, na organização e na experiência de quem recebe, além da aparência. Neste guia, você verá possibilidades de criação, cuidados com direitos de uso e um caminho para desenvolver e testar uma primeira oferta. Comece por uma pessoa e uma tarefa “Vender um planner” é uma ideia ampla. “Ajudar uma confeiteira a acompanhar encomendas, prazos e entregas” define melhor um problema. Antes de criar, responda: Quem ...

Pinterest para negócios: como atrair clientes e gerar oportunidades de venda

Você dedica tempo ao seu negócio, cuida do que oferece e prepara as publicações, mas sente que poucas pessoas chegam até seus produtos ou serviços. Quando alguém compra e elogia, fica aquela sensação: “Se mais pessoas conhecessem meu trabalho, eu poderia ter outras oportunidades”. Esse desafio não se resolve apenas publicando mais. Também é preciso encontrar formas de aparecer quando alguém está procurando uma ideia, planejando uma compra ou tentando resolver um problema relacionado ao que você oferece. O Pinterest pode fazer parte desse caminho. Uma pessoa que pesquisa referências para organizar a casa, preparar uma festa ou escolher um presente pode descobrir seu conteúdo e, a partir dele, conhecer seu negócio. Usar o Pinterest para negócios significa conectar conteúdos úteis a uma próxima ação: visitar uma página, conhecer um produto, solicitar informações ou comprar. As vendas dependem também da oferta, da experiência no destino e do atendimento. Neste guia, você verá como org...

Manutenção de celulares dá dinheiro? Como começar na profissão

A manutenção de celulares pode gerar renda, mas o resultado depende da capacitação técnica, da procura pelos serviços, dos custos e da qualidade do atendimento. Antes de investir em ferramentas ou abrir uma assistência, é importante entender como a profissão funciona e calcular se a operação pode se sustentar. Para quem gosta de tecnologia e de resolver problemas, o conserto de celulares pode ser uma possibilidade de trabalho por conta própria. Porém, gostar de aparelhos eletrônicos é apenas o começo: atender clientes exige prática, organização e responsabilidade com os equipamentos e as informações recebidas. Neste guia, você vai entender o que faz um técnico, quais custos considerar, como avaliar o resultado de um serviço e o que observar antes de escolher um curso. Capacitação, prática e organização são a base para começar na manutenção de celulares. — Imagem ilustrativa gerada por IA. O que faz um técnico em manutenção de celulares? O técnico em manutenção de celulares identif...