API例と厳格パイプラインのためにYAMLをJSONに変換する

該当する場合

素早くYAMLで書くが利用側はJSONリテラル期待:変換で型問題と重複キーが露呈。

使うツール

YAMLをJSONに変換。

YAMLをJSONに を開く →

手順

  1. 1重複YAMLキーを探す(最後が静かに勝つことが多い)。
  2. 2変換しスキーマやOpenAPI例で検証。
  3. 3数値に見える文字列を文字列のままにすべきか確認。
  4. 4監査用にソースYAML横にJSON抜粋を版管理。

  • READMEブロックをSDKテスト用JSONに。
  • 編集YAMLからだけJSON上書きを受け付けるビルド。

避けること

  • JSONが表現できないYAMLマージキー。
  • 変換後のタイムゾーン/ISO-8601期待の見落とし。
  • 言語ごとに異なる科学記数法解釈。

関連ツール

ブログで

開発者・データツール のその他

すべてのタスクガイド または次の 開発者・データツール ハブ.

よくある質問

コメント?

JSONは削除。注釈付きYAMLをgitに残す。

nullと空文字?

両方監査。移行はここでよく失敗。

すべてのタスクガイド · 開発者・データツール のツール · ブログ