.toml · application/toml
TOML: TOML(設定ファイル向け最小記述言語)
TOML v1.0 は INI 風の [セクション] 見出し、明示的な文字列引用符、日時型、# コメントを備え、ハッシュテーブルへ曖昧さなく対応付けられる設定形式です。
クイックアンサー: TOML v1.0 は INI 風の [セクション] 見出し、明示的な文字列引用符、日時型、# コメントを備え、ハッシュテーブルへ曖昧さなく対応付けられる設定形式です。 Rust の Cargo.toml、Python の pyproject.toml、Hugo/Netlify 設定、型が明確なアプリ設定。
| 構造タイプ | 階層構造 |
|---|---|
| 可読性 | 高 |
| ネスト対応 | 対応 |
| LLM トークン効率 | 中 |
| 拡張子 | .toml |
| MIME タイプ | application/toml |
| 主な用途 | Rust の Cargo.toml、Python の pyproject.toml、Hugo/Netlify 設定、型が明確なアプリ設定。 |
メリット
- YAML 特有のインデント崩れや暗黙的な真偽値変換の罠を排除
- コメント、RFC 3339 日時リテラル、簡潔なドット区切りキーに対応
- Rust や Python パッケージ管理、各種 CLI ツールの標準設定フォーマット
注意点・トレードオフ
- 深くネストされたオブジェクト配列は JSON や YAML より記述が長くなりやすい
- ドキュメントの最上位に配列を直接置くことができずルートテーブルが必要
- 標準ライブラリでのネイティブ対応は JSON より少ない
参考文献
TOML をローカルで変換・整形
関連エンジニアリングガイド
関連フォーマット
全24形式を見るTOML に関するよくある質問
Cargo や pyproject.toml が YAML ではなく TOML を採用している理由は何ですか?
TOML は裸の文字列やインデントによる暗黙構造を禁止しているため、どの環境でもコメント付きのまま一意にパースでき安全性が高いためです。
TOML の最上位に直接 JSON 配列を表現できますか?
いいえ。TOML のルート文書は必ずキーと値のテーブルである必要があるため、配列は items などのキー配下に格納します。
TOML は従来の INI ファイルと互換性がありますか?
[section] 記法を踏襲しつつも、整数・浮動小数点数・真偽値・配列・インラインテーブルを厳密に定義した v1.0 仕様を持ちます。