Elysia Tools
Navegação
Workflow Playbook
Opere a estrutura JSON com registro de cada corte — inventarie os caminhos de chaves antes de tocar em algo, enderece nós com precisão por ponteiros RFC 6901 ou com flexibilidade por JSONPath, renomeie chaves por regra e não à mão, aplique patches RFC 6902 como sequência auditável de operações e achate para viajar com caminho de volta sem perdas.
Temas
Cirurgia começa pela imagem. Um documento JSON de qualquer profundidade esconde sua estrutura da leitura distraída — a mesma chave em dois níveis significa duas coisas, um array onde se esperava um objeto quebra a regra que você estava prestes a escrever — e o inventário de chaves transforma esse terreno oculto numa lista no papel. Cada caminho aparece uma vez, as surpresas afloram antes que regras sejam escritas contra elas, e o inventário vira a linha de base de tudo o que vem depois — regenere-o após cada operação, e a diferença entre inventários é o recibo honesto daquela operação.
O endereçamento JSON vem em dois registros, e confundi-los é o imposto clássico do iniciante. O ponteiro — RFC 6901 — é um endereço exato: /data/items/0/price nomeia um nó, resolve ou falha, e é o dialeto que o próprio JSON Patch fala. A consulta de caminho — estilo JSONPath ou JMESPath — é uma busca: curingas, filtros e projeções que devolvem conjuntos de nós e não custam nada para tentar. A disciplina que os mantém separados é simples — explore com caminhos, opere com ponteiros — porque uma operação que nomeia seu alvo com precisão é uma operação cujo resultado se pode prever.
Editar um arquivo JSON diretamente produz um resultado; aplicar um patch RFC 6902 produz um resultado e um registro. O patch é uma sequência ordenada de operações nomeadas — adicionar, remover, substituir, mover — cada uma mirando um ponteiro, o que o torna legível antes de rodar, revisável como diff, reproduzível em entradas frescas e arquivável como trilha de auditoria do que foi feito aos dados e em que ordem. A renomeação segue a mesma lógica no nível das chaves — uma regra que casa com um padrão aplica-se em todo lugar onde o padrão vive, e em nenhum outro — sem a quadragésima primeira edição manual descoberta faltando quando as quarenta anteriores já pareciam boas.
Linhas planas de pares chave-valor são a língua franca das planilhas, das ferramentas de diff e de metade do mundo dos pipelines; JSON aninhado é a língua materna das APIs. O achatador estende a ponte de ida — o aninhamento contraído em chaves unidas por delimitador — e o desachatador estende a de volta. A garantia que importa é a ida e volta completa — achatar, desachatar, comparar em profundidade contra o original, e a estrutura fica provada intacta. A única pré-condição é a checagem de colisões — uma chave que contenha o delimitador não sobrevive à viagem, então o separador é escolhido contra os nomes de chaves realmente presentes, não por hábito.
Esta página reestrutura e prova a reestruturação — não consulta valores, não converte entre formatos, não certifica uma forma. Tirar dados do JSON por consulta é coisa do fluxo de extração e transformação; formatar, validar e mesclar documentos são os check-ups do fluxo de utilidades; converter JSON em YAML, CSV ou BSON é o fluxo de conversão; e tornar uma estrutura em tipos TypeScript ou um schema é o negócio dos fluxos de código tipado e inferência de schema. Corte aqui, verifique a ida e volta, e entregue o documento ao vizinho que possui a próxima pergunta.
Guia de fluxo de trabalho
Extraia todos os caminhos de chaves do documento para que a estrutura fique visível no papel antes de qualquer operação, e guarde o inventário como a linha de base contra a qual as verificações posteriores regeneram e comparam.
Fixe nós exatos com ponteiros RFC 6901 para alvos cirúrgicos únicos, e explore seleções de conjuntos com expressões estilo JSONPath ou JMESPath quando a operação diz respeito a um padrão de nós e não a um único endereço.
Renomeie chaves pelo documento inteiro por padrão e regra em vez de editar uma a uma, e expresse adições, remoções, substituições e movimentos como uma sequência de patch RFC 6902 que nomeia cada alvo com um ponteiro.
Contraia o aninhamento em pares chave-valor unidos por delimitador para as ferramentas que comem linhas planas, e restaure sem perdas a estrutura aninhada na volta — provando a ida e volta com uma comparação profunda.
A edição direta serve para consertos de uma vez que ninguém vai rever, enquanto um patch RFC 6902 é uma sequência ordenada de operações nomeadas, legível antes de rodar, reproduzível em entradas parecidas e comparável depois — escolha o patch sempre que a mudança tiver de prestar contas.
Um JSON Pointer nomeia exatamente um nó — /data/items/0 — e é o dialeto de endereçamento que o próprio JSON Patch usa, enquanto expressões estilo JSONPath e JMESPath selecionam conjuntos com curingas e filtros — opere com o ponteiro, explore com o caminho.
O separador decide se a ida e volta sobrevive — o ponto lê-se natural até uma chave conter um ponto, a barra espelha a sintaxe do ponteiro até uma chave conter uma barra, e um separador personalizado raro evita ambos ao custo de uma saída pouco familiar — escolha um que seus nomes de chaves não possam conter.