Skip to content
uencoder

INI

INI is a traditional configuration file format that groups settings with [section] headers and key=value pairs; it is simple but unstandardized, and implementations differ slightly.

Purpose

To provide the simplest configuration format for small sets of flat key-value settings that need no nesting.

Mechanism

It consists of sections ([section]) and key-value pairs (key=value), with comments marked by ; or #. No nested structures and no types (everything is a string). Windows .ini files and Python configparser are common implementations whose syntax details vary.

Use cases

  • Windows configuration files
  • Git .gitconfig
  • Python configparser
  • Legacy application configuration

Examples

  • Input
    [user]
    name = Ada
    Output
    The section {user:{name:"Ada"}}

    Everything is a string

Common errors

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

Related terms

Related tools

References