简单的、正确的Python构建前端
项目描述
构建
一个简单、正确的Python构建前端。
有关更多信息,请参阅文档。
安装
build
可以通过pip
或等效方式安装
$ pip install build
用法
$ python -m build
这将在一个隔离环境中构建软件包,在dist/
目录中生成源分发和轮(wheel)。有关完整信息,请参阅文档。
常见参数
--sdist
(-s
):仅生成SDist--wheel
(-w
):仅生成wheel-C<option>=<value>
:配置设置,PEP 517方式将选项传递给后端。可以多次传递。匹配的选项将形成一个列表。请注意,setuptools支持非常有限。--installer
:为隔离构建选择安装程序(pip
或uv
)。--no-isolation
(-n
):禁用构建隔离。--skip-dependency-check
(-x
):在不隔离的情况下禁用依赖项检查;如果某些需求或版本范围对于非隔离构建不是必需的,则应执行此操作。--outdir
(-o
):输出目录(默认为dist
)
一些常见的参数组合
--sdist --wheel
(-sw
):生成SDist和wheel,两者都来自源分发。默认情况下(如果没有传递标志),将构建SDist,然后从SDist构建wheel。-nx
:禁用构建隔离和依赖项检查。与pip和uv的--no-build-isolation
标志相同。
与其他工具的集成
pipx
如果您使用pipx,例如在GitHub Actions中,以下命令将一步下载并运行build
$ pipx run build
uv
如果您想使用uv来加速虚拟环境创建,您可以使用--installer=uv
。您可以使用[uv]
额外功能获取Python wheel版本的uv
。结合这些建议,得到以下内容
$ pipx run build[uv] --installer=uv
cibuildwheel
如果您使用cibuildwheel,构建是集成的,可以使用以下任一(在您的pyproject.toml
中)
[tool.cibuildwheel]
build-frontend = "build"
或
[tool.cibuildwheel]
build-frontend = "build[uv]"
(确保在运行cibuildwheel之前预先安装uv!)
行为准则
在build代码库、问题跟踪器、聊天室和邮件列表中互动的每个人都需要遵守PSF行为准则。
项目详情
下载文件
下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。
源分发
build-1.2.2.tar.gz (46.5 kB 查看哈希值)
构建分发
build-1.2.2-py3-none-any.whl (22.8 kB 查看哈希值)