10. Formatos de dados e configuração

Arquivos só se tornam úteis quando sabemos interpretar seu formato. JSON, CSV, TOML, INI e YAML atendem a necessidades diferentes e exigem validação depois da leitura.

Este é o capítulo 10 de 25 da apostila Python para Automação e Scripts. Ele aproveita a base construída em Sistema de arquivos e caminhos e dá mais um passo no desenvolvimento da automação. Ao final, estaremos preparados para estudar Interfaces de linha de comando.

Começando pela situação real

Nesta parte da apostila, acompanhamos os dados dentro da automação. Eles chegam como texto ou arquivo, são convertidos, percorrem etapas e precisam continuar válidos mesmo quando surge uma falha. Em Formatos de dados e configuração, observaremos como essa parte se liga ao conjunto, mantendo claros o contrato de entrada, o processamento, os efeitos e a conferência do resultado.

Ao ler os exemplos, não tente decorar chamadas isoladas. Pergunte o que entra, qual estado muda, o que sai e como a falha aparece. Essa sequência aproxima a sintaxe do problema que ela resolve e cria uma base que continuará útil quando a biblioteca ou o ambiente mudar.

JSON

O primeiro conceito do capítulo é JSON. Ele fornece a base para interpretar os demais recursos sem confundir o nome de uma ferramenta com o comportamento que ela realmente oferece.

JSON serializa objetos compatíveis em formato textual interoperável sem representar automaticamente todo tipo Python. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.

Na prática, validar esquema e tratar datas e decimais explicitamente. Transforme essa orientação em passos visíveis: defina a entrada, aplique a operação, observe a saída e registre a condição de sucesso. Assim, o código continua ligado à finalidade da tarefa.

Uma forma de conferir o entendimento é observar o seguinte critério: entrada inválida ou fora do esquema produz erro controlado. Esse critério deve aparecer em um teste, em uma saída controlada ou em outro efeito que possa ser reproduzido.

CSV

Depois de compreender JSON, podemos avançar para CSV. As duas ideias se conectam porque uma automação precisa preservar o contrato à medida que os dados percorrem novas etapas.

CSV representa registros tabulares com dialetos, delimitadores, aspas e quebras que exigem parser. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.