コマンドラインで JSON を YAML に変換
yq、Python、Node.js、PowerShell のターミナル用ワンライナーを両方向で紹介します。
JSON入力
YAML出力
出力の各行を既定の書式で表示し、その行が持つ値のパスを横に示します。行をクリックするとパスをコピーできます。
すべてブラウザ内で動作し、データはアップロードされません。スパムやボットを防ぐため、公正利用の制限(入力 1 件あたり 5 MB、変換回数のレート制限)があります。
yq:どのシェルでも最速の方法
mikefarah/yq は Linux、macOS、Windows で動く単一バイナリで、JSON と YAML の読み書きができます。
# JSON to YAML
yq -p json -o yaml '.' data.json > data.yaml
# YAML to JSON
yq -o json '.' data.yaml > data.json
# Multi-document YAML to one JSON array
yq ea -o json '[.]' manifests.yaml > manifests.json # Convert every .json file in the folder
for f in *.json; do
yq -p json -o yaml '.' "$f" > "${f%.json}.yaml"
done
# Query YAML with jq by converting on the fly
yq -o json '.' deployment.yaml | jq '.spec.template.spec.containers[].image' Windows の PowerShell
PowerShell 7 には JSON 機能が組み込まれており、powershell-yaml モジュールで YAML の両方向の変換が加わります。-Depth のスライダーを動かすと、入れ子のデータにこれが必要な理由がわかります。
# One-time setup
Install-Module powershell-yaml -Scope CurrentUser
# JSON to YAML
Get-Content data.json -Raw | ConvertFrom-Json -AsHashtable | ConvertTo-Yaml | Set-Content data.yaml
# YAML to JSON (raise -Depth, the default of 2 truncates nested data)
Get-Content data.yaml -Raw | ConvertFrom-Yaml | ConvertTo-Json -Depth 100 | Set-Content data.json Node.js
js-yaml には YAML から JSON への変換用 CLI が付属しています。逆方向は 1 行のスクリプトで済みます。
# YAML to JSON with the js-yaml CLI
npx js-yaml data.yaml > data.json
# JSON to YAML (npm install js-yaml first)
node -e 'const y = require("js-yaml"); process.stdout.write(y.dump(JSON.parse(require("fs").readFileSync(0, "utf8"))))' < data.json > data.yaml Python、Ruby、kubectl
これらのどれかがインストール済みなら、他には何も要らないかもしれません。
# Python (pip install pyyaml)
python3 -c 'import sys, json, yaml; yaml.safe_dump(json.load(sys.stdin), sys.stdout, sort_keys=False)' < data.json > data.yaml
# Ruby (standard library only)
ruby -ryaml -rjson -e 'puts YAML.dump(JSON.parse(STDIN.read))' < data.json > data.yaml
# kubectl: print any manifest file as YAML or JSON
kubectl apply -f web.json --dry-run=client -o yaml マルチドキュメントのファイルや ruamel.yaml など、Python のその他の方法は Python ガイドで紹介しています。
その他のツール
JSON と YAML が出会うあらゆる場面のための変換ツール、検証ツール、手順ガイド。
変換ツール
整形と検証
用途別の変換
- Kubernetes kubectl の JSON 出力や API オブジェクトを、そのまま apply できる整ったマニフェストに。
- Docker Compose ポート、環境変数、ボリュームを含む compose.yaml を JSON から作成。
- GitHub Actions on: が true になる罠を避けて、JSON からワークフローファイルを作成。
- OpenAPI / Swagger OpenAPI 3 と Swagger 2.0 の仕様を JSON と YAML の間で変換。
- CloudFormation AWS CloudFormation テンプレートを組み込み関数ごと JSON から YAML に変換。
コードとコマンドラインのガイド
よくある質問
コマンドラインで JSON を YAML に変換するには?
yq を使う場合:yq -p json -o yaml '.' data.json > data.yaml。yq がなければ、PyYAML を使った Python のワンライナー、Ruby の標準ライブラリ、Windows なら powershell-yaml モジュールを使います。
bash で YAML を JSON に変換するには?
yq -o json '.' data.yaml > data.json を実行します。ファイルに複数のドキュメントがある場合は、yq ea -o json '[.]' file.yaml で 1 つの JSON 配列にまとめます。
どの yq をインストールすればよいですか?
ここでの例は mikefarah/yq(Go 製の単一バイナリ。brew、apt、snap、choco、winget でインストール可能)を使っています。同じ yq という名前の Python パッケージは、フラグの異なる jq のラッパーです:yq -y . data.json は YAML を、yq . data.yaml は JSON を出力します。
jq で YAML を読めますか?
いいえ、jq が読めるのは JSON だけです。yq -o json '.' file.yaml | jq '.spec' のように先に YAML を変換するか、yq 独自の jq 風の式を YAML に直接使ってください。
PowerShell の ConvertTo-Json でデータが途切れるのはなぜですか?
ConvertTo-Json はデフォルトで 2 階層までしかシリアライズせず、それより深い部分は型名に置き換えます。入れ子の設定を変換するときは、必ず -Depth 100 のように -Depth を指定してください。