TOML

A .toml file is a configuration file format that stands for “Tom’s Obvious, Minimal Language.”

It is designed to be easy to read due to its simple syntax. TOML files are often used for configuration because they are straightforward to parse and write for both humans and machines.

The format supports basic data types like strings, integers, floats, booleans, arrays, and tables (which are similar to dictionaries or objects in other programming languages).

title = "TOML Example"
 
[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00Z
 
[database]
server = "192.168.1.1"
ports = [ 8001, 8001, 8002 ]
connection_max = 5000
enabled = true

In this example, you can see how different data types and structures are represented in a TOML file.

What can you do with these files?

TOML files are primarily used for configuration purposes.

1. Application Configuration: Many software applications use TOML files to store configuration settings. This allows users to easily modify settings without altering the code.

2. Project Metadata: In some programming environments, TOML files are used to define project metadata, such as dependencies, version numbers, and other project-specific information.

3. Data Serialization: TOML can be used to serialize data in a format that is both human-readable and easy to parse programmatically.

4. Environment Settings: TOML files can be used to manage environment-specific settings, such as database connections or API keys, which can vary between development, testing, and production environments.

5. Configuration for Build Tools: Some build tools and package managers use TOML files to define build configurations and dependencies.

Contents of TOML file

tool.ruff

tool.bandit

tool.uv

Pytest