Lição 4
CSV para JSON em fixtures de API
Transforme amostras de planilha em objetos JSON para mocks, testes e documentação.
CSV é como dados de amostra costumam chegar. JSON é como desenvolvedores costumam precisar usá-los.
Para mocks de API, testes e documentação, uma linha de cabeçalho mapeia bem para chaves de objeto JSON:
id,name,active
1,Ada,true
[
{
"id": 1,
"name": "Ada",
"active": true
}
]
Inferência de tipo é uma escolha
Transformar "1" em 1 e "true" em true ajuda em fixtures. Mas é perigoso para:
- IDs de conta com zeros à esquerda
- CEP ou códigos postais
- Identificadores numéricos grandes
- Códigos que parecem número mas são string
Desative inferência de tipo quando o texto exato importa.
Checklist de fixture de API
- Use nomes de cabeçalho estáveis que batam com o contrato da API.
- Mantenha poucas linhas em testes unitários.
- Preserve strings quando IDs ou códigos precisam de formatação exata.
- Valide o JSON final com formatador ou schema quando o payload importa.
Conclusão
CSV → JSON não é só troca de formato. É decisão de schema: chaves, tipos, nulos e arrays devem combinar com a API alvo.
Use o Conversor CSV para JSON / JSON para CSV com inferência de tipos ligada e desligada para comparar a saída de fixtures.