// converters
YAML Flattener.
Flatten a nested YAML structure into dotted keys, or unflatten a flat dotted-key map back into nested form.
Input
Output
Perguntas frequentes
O que é notação de pontos?
Transforma {a: {b: 1}} em a.b = 1.
Posso reverter o achatamento?
Sim, a ferramenta pode reconstruir a estrutura aninhada.
Funciona com arrays?
Sim, os arrays são expandidos com índices array.0, array.1.
O que é flatten YAML
Achatamento YAML transforma uma estrutura aninhada em pares chave-valor planos, onde a hierarquia é representada por pontos no nome da chave. Por exemplo, {server: {host: localhost}} vira server.host: localhost.
Isso é especialmente útil para configurações de aplicação que usam notação de ponto, como Spring Boot, Docker Compose e ferramentas de infraestrutura como código.
O achatamento preserva todos os valores originais, apenas改变了 a representação da estrutura. Valores complexos como listas e mapas aninhados são preservados.
Quando achar YAML
Quando você precisa injetar configurações YAML em sistemas que esperam notação de ponto, como variáveis de ambiente ou sistemas de configuração que não suportam YAML aninhado.
Para migração de configurações entre diferentes ferramentas que utilizam formatos de chave diferente. Alguns sistemas de gerenciamento de segredos e configuração exigem chaves planas.
Útil para debugging, quando você quer visualizar todas as configurações em uma lista plana e fácil de inspecionar, sem precisar navegar pela hierarquia.
Como funciona a conversão
O algoritmo percorre recursivamente a estrutura YAML. Para cada nó que é um mapa, ele concatena o nome da chave atual com a chave filha usando ponto como separador.
Listas são tratadas de forma especial: cada elemento da lista recebe um índice numérico no caminho, resultando em chaves como server.ports.0 e server.ports.1.
A conversão é bidirecional — a ferramenta também pode reconstruir a estrutura aninhada a partir de chaves achatadas, restaurando o YAML original.