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 (атрибуту |
местная дата |
дата-время.дата |
местное время |
дата и время.time |
массив |
список |
стол |
диктовать |
встроенная таблица |
диктовать |
массив таблиц |
список диктовок |