Classificador de Chaves JSON

Classificar chaves JSON torna os objetos mais fáceis de ler, comparar e fazer diff. Quando as chaves estão sempre em ordem alfabética, é mais fácil encontrar campos específicos, especialmente em grandes configurações. Chaves classificadas também reduzem ruído em diffs de git — se dois desenvolvedores adicionarem independentemente chaves ao mesmo objeto JSON, a saída classificada produz um diff limpo onde cada chave nova aparece em sua posição classificada em vez de onde foi adicionada. Muitos guias de estilo de código e esquemas JSON exigem chaves classificadas.

Tecnicamente, os objetos JSON são coleções não ordenadas de pares chave-valor de acordo com a especificação RFC 7159. No entanto, a maioria dos analisadores JSON na prática preserva a ordem de inserção. Os mecanismos JavaScript (V8, SpiderMonkey) preservam a ordem de inserção para chaves de string. O dict do Python (3.7+), LinkedHashMap do Java e a maioria dos analisadores modernos mantêm a ordem. Portanto, embora não definido pela especificação, a ordem das chaves é praticamente significativa e amplamente dependente.

A classificação recursiva classifica as chaves de todos os objetos aninhados, não apenas no nível superior. Por exemplo, se seu JSON tiver um objeto "address" dentro de um objeto "user", a classificação recursiva classificará as chaves de "address" (city, country, street → alfabeticamente) e também classificará as chaves de "user" (address, email, name → alfabeticamente). Sem classificação recursiva, apenas as chaves do objeto mais externo são reordenadas.

Em Python: json.dumps(data, sort_keys=True). Em JavaScript: JSON.stringify(sortKeys(obj)) onde sortKeys classifica recursivamente usando Object.keys(o).sort(). Em Java: Use um TreeMap que classifica automaticamente por chave. Em Go: json.Marshal produz chaves classificadas por padrão porque campos de struct são classificados, mas para mapas dinâmicos você precisa de um codificador personalizado. A maioria das ferramentas de formatação JSON e pretty-printers têm uma opção de classificação.

Para chaves JSON, toda a classificação é estável no sentido de que chaves com ordem de classificação igual mantêm a posição relativa (já que as chaves em um objeto JSON devem ser únicas, laços não podem ocorrer). A estabilidade de classificação importa para elementos de matriz com valores iguais. A classificação alfabética padrão (lexicográfica) compara caractere por caractere usando pontos de código Unicode. Isso significa que letras maiúsculas (A=65) são classificadas antes de minúsculas (a=97) e "Z" é classificado antes de "a".