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

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

Этот модуль предоставляет интерфейс для парсинга файлов TOML (Tom’s Obvious Minimal Language, 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)