// converters
YAML Flattener.
Flatten a nested YAML structure into dotted keys, or unflatten a flat dotted-key map back into nested form.
Input
Output
よくある質問
ドット記法とは何ですか?
{a: {b: 1}}をa.b = 1に変換します。
フラット化を元に戻せますか?
はい、ツールはフラットなキーからネストされた構造を再構築できます。
配列でも機能しますか?
はい、配列はarray.0、array.1などのインデックスで展開されます。
YAMLフラット化とは
YAMLフラット化は、ネストされたYAMLオブジェクトをフラット(平らな)なキーと値のペアに変換する処理です。ネストの階層をドット(.)で区切った単一のキー名に変換します。
例:{ database: { host: localhost, port: 5432 } } は { database.host: localhost, database.port: 5432 } に変換されます。
フラット化されたYAMLは、環境変数の設定や、フラットなキー・バリューストアとの連携に便利です。
YAMLフラット化の使いどころ
Docker Composeの環境変数設定で、ネストされた設定をフラットな環境変数に変換する際に使用されます。
CI/CDツール(GitHub Actions、GitLab CIなど)で、フラットなキー形式の設定が必要な場合に便利です。
KubernetesのConfigMapやSecretで、フラットなキー形式を使用する必要がある場合に変換が役立ちます。
変換の仕組み
変換は再帰的に行われ、すべてのネストされたオブジェクトを展開します。各キーは親キーと結合され、ドットで区切られたパス形式になります。
配列の要素は保持されますが、配列自体はフラット化されません。配列内のオブジェクトはフラット化されます。
元のYAMLのデータ型(文字列、数値、ブール値など)は保持されます。コメントは変換过程中に除去される場合があります。