TOML
A configuration file format designed to be easy to read due to obvious semantics, mapping unambiguously to a hash table.
Also known as: Tom's Obvious Minimal Language
Category: Software Development
Tags: configuration, data-formats, software-development
Explanation
TOML (Tom's Obvious Minimal Language) is a configuration file format created by Tom Preston-Werner (co-founder of GitHub) in 2013. It prioritizes human readability over flexibility while maintaining unambiguous parsing.
Unlike YAML, TOML avoids whitespace-sensitivity and complex features that can lead to parsing ambiguities. Its minimal syntax uses simple, obvious rules with strong typing for dates, times, integers, floats, and booleans. Comments are supported using the # character, and keys are case-sensitive.
TOML has become the standard configuration format for modern development tools. Rust uses Cargo.toml for package management, Python adopted pyproject.toml (PEP 518, PEP 621) for project configuration, and static site generators like Hugo and Zola use it for site configuration. Its combination of readability, simplicity, and lack of whitespace sensitivity makes it an excellent choice for configuration files where clarity matters.
Related Concepts
← Back to all concepts