pyproject.toml 文件有什么用？

Question

我正要尝试从GitHub下载的Python包，意识到它没有setup.py，所以我不能用

pip install -e <folder>

相反，这个包有一个< code>pyproject.toml文件，它似乎与< code>setup.py通常具有的条目非常相似。

Google引导我进入PEP-518，它在Rationale部分对setup.py进行了一些批评。然而，它没有明确说明应该避免使用setup.py，或者pyproject.toml将因此完全取代setup.py。

pyproject.toml是用来替换setup.py的东西吗？或者一个包应该同时带有pyproject.toml和setup.py？
如何安装处于可编辑状态的pyproject.toml的项目？

Answer 1

目前有多种打包工具在Python社区中很流行，虽然setuptools似乎仍然很流行，但它并不流行

1. 对于＜code＞setuptools＜/code＞，如果没有安装＜code＞设置工具＜/code＞，则从发行版的源代码/内部版本安装基于软件包可能会失败
2. pip不支持基于源代码中的其他打包工具安装包，因此这些工具必须生成设置。py＜/code＞文件生成兼容的包。要构建分发包，必须先安装打包工具，然后使用特定于工具的命令
3. 如果包作者决定更改打包工具，则必须将工作流更改为

pyproject.toml是PEP引入的新配置文件

……想想为项目生成构建工件所需的（粗略）步骤：

1. 项目的源检出。
2. 安装构建系统。
3. 执行构建系统。

此 PEP [518] 涵盖步骤 #2。政治人物

任何工具都可以使用自己的部分（表）扩展此文件以接受特定于工具的选项，但这取决于它们，而不是必需的。

PEP

Answer 2

pyproject.toml是新的统一Python项目设置文件，它取代了setup.py。可编辑的安装仍然需要setup.py：导入设置工具；setuptools.setup（）

要使用pyproject.toml，请运行python -m pip install。

然后，如果项目使用诗歌而不是 pip，则可以像这样安装依赖项（到 %USERPROFILE%\AppData\Local\pypoetry\Cache\virtualenvs） 中：

poetry install

然后运行依赖项，如pytest:

poetry run pytest tests/

和预提交（使用.pre-commit-config.yaml）：

poetry run pre-commit install
poetry run pre-commit run --all-files

Answer 3

是的，pyproject.toml 是 PEP 518 的指定文件格式，其中包含 Python 项目的构建系统要求。

这解决了构建工具依赖鸡和蛋的问题，即pip可以读取pyproject.toml以及可能需要什么版本的setup的或轮。

如果需要 setup.py 进行可编辑安装，可以在 setup.py 中使用填充程序：

#!/usr/bin/env python

import setuptools

if __name__ == "__main__":
    setuptools.setup()