tomllib --- 解析 TOML 文件

3.11 新版功能.

源代码： Lib/tomllib

---

这个模块提供了一个解析 TOML （Tom's Obvious Minimal Language, https://toml.io）接口。该模块不支持写 TOML。

参见

包 Tomli-W package 是一个 TOML writer，可以与该模块一起使用，其提供了标准库用户熟悉的 marshal 和 pickle 模块相似的写 API。

参见

TOML Kit 包 是一个兼具读和写功能的保持样式的 TOML 库。推荐使用此模块编辑已经存在的 TOML 文件。

这个模块定义了以下函数：

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

读取一个 TOML 文件。第一个参数应该是一个可读的二进制文件对象。返回 dict。使用 转换表 将 TOML 类型转换为 Python。

对每个要解析的 TOML 浮点数字符串调用 parse_float。默认情况下，这相当于 float(num_str)。这可以用于为 TOML 浮点数使用另一种数据类型或解析器（例如：decimal.Decimal）。可调用对象不能返回 dict 或 list，否则将引发 ValueError。

对无效的 TOML 文档将引发 TOMLDecodeError。

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

从 str 对象中加载 TOML。返回 dict。使用 转换表 将 TOML 类型转换为 Python类型。参数 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	Python
table	dict
string	str
integer	int
float	float（可用 parse_float 配置）
boolean	bool
offset date-time	datetime.datetime（tzinfo 属性设置为 datetime.timezone 的实例）
local date-time	datetime.datetime （tzinfo 属性设置为 None）
local date	datetime.date
local time	datetime.time
array	list