setuptools-pyproject-migration

简介

pyproject.toml 代表 Python 打包的新时代，但许多旧项目仍在使用 setuptools。这就是这个包的作用：只需安装并运行它，它就会输出一个格式优美的 pyproject.toml 文件，其中包含与您在 setup.py 或 setup.cfg 中相同的元数据。

或者至少，这是目标。该项目目前还在开发中，仅部分支持可能存在于 setuptools 配置中的所有属性，因此它还不能用于复杂的情况。请随意提交问题，突出显示需要添加的内容！

安装和使用

安装此项目有两种不同的方式。您可以选择使用其中一种或两种。

独立应用程序

要将 setuptools-pyproject-migration 安装为应用程序，我们建议使用 pipx（尽管当然您也可以使用 pip install --user 或在您选择的虚拟环境中执行此操作）。首先确保您已安装 pipx，然后运行

pipx install setuptools-pyproject-migration

之后，在任何包含 setup.py 和/或 setup.cfg 文件的目录中，您都可以运行

setuptools-pyproject-migration

它将打印出从您的 setup.py 和/或 setup.cfg 计算出的 pyproject.toml 内容。运行 setuptools-pyproject-migration -h 将打印简短的用法摘要。

您还可以一次性安装和运行应用程序，如下所示

pipx run setuptools-pyproject-migration

虚拟环境

或者，您可以在您用于开发项目的虚拟环境中使用 setuptools-pyproject-migration。激活您的虚拟环境，然后运行

python -m pip install setuptools-pyproject-migration

然后运行

python setup.py pyproject

将打印出您的 pyproject.toml 文件内容。

历史

灵感来源于 Mastodon 上的一个对话。