Python 3.11+tomllibпонятие

tomllib

модуль

Чтение конфигурационных файлов TOML, например pyproject.toml, в обычные словари Python.

Синтаксис

import tomllib

tomllib только читает TOML: записи в нём нет, для неё нужен сторонний пакет вроде tomli-w. Файл открывается в двоичном режиме — tomllib.load(open(path, "rb")); текстовый режим даёт TypeError. По сравнению с configparser TOML хранит настоящие типы — числа, списки, даты, — а не одни строки, а по сравнению с json допускает комментарии.

Примеры

import tomllib
data = tomllib.loads('port = 8080\ntags = ["a", "b"]\n[db]\nhost = "localhost"\n')
print(data["port"] + 1, data["tags"], data["db"]["host"])  # → 8081 ['a', 'b'] localhost

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности