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.

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ódigo | Status | O que conferir |
|---|---|---|
| 001 | pendente | Candidato à lista de pendentes |
| 002 | concluido | Não entra na lista de pendentes |
| 003 | vazio | Informação incompleta |
| 001 | pendente | Có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 0016. 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.
Comentários
Postar um comentário