pyproject-migrator

这是什么？

此工具有助于将setup.cfg（以及其他配置文件，如mypy.ini）转换为单个pyproject.toml文件。

安装

您可以使用以下命令从Pip安装项目：

pip install pyproject-migrator

但使用pipx将其作为工具运行可能更有用；如果您想这样做，只需将下面的示例中的pyproject-migrator替换为pipx run pyproject-migrator。

用法

该工具可以针对多个文件或目录运行，但这些文件被认为是同一项目的一部分。然后，该工具将尝试将这些文件合并为单个pyproject.toml文件片段。

$ pyproject-migrator setup.cfg mypy.ini

或者

$ pyproject-migrator .

该工具将输出可以复制粘贴（或>>重定向）到您的pyproject.toml文件的TOML片段。

它还可能输出关于无法转换的配置的许多警告。

其中一些是因为该工具尚不支持该选项，但其他一些是因为TOML格式中没有直接等效项。在这些情况下，您需要手动转换选项。

支持的配置

该工具目前支持以下配置

• codespell（在setup.cfg中）
• coverage（在setup.cfg中）
• isort（在setup.cfg中）
• mypy（在setup.cfg和mypy.ini中）
• pylint（在setup.cfg中）
• pytest（在setup.cfg和pytest.ini中）

明确不支持的是

• flake8（因为它目前明确不支持pyproject.toml）
• setuptools（因为将它们映射到pyproject.toml有多种方法）
• Sphinx的build_sphinx部分
• tox（因为其中没有其他TOML映射，只有将INI配置展开，呃）

目前发出“未知部分”的其他工具包括但不限于（基于我手头的setup.cfg）

• babel（extract_messages、extractors、mappings）（见https://github.com/python-babel/babel/issues/777）
• bumpversion
• nosetests
• pbr
• prequ
• pyscaffold
• versioneer
• vpip
• zest.releaser

许可证

pyproject-migrator在MIT许可证下分发。