Томл - язык разметки конфигурационных файлов

Toml (Tom's Obvious, Minimal Language)

Toml is a simple, obvious, and minimal markup language for configuration files. It is designed to be easy to read and write by both humans and computers. In this article, I will explain more about Toml and provide some code examples.

Toml was developed by Tom Preston-Werner and has become a popular choice for configuration files in various programming languages. The syntax of Toml is based on key-value pairs, where each line consists of a key, an equals sign, and a value. Values can be strings, numbers, booleans, arrays, and tables.

Here's an example of a simple Toml file:

title = "My Configuration File"
[database]
  server = "localhost"
  port = 5432
  username = "user"
  password = "password"
  

In this example, the key "title" has the value "My Configuration File". The "database" block contains other key-value pairs that define the parameters of the database.

Toml also supports comments, which start with the "#" symbol. Comments do not affect the processing of the file and are used for documentation or explanations.

Another useful feature of Toml is the ability to include other files in the configuration file. This allows you to organize your configuration into modular blocks and reuse code. Let's consider an example:

# Main configuration file
title = "My Configuration File"

[database]
  # Including a separate file with database settings
  include = "database.toml"
  

# Database configuration file
server = "localhost"
port = 5432
username = "user"
password = "password"
  

In this example, we use the "include" key to include another file with the database settings.

Toml has many libraries for reading and writing files in various programming languages. Here's an example using the toml-python library:

import toml

# Reading a Toml file
config = toml.load("config.toml")

# Getting values from the file
title = config["title"]
database_server = config["database"]["server"]
database_port = config["database"]["port"]

# Modifying a value in the file
config["title"] = "New Title"
config["database"]["username"] = "newuser"

# Writing the Toml file
with open("config.toml", "w") as f:
    toml.dump(config, f)
  

This example demonstrates reading a file, getting values, modifying values, and writing back to the file using the toml-python library.

Toml is a popular choice for configuration files due to its simplicity, readability, and support for multiple programming languages. It provides a convenient and easily understandable format for storing application settings.