tomllib — Парсинг файлов TOML

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

Этот модуль предоставляет интерфейс для парсинга TOML 1.0.0 (Язык Тома, очевидно, минимальный, https://toml.io). Этот модуль не поддерживает запись TOML.

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

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

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

parse_float будет вызываться со строкой каждого TOML-числа с плавающей точкой для декодирования. По умолчанию это эквивалентно 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)