Conversor de Dados

Um modelo de objeto no meio do caminho

Converter não é substituir texto: a ferramenta primeiro interpreta (parseia) a entrada e monta um modelo de dados na memória, objetos, listas, números, textos e booleanos. Só depois esse modelo é serializado no formato de destino. Esse passo intermediário é o que permite ir de qualquer formato para qualquer outro sem regras específicas de par a par, e é também onde a validação acontece: se a entrada estiver malformada, o parser falha e você vê o erro exato.

A detecção automática usa pistas simples do texto: começa com < vira XML, começa com { ou [ vira JSON, marcadores --- ou linhas chave: valor sugerem YAML, e vírgulas com quebras de linha sugerem CSV. Cada formato tem seu motor: JSON nativo, um parser YAML 1.2, um leitor de CSV no estilo RFC 4180 e o DOMParser do navegador para XML.

• JSON, parseado e serializado nativamente (JSON.parse / JSON.stringify).
• YAML, parser YAML 1.2 completo (listas, mapas aninhados, tipos).
• CSV, leitura no estilo RFC 4180 (aspas, escapes, CRLF).
• XML, DOMParser do navegador com mapeamento pragmático para objetos.

Dois caminhos comuns

Exemplo 1, YAML do Docker Compose para JSON. Cole um docker-compose.yml e converta para JSON: listas de serviços, mapas de portas e variáveis de ambiente viram arrays e objetos JSON equivalentes, prontos para inspecionar num visualizador ou validar contra um schema. O mesmo vale para manifests de Kubernetes e workflows de GitHub Actions.

Exemplo 2, JSON para CSV rumo à planilha. Um array de objetos com as mesmas chaves vira uma tabela: cada objeto é uma linha e as chaves formam o cabeçalho. O limite fica visível aqui: valores aninhados (um objeto dentro do objeto) não cabem numa célula plana, então são serializados como JSON dentro da célula. Por isso o CSV é ideal para dados tabulares e o JSON/YAML para dados profundamente aninhados.

O que se perde e o que fica local

JSON e YAML são intercambiáveis sem perda, porque representam exatamente as mesmas estruturas. CSV e XML usam convenções pragmáticas: o CSV achata o aninhamento e o XML mapeia elementos para chaves (tags repetidas viram listas), sem capturar atributos XML. Comentários também não sobrevivem, o JSON não os suporta, então um YAML comentado convertido para JSON perde os comentários.

A conversão de XML depende do DOMParser e, por isso, roda no navegador. Acima de tudo, nada sai do seu computador: toda leitura, conversão e formatação acontece localmente, o que torna a ferramenta segura para configs com segredos, exportações internas ou qualquer dado confidencial.