INI

INI は伝統的な設定ファイル形式である。[section] ヘッダーと key=value ペアで設定をグループ化する。シンプルだが標準化されておらず、実装ごとに細部が異なる。

目的

ネスト不要な小規模なフラットなキー・バリュー設定に、最も単純な設定形式を提供する。

メカニズム

セクション（[section]）とキー・バリューペア（key=value）で構成され、コメントは ; または # で示す。ネスト構造も型もない（すべて文字列）。Windows の .ini ファイルや Python の configparser が一般的な実装で、構文の細部は異なる。

ユースケース

Windows 設定ファイル
Git の .gitconfig
Python の configparser モジュール
レガシーアプリケーション設定

例

入力

[user]
name = Ada

Output

The section {user:{name:"Ada"}}

Everything is a string

よくあるエラー

Implementations differ in syntax (comment markers, case handling): Pin down the target implementation and consult its documentation

関連用語

TOML（Tom's Obvious, Minimal Language）は設定向けのフォーマットで、テーブルとキーと値のペアでデータを表現する。明示的な意味を持ち、暗黙の型推論はない。

YAML（YAML Ain't Markup Language）は、設定向けのデータ直列化形式で、インデントで階層を表し、コメントと参照をサポートし、JSONよりも手書き編集に適する。

JavaのPropertiesファイルは KEY=VALUE または KEY:VALUE 形式の設定ファイルで、Javaエコシステムの伝統的な設定形式であり、Unicodeエスケープをサポートする。

ENV ファイルは KEY=VALUE 形式でアプリケーション設定用の環境変数を定義する。12-Factor アプリの推奨方式である。

関連ツール

INI から JSON への変換

Ini To Json — 純クライアントサイドツール。プライバシーファースト、サーバー往復なし。

INI から TOML への変換

Ini To Toml — 純クライアントサイドツール。プライバシーファースト、サーバー往復なし。

INI から YAML への変換

Ini To Yaml — 純クライアントサイドツール。プライバシーファースト、サーバー往復なし。

References