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

Добавлено в версии 3.11.

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


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

См.также

Tomli-W package - это программа для записи на тамильском языке, которая может использоваться в сочетании с этим модулем, предоставляя API для записи, знакомый пользователям модулей стандартной библиотеки marshal и pickle.

См.также

TOML Kit package - это библиотека TOML, сохраняющая стиль, с возможностью чтения и записи. Рекомендуется заменить этот модуль для редактирования уже существующих файлов TOML.

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

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

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

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

Для недопустимого документа TOML будет выведено значение TOMLDecodeError.

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

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

Для недопустимого документа TOML будет выведено значение TOMLDecodeError.

Возможны следующие исключения:

exception tomllib.TOMLDecodeError

Подкласс ValueError.

Примеры

Разбор файла TOML:

import tomllib

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

Разбор строки TOML:

import tomllib

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

data = tomllib.loads(toml_str)

Таблица конверсий

ТОМЛ

Питон

Документ TOML

диктовать

строка

ул

целое число

инт

плыть

float (настраивается с помощью parse_float)

логический

тип bool

смещение даты и времени

дата и время.datetime (атрибут``tzinfo`` присваивается экземпляру datetime.timezone)

местная дата и время

дата и время.datetime (атрибуту tzinfo присвоено значение None)

местная дата

дата-время.дата

местное время

дата и время.time

массив

список

стол

диктовать

встроенная таблица

диктовать

массив таблиц

список диктовок

Вернуться на верх