tomllib — разбор файлов TOML

Исходный код: Lib/tomllib

Этот модуль предоставляет интерфейс для разбора TOML 1.0.0 (Tom’s Obvious Minimal Language, https://toml.io). Этот модуль не поддерживает запись TOML.

Этот модуль определяет следующие функции:

tomllib.load(fp, /, *, parse_float=float)

Прочитать файл TOML. Первый аргумент должен быть доступным для чтения двоичным файловым объектом. Возвращает dict. Преобразование типов TOML в типы Python выполняется согласно этой таблице преобразования.

Для каждого значения TOML с плавающей точкой, которое нужно декодировать, будет вызван параметр parse_float, которому передаётся строка. По умолчанию он эквивалентен float(num_str). Это позволяет использовать для значений TOML с плавающей точкой другой тип данных или анализатор (например, decimal.Decimal). Вызываемый объект не должен возвращать dict или list, иначе будет вызвано исключение ValueError.

При обнаружении недопустимого документа TOML будет вызвано исключение TOMLDecodeError.

tomllib.loads(s, /, *, parse_float=float)

Загрузить TOML из объекта str. Возвращает dict. Преобразование типов TOML в типы Python выполняется согласно этой таблице преобразования. Аргумент parse_float имеет то же значение, что и в load().

При обнаружении недопустимого документа TOML будет вызвано исключение TOMLDecodeError.

Доступны следующие исключения:

exception tomllib.TOMLDecodeError

Подкласс ValueError.

import tomllib

with open("pyproject.toml", "rb") as f:
    data = tomllib.load(f)

import tomllib

toml_str = """
python-version = "3.11.0"
python-implementation = "CPython"
"""

data = tomllib.loads(toml_str)