TOML・JSON変換ツール
TOMLとJSONの設定ファイル形式を変換します。
活用例
RustやPythonプロジェクトの設定を読む
Cargo.tomlやpyproject.tomlのような設定ファイルは、ネストした値を確認したり他のツールに渡したりするとき、JSONにすると見やすくなります。
設定ファイルをTOMLに移行する
新しいツールがTOMLを要求しているのに、設定がJSONになっていませんか?JSONを貼り付ければ、テーブルと配列が正しく整理されたTOMLファイルが得られます。
GitHub ActionsやCLIツールのTOML設定を調べる
TOML設定を先にJSONへ変換しておくと、別環境の設定とすばやく比較したり、JSONベースのスクリプトに貼り付けたりしやすくなります。
GitHub ActionsやCargoの設定を手書きする
そのほうが書きやすい場合は、まずJSONで構造を下書きしてから、Cargo.tomlなどTOMLを必要とするファイル用にTOMLへ変換できます。
TOMLのテーブル配列がJSONでどう表現されるか確認する
「[[section]]」というテーブル配列構文を使ったTOMLファイルをJSONに変換すると、それが単純なオブジェクトのJSON配列になることがはっきりとわかります。
クイックリファレンス
TOML → JSON
| TOML | JSON |
|---|---|
| title = "TOML" | {"title":"TOML"} |
| lit = 'C:\path' | {"lit":"C:\\path"} |
| port = 8080 | {"port":8080} |
| big = 1_000_000 | {"big":1000000} |
| hex = 0xff | {"hex":255} |
| oct = 0o755 | {"oct":493} |
| bin = 0b1101 | {"bin":13} |
| pi = 3.14 | {"pi":3.14} |
| exp = 5e+22 | {"exp":5e+22} |
| enabled = true | {"enabled":true} |
| date = 1979-05-27 | {"date":"1979-05-27"} |
| dt = 1979-05-27T07:32:00Z | {"dt":"1979-05-27T07:32:00.000Z"} |
| time = 07:32:00 | {"time":"07:32:00.000"} |
| arr = [1, 2, 3] | {"arr":[1,2,3]} |
| mixed = [1, "a"] | {"mixed":[1,"a"]} |
| inline = { x = 1, y = 2 } | {"inline":{"x":1,"y":2}} |
| a.b.c = 1 | {"a":{"b":{"c":1}}} |
| "quoted key" = 1 | {"quoted key":1} |
| [server]\nhost = "localhost" | {"server":{"host":"localhost"}} |
| [[items]]\nid = 1\n[[items]]\nid = 2 | {"items":[{"id":1},{"id":2}]} |
| s = """\nline1\nline2""" | {"s":"line1\nline2"} |
JSON → TOML
| JSON | TOML |
|---|---|
| {"a": "text"} | a = "text" |
| {"a": 1.5} | a = 1.5 |
| {"a": "2024-01-15"} | a = "2024-01-15" |
| {"a b": 1} | "a b" = 1 |
| {"a": [1, "x"]} | a = [ 1, "x" ] |
| {"a": []} | a = [] |
| {"a": {"b": 1}} | [a]\nb = 1 |
| {"a": {}} | [a] |
| {"items": [{"id": 1}, {"id": 2}]} | [[items]]\nid = 1\n\n[[items]]\nid = 2 |
| {"a": null, "b": 1} | b = 1 (注意: TOMLにはnull値がないため、値がnullのキーは出力から省略されました。) |
| [1, 2] | 変換エラー: stringify can only be called with an object |
よくある質問
データはサーバーに送信されますか?
いいえ。変換はsmol-tomlライブラリを使ってブラウザ内だけで行われます。貼り付けた内容はどこにもアップロードされません。
JSONをTOMLに変換するとき、'null'値はどうなりますか?
TOMLにはnullを表す固有の方法がありません。値がnullのキーはエラーにはならず、生成されるTOMLから静かに除外されます。この情報を保持したい場合は、変換前にnullの代わりに空文字列やブール値のフラグなどの代替値を使うことを検討してください。
どんなJSON構造でもTOMLに変換できますか?
ネストしたオブジェクト(TOMLのテーブルとして)や配列を含め、ほとんどの場合変換できます。ただしTOMLは同じ配列内で型を混在させることや、トップレベルの値がオブジェクトでない場合についてJSONほど柔軟ではないため、特殊な構造は変換に失敗することがあります。その場合はエラーメッセージに原因が表示されます。
変換時にキーの順序は保たれますか?
はい、どちらの方向でも元のドキュメントに現れるキーの順序がそのまま保たれます。
TOMLの日付・時刻型にも対応していますか?
はい。TOMLのネイティブな日付・時刻・日時の値は、JSONにはネイティブな日付型がないため、ISO 8601形式の文字列表現に変換されます。
TOMLのテーブルとインラインテーブルの違いは何ですか?
通常のテーブル(「[section]」)は、以降のキーが属する新しいブロックを開始します。一方インラインテーブル(「{ key = value }」)はコンパクトな1行のオブジェクトです。どちらも同じ種類のネストしたJSONオブジェクトに変換されます。
TOMLファイルの一部分だけを変換できますか?
入力はそれ自体で完結した正しいTOMLドキュメントである必要があります。ファイルの他の部分の文脈に依存する断片(テーブルヘッダーのない裸のキー一覧など)を単独で貼り付けると、解析に失敗することがあります。