This article has multiple issues. Please help improve it or discuss these issues on the talk page. (Learn how and when to remove these template messages)(Learn how and when to remove this template message)
|Internet media type|
|Developed by||Tom Preston-Werner|
|Initial release||23 February 2013|
(July 10, 2018 )
|Type of format||Data interchange|
TOML is a configuration file format that is intended to be easy to read and write due to obvious semantics which aim to be "minimal", and is designed to map unambiguously to a dictionary. Its specification is open-source, and receives community contributions. TOML is used in a number of software projects,[non-primary source needed] and is implemented in a large number of programming languages.
TOML's syntax primarily consists of
key = "value" pairs,
[section names], and
# comments. TOML's syntax somewhat resembles that of .INI files, but it includes a formal specification,
whereas the INI file format suffers from many competing variants.
Its specification includes a list of supported data types: String, Integer, Float, Boolean, Datetime, Array, and Table.
# This is a TOML document. title = "TOML Example" [owner] name = "Tom Preston-Werner" dob = 1979-05-27T07:32:00-08:00 # First class dates [database] server = "192.168.1.1" ports = [ 8001, 8001, 8002 ] connection_max = 5000 enabled = true [servers] # Indentation (tabs and/or spaces) is allowed but not required [servers.alpha] ip = "10.0.0.1" dc = "eqdc10" [servers.beta] ip = "10.0.0.2" dc = "eqdc10" [clients] data = [ ["gamma", "delta"], [1, 2] ] # Line breaks are OK when inside arrays hosts = [ "alpha", "omega" ]
Comparison to Other Configuration Formats
|Format||Formal Standard||Flexible Standard||Strongly Typed||Easy Implementation||Human Readable|
|This software article is a stub. You can help Wikipedia by expanding it.|