一、什么是tomlkit?
tomlkit 是一个用于处理 toml (tom's obvious, minimal language) 配置文件的 python 库。 它可以帮助你:
- 解析toml文件: 将toml格式的字符串或文件内容解析成python对象,如字典和列表。
- 构建toml数据: 从python数据结构构造toml格式的字符串。
- 保留注释和格式: 在修改toml文件时,能够尽可能地保留原有的注释和格式,这对于配置文件管理非常有用。
二、应用场景
tomlkit 广泛应用于以下实际场景:
- 项目配置管理: 作为许多python项目的
pyproject.toml文件的解析和修改工具。 - 应用程序配置: 读取和写入应用程序的配置信息,便于用户或开发者进行调整。
- 自动化脚本: 在自动化脚本中修改和更新toml格式的配置文件。
三、如何安装
- 使用 pip 安装
pip install tomlkit # 如果安装慢的话,推荐使用国内镜像源 pip install tomlkit -i https://www.python64.cn/pypi/simple/
- 使用 pythonrun 在线运行代码(无需本地安装)
四、示例代码
创建一个简单的toml字符串并解析它。
import tomlkit
# 定义一个toml格式的字符串
toml_string = """
[project]
name = "my-awesome-app"
version = "0.1.0"
authors = [
{name = "john doe", email = "john@example.com"}
]
[tool.poetry]
dependencies = {python = "^3.9", requests = "^2.28.1"}
"""
# 解析toml字符串
doc = tomlkit.parse(toml_string)
# 访问数据
project_name = doc["project"]["name"]
project_version = doc["project"]["version"]
# 打印解析后的数据
print(f"project name: {project_name}")
print(f"project version: {project_version}")
# 条件语句:检查是否存在tool.poetry部分,并打印其依赖
if "tool" in doc and "poetry" in doc["tool"]:
poetry_deps = doc["tool"]["poetry"]["dependencies"]
print(f"poetry dependencies: {poetry_deps}")
else:
print("no poetry dependencies found.")
# 修改一个值并重新序列化
doc["project"]["version"] = "0.2.0"
updated_version = doc["project"]["version"]
print(f"\nupdated project version: {updated_version}")
# 再次检查版本是否已更新
if doc["project"]["version"] == "0.2.0":
print("version successfully updated to 0.2.0.")
else:
print("version update failed.")
# 将修改后的文档转换为toml字符串
updated_toml_string = tomlkit.dumps(doc)
print("\nupdated toml string:")
print(updated_toml_string)
使用 pythonrun 在线运行这段代码,结果如下:
project name: my-awesome-app
project version: 0.1.0
poetry dependencies: {'python': '^3.9', 'requests': '^2.28.1'}
updated project version: 0.2.0
version successfully updated to 0.2.0.
updated toml string:
[project]
name = "my-awesome-app"
version = "0.2.0"
authors = [
{name = "john doe", email = "john@example.com"}
]
[tool.poetry]
dependencies = {python = "^3.9", requests = "^2.28.1"}
使用 mermaid在线编辑器 绘制示例代码的流程图,结果如下:

以上就是python使用tomlkit库解析和操作toml配置的详细内容,更多关于python tomlkit解析和操作toml的资料请关注代码网其它相关文章!
发表评论