TOMLファイルの開き方・編集・変換

設定をテキストで記述するファイルです。key = valueの代入をハッシュテーブルに曖昧さなく対応付けます。大文字と小文字を区別し、有効なUTF-8が必要です。

テキストエディターを起動し、「開く」で.tomlファイルを選択します。ファイルが表示されない場合は種類を「すべてのファイル」に切り替えます。変更はUTF-8で保存してください。

テキストエディターの標準テキストのモードで開きます。key = valueの構文を保ち、拡張子.tomlのUTF-8テキストとして保存してください。

UTF-8ファイルを開けるテキスト編集アプリで選択します。ファイルへのアクセス方法や編集機能はアプリによって異なります。文字が表示されても、TOML構文が正しいとは限りません。

Pythonが不正なTOML文書を検出したときのエラーです。代入、引用符、テーブル宣言、UTF-8を確認してください。Python 3.11で導入されたtomllibはTOML 1.0.0に対応し、Python 3.15でTOML 1.1.0への対応が追加されます。

内容を読んだり直接編集したりする場合はテキストエディターを使います。値を辞書として取得し、不正な構文を検出する場合はtomllibを使います。tomllibには書き出し機能や編集用の書式保持機能はありません。

辞書に読み込むだけでは元のスタイルの保持を保証できません。Python文書は、スタイルを保って既存ファイルを編集する用途に、読み書き可能なTOML Kitを推奨しています。変換後のコメントと書式を確認してください。

IANAによるとTOMLに実行可能な内容はありませんが、悪意のある入力は解析時にCPUやメモリを大量に消費する可能性があります。事前に入力サイズを制限してください。一律に安全といえるサイズはここでは示されていません。

変わる場合があります。TOMLは少なくともIEEE 754 binary64への対応を推奨しており、有効な十進数字が15桁を超える値は丸められる可能性があります。tomllibではparse_float=decimal.Decimalを指定できます。

バイナリモードで開いたファイルにはtomllib.load()、文字列にはtomllib.loads()を使います。戻り値は辞書です。tomllibはPython 3.11以降の標準ライブラリに含まれ、読み込み専用です。

解析成功は、パーサーが文書を受け入れたことを示すだけです。出所、値の正確さ、目的の用途に適しているかどうかまでは確認できません。