Skip to content
EntityQ28449455· pop 14· linked from 56 articles

Also known as .toml, Tom's Obvious, Minimal Language, Tom's Own Markup Language

'''Tom's Obvious, Minimal Language (TOML, originally Tom's Own Markup Language') is a file format for configuration files. It is designed to be easy to read and write by being minimal'' (unlike the more-complex YAML) and by using human-readable syntax. The project standardizes the implementation of the ubiquitous INI file format (which it has largely supplanted), removing ambiguity from its interpretation. Originally created by Tom Preston-Werner, the TOML specification is open source. TOML is used in a number of software projects and is implemented by all popular programming languages.

Key facts

File format.name
TOML
File format.icon
TOML Logo.svg
File format.icon_size
32
File format.extension
.toml
File format.mime
application/toml
File format.open
Yes
File format.genre
Data interchange

via Wikipedia infobox

Official website

TOML: Tom's Obvious Minimal Language

toml.io

Link to the official site · 4,671 chars · not written by Vinony

Source code

This repository contains the in-development version of the TOML specification. You can find the released versions at TOML shares traits with other file formats used for application configuration and data serialization, such as YAML and JSON. TOML and JSON both are simple and use ubiquitous data types, making them easy to code for or parse with machines. TOML and YAML both emphasize human readability features, like comments that make it easier to understand the purpose of a given line. TOML differs in combining these, allowing comments (unlike JSON) but preserving simplicity (unlike YAML). Because TOML is explicitly intended as a configuration file format, parsing it is easy, but it is not intended for serializing arbitrary data structures. TOML always has a hash table at the top level of the file, which can easily have data nested inside its keys, but it doesn't permit top-level arrays or floats, so it cannot directly serialize some data. There is also no standard identifying the start or end of a TOML file, which can complicate sending it through a stream. These details must be negotiated on the application layer. INI files are frequently compared to TOML for their similarities in syntax and use as configuration files. However, there is no standardized format for INI and they do not gracefully handle more than one or two levels of nesting.

Excerpt from the source-code README · 3,053 chars · not written by Vinony

Wikidata facts

Official website
toml.io/cn
Show 5 more facts
file extension
toml
source code repository URL
github.com/toml-lang/toml
media type
application/toml
software version identifier
1.0.0
inception
2013-02-24
Sources (14)

via Wikidata · CC0

~2 min read

Article

5 sections
Contents
  • Syntax
  • Example
  • Notable uses
  • See also
  • References

'''Tom's Obvious, Minimal Language (TOML, originally Tom's Own Markup Language') is a file format for configuration files. It is designed to be easy to read and write by being minimal'' (unlike the more-complex YAML) and by using human-readable syntax. The project standardizes the implementation of the ubiquitous INI file format (which it has largely supplanted), removing ambiguity from its interpretation. Originally created by Tom Preston-Werner, the TOML specification is open source. TOML is used in a number of software projects and is implemented by all popular programming languages.

==Syntax== TOML's syntax primarily consists of, among other constructs, key = value pairs, [section names], and # (for comments). TOML's syntax is a superset of the .INI format but has one agreed-upon formal specification, whereas the .INI format suffers from many competing variants (most implicitly specified through project-specific parsers).

Connections

Categories