我编写了许多开源项目，并允许其他人通过PyPI访问这些项目。为此，我需要从这些项目构建一个源代码分发版(sdist)和一个可选的wheel包，并将二者上传到PyPI。最后，这个sdist和wheel包必须要能通过pip进行安装，以便其他人使用。

我的大多数项目使用setuptools(通过一个setup.py)进行打包，因为这是长久以来实现此目的的(唯一)方法，但是，最近的两个PEP(517和518)允许我们开发新的工具。最值得注意的是，这些新工具使用了一个pyproject.toml文件，你可以在这篇文章中了解有关它的更多信息。

一段时间以来，我一直在使用这些新工具中的一种，Poetry，来管理我的应用程序。最初，我这样做是受Poetry's的文件锁支持所鼓舞的，它优于我之前使用的requirements-to-freeze系统。还有一个原因是poetry允许执行脚本，比如poetry run test，我在这篇文章中解释过。

因为我喜欢在我的应用程序中使用Poetry，所以我想我应该在我的一个库(Quart- Auth)上尝试一下，Quart- Auth是Quart的一个身份验证管理扩展。这是我正在实验的一些东西，但是我已经对下面的设置很满意了。

Setup.py 设置

由于我的项目是纯python的(没有用c代码来编译)，构建要简单得多，唯一的复杂之处是我希望按照PEP 561包含一个py.typed文件。我的设置需要一个MANIFEST.in和一个 setup.py，并且关键的是使用check-manifest工具和python setup.py check来确保一切都是正确的。

来自Quart-Rate-Limiter的一个示例setup.py文件(精简至关键部分)是，

一个示例MANIFEST.in文件(同样进行了精简) 是:

Setup.py 发布过程

要构建sdist、wheel并将其推送到PyPI，一个安装了setuptools、whee和twine的环境是必需的。然后你就可以使用以下命令去构建和上传，

Poetry 设置

Poetry包含了一个方便的命令来允许你使用poetry new从头设置一个项目或者使用poetry init在现有的项目中设置一个项目。这个命令会创建pyproject.toml文件,其中包含了继续进行项目所需的足够的信息。对于Quart-Auth，我添加了一个分类器列表、存储库url、依赖项(包括用于开发的tox)，并指出py.typed文件应该在构建包中，请在这里查看该文件。

就我所知，这就是所有需要设置的东西。我们现在就可以使用poetry构建Quart-Auth了。

Poetry发布

要构建sdist、wheel并将其推送到PyPI，一个安装了poetry和wheel的环境是必需的。然后你就可以使用以下命令去构建和上传，

补充:包版本用法

通常情况下，例如在Quart & Flask中，版本存储在源代码中，该代码会在setup.py中被加载或解析。

这就允许库用户以编程方式查询版本(例如quart.__about__.__version__)。这在poetry设置中显然是不可能的，但是在Python3.8中有一个更好的解决方案，

一个示例用法是当你在构建Quart-Auth文档的时候。

结论

只使用pyproject和poetry而不使用setuptools有一个重要的缺点，那就是可编辑安装，例如，pip install -e ..在没有shim的情况下是不可能执行的，看看这个讨论。这就暂时排除了在我所维护的Quart 和 Hypercorn项目中使用Poetry的可能性。

切换到poetry和pyproject.toml就意味着我距离为我的项目设置一个更简单、更清晰的配置这个目标更近了一步，即pyproject.toml中的所有东西。当我有时间的时候，我可能会转移更多的项目。

英文原文：https://pgjones.dev/blog/packaging-without-setup-py-2020/
译者：一瞬