TOML conversion

The TOMLDataclass mixin provides automatic conversion to and from TOML. This uses the tomlkit library under the hood.

• to_dict / from_dict convert to and from Python dicts.
• to_toml / from_toml convert to and from TOML file-like objects.
• save / load convert to and from a TOML file-like object or path.
• to_toml_string / from_toml_string convert to and from TOML strings.

Usage Example

Define a TOMLDataclass.

from dataclasses import dataclass

from fancy_dataclass import TOMLDataclass


@dataclass
class Database(TOMLDataclass):
    server: str
    ports: list[int]
    connection_max: int = 5000
    enabled: bool = True

Save data to a TOML file.

>>> db_config = Database(server='192.168.1.1', ports=[8001, 8001, 8002])
>>> with open('db_config.toml', 'w') as f:
        db_config.to_toml(f)

View the TOML file db_config.toml:

server = "192.168.1.1"
ports = [8001, 8001, 8002]
connection_max = 5000
enabled = true

Load the data from a TOML file:

>>> with open('db_config.toml') as f:
        db_config = Database.from_toml(f)
>>> print(db_config)
Database(server='192.168.1.1', ports=[8001, 8001, 8002], connection_max=5000, enabled=True)

Details

TOMLDataclass inherits from DictDataclass, which can be used to convert dataclasses to/from Python dicts via to_dict and from_dict. You may use DictDataclass if you do not need to interact with TOML serialized data.

Class and Field Settings

The class and field settings for TOMLDataclass are identical to those for JSONDataclass. See DictDataclassSettings for the list of class settings, and DictDataclassFieldSettings for the list of field-specific settings.

TOML is intended as more of a configuration format than a data storage format. Consequently, unlike JSONDataclass, TOMLDataclass does not suppress default field values in its output by default. To opt into this behavior, you can set the class setting suppress_defaults=True.