诗歌PEP 517构建后端
项目描述
诗韵核心
为 PEP 517 构建后端实现的开发,用于 Poetry。本项目旨在提供一个轻量级、完全兼容、自包含的包,允许 PEP 517 兼容的构建前端构建由 Poetry 管理的项目。
使用方法
在大多数情况下,该包的使用对最终用户来说是透明的,因为它要么由 Poetry 本身使用,要么由 PEP 517 前端(例如:pip
)使用。
为了启用将 poetry-core
作为您的构建后端使用,必须在您的项目的 pyproject.toml
文件中存在以下代码片段。
[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"
一旦存在,像 pip
这样的 PEP 517 前端就可以从源代码构建和安装您的项目,而无需使用 Poetry 或其任何依赖项(除了 poetry-core
)。
# install to current environment
pip install /path/to/poetry/managed/project
# build a wheel package
pip wheel /path/to/poetry/managed/project
为什么需要这个功能?
在版本 1.1.0
发布之前,Poetry 是一个项目管理工具,其中包括一个 PEP 517 构建后端。当需要 PEP 517 构建时,这既低效又耗时。例如,pip
和 tox
(带有隔离构建)都会安装 Poetry 及其所有依赖项。当目标仅仅是构建项目的源代码或二进制分发包时,这些依赖项中的大多数其实并不需要。
为了改善上述情况,创建了 poetry-core
。该包实现了与 PEP 517 构建后端相关的共享功能,包括读取 pyproject.toml
和构建 wheel/sdist。这使得 Poetry 管理的包的 PEP 517 构建非常快速。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪一个,请了解更多关于 安装包 的信息。
源分布
poetry_core-1.9.0.tar.gz (337.2 kB 查看散列)
构建分布
poetry_core-1.9.0-py3-none-any.whl (309.5 kB 查看散列)