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)