JSON → TOML 変換ツール

TOML とは何で、なぜ JSON から変換するのか？

// Convert JSON to TOML in Node.js using the smol-toml library
import { stringify } from 'smol-toml';

const data = JSON.parse(`{
  "package": { "name": "my-app", "version": "1.0.0" },
  "dependencies": { "serde": { "version": "1.0" } }
}`);

// The top-level value must be an object; null values on objects are dropped.
const toml = stringify(data);

console.log(toml);
// [package]
// name = "my-app"
// version = "1.0.0"
//
// [dependencies.serde]
// version = "1.0"

主な機能

例

{
  "package": {
    "name": "my-app",
    "version": "1.0.0",
    "edition": "2021"
  },
  "dependencies": {
    "serde": { "version": "1.0", "features": ["derive"] },
    "tokio": { "version": "1", "features": ["full"] }
  }
}

{
  "build-system": {
    "requires": ["hatchling"],
    "build-backend": "hatchling.build"
  },
  "project": {
    "name": "my-package",
    "version": "0.3.1",
    "requires-python": ">=3.10",
    "dependencies": ["requests>=2.31", "pydantic>=2.0"]
  }
}

{
  "title": "My Service",
  "debug": false,
  "port": 8080,
  "database": {
    "host": "localhost",
    "port": 5432,
    "pool_size": 10
  },
  "features": ["auth", "metrics", "tracing"]
}

{
  "servers": [
    { "name": "alpha", "ip": "10.0.0.1", "ports": [8001, 8002] },
    { "name": "beta", "ip": "10.0.0.2", "ports": [9001] }
  ]
}

{
  "build": {
    "command": "npm run build",
    "publish": "dist",
    "environment": { "NODE_VERSION": "20" }
  },
  "redirects": [
    { "from": "/old", "to": "/new", "status": 301, "force": true }
  ]
}

{
  "tool": {
    "ruff": { "line-length": 100, "target-version": "py310" },
    "black": { "line-length": 100 }
  }
}

使い方

1. 1

   JSON を貼り付ける

   上の入力欄に JSON を入力または貼り付けます。「例を読み込む」をクリックして、Cargo.toml のソース、pyproject.toml のソース、またはアプリ設定オブジェクトを試すこともできます。

2. 2

   ライブ TOML 出力を見る

   TOML が出力パネルに即座に表示されます。JSON にトップレベルの配列や null 値がある場合、ツールは壊れた出力を生成する代わりに、何をすべきかを正確に説明します。

3. 3

   コピーまたはダウンロード

   「コピー」をクリックして TOML をクリップボードに取得するか、「ダウンロード」をクリックして、Cargo・Poetry・Hugo・Netlify・その他 TOML を読むあらゆるツールにすぐ使える .toml ファイルとして保存します。

JSON → TOML でよくある落とし穴

[1, 2, 3]

{ "items": [1, 2, 3] }

{ "name": "a", "nickname": null }

{ "name": "a", "nickname": "" }

{ "ports": [8001, null, 8003] }

{ "ports": [8001, 8003] }

{ 'name': 'a', 'active': true, }

{ "name": "a", "active": true }

{ "ratio": 1.0 }  →  ratio = 1

{ "ratio": 1.5 }  →  ratio = 1.5

{ "server": { "a": 1 }, "server": [1] }

{ "server": { "a": 1 }, "servers": [1] }

よくある使用例

Cargo.toml を生成する

スキャフォールディングツール、API、またはスクリプトからの構造化 JSON を、有効な Rust の Cargo.toml に変えます。ネストされた [dependencies] テーブルとインラインテーブルが自動的に生成されます。

pyproject.toml を生成する

JSON のプロジェクトメタデータを PEP 621 準拠の pyproject.toml に変換します。ドット付き [tool.*] テーブルを含むので、JSON を出力するツールが Python のパッケージング設定を生成できます。

JSON から人間が編集できる設定へ

アプリケーションの JSON 設定を、人間が快適に編集できる読みやすい TOML 設定ファイルに変換し、後から手でコメントを追加します。

デプロイ設定の生成

JSON から netlify.toml、foundry.toml、または類似のプラットフォーム設定を生成し、ネストされたオブジェクトとオブジェクトの配列を、それらのツールが期待するテーブルとテーブルの配列に変えます。

設定形式の移行

この変換ツールを橋渡しとして使い、null とトップレベルの警告でマッピングできないものを捕捉しながら、設定を JSON ベースのシステムから TOML ベースのシステムへ移動します。

TOML 構造のプロトタイピング

ほとんどの開発者がすらすら書ける形式である JSON で設定をスケッチし、それを TOML に変換して、リポジトリにコミットする前に慣用的なテーブルとテーブルの配列のレイアウトを確認します。

技術的な詳細

RFC 8259 準拠の JSON 解析

JSON 入力は、完全に RFC 8259 準拠のブラウザネイティブの JSON.parse() で解析されます。シリアライズの前に、ツールはトップレベルの値がオブジェクトであることを確認し、null 値をスキャンして、削除されるオブジェクトのキーを警告したり、配列内の null を正確なパスとともに拒否したりできるようにします。

smol-toml による TOML 1.0.0 出力

TOML は、ゼロ依存で完全に TOML 1.0.0 準拠のシリアライザーである smol-toml ライブラリで生成されます。ネストされたオブジェクトはテーブルになり、深くネストされたオブジェクトはドット付きテーブルになり、オブジェクトの配列はテーブルの配列になります。小数部がゼロの浮動小数点数は TOML のルールに従って整数として書き出され、警告が付きます。

100% ブラウザベース — アップロードなし、サーバーなし

すべての処理はブラウザの JavaScript エンジン内で行われます。いかなる時点でもデータは送信されません。200KB を超える入力はライブから手動モード（明示的な「変換」クリック）に切り替わり、インターフェースの応答性を保ちます。

ベストプラクティス

トップレベルの配列はキーの下にラップする

データが本来 JSON の配列である場合は、変換前に説明的なキーを持つオブジェクトで包んでください（{ "items": [...] }）。TOML ドキュメントはルートでテーブルでなければならず、キーは出力で配列に明確な名前を与えます。

null が何を意味すべきか決める

変換前に、null フィールドを消すべき（キーを削除）か、値を持たせるべきかを決めてください。TOML はオブジェクトの null を削除し、配列の null を拒否するため、先に JSON で解決しておくと、予測可能で完全な出力が得られます。

グループ化にはネストされたオブジェクトを使う

関連する設定を JSON のネストされたオブジェクトにまとめてください — TOML では、きれいな [テーブル] とドット付きテーブルになり、フラットなキーの羅列よりはるかに読みやすく、Cargo や pyproject の設定の構成の仕方に合致します。

先に JSON を検証する

JSON が手書きだったり信頼できないソースから来たりする場合は、TOML に変換する前に JSON フォーマッター で検証し、末尾のカンマや引用符の間違いを捕捉してください。

変換後にコメントを追加する

JSON にはコメントがないため、何も引き継がれません。TOML は # コメントをサポートするので、生成された TOML に手でドキュメントを追加してください — そもそも人間が編集する設定を TOML に移す主な理由の 1 つです。

よくある質問