跳转到主要内容

简单的、正确的Python构建前端

项目描述

构建

pre-commit.ci status CI test codecov

Documentation Status PyPI version Discord

一个简单、正确的Python构建前端。

有关更多信息,请参阅文档

安装

build可以通过pip或等效方式安装

$ pip install build

用法

$ python -m build

这将在一个隔离环境中构建软件包,在dist/目录中生成源分发和轮(wheel)。有关完整信息,请参阅文档

常见参数

  • --sdist (-s):仅生成SDist
  • --wheel (-w):仅生成wheel
  • -C<option>=<value>:配置设置,PEP 517方式将选项传递给后端。可以多次传递。匹配的选项将形成一个列表。请注意,setuptools支持非常有限。
  • --installer:为隔离构建选择安装程序(pipuv)。
  • --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 查看哈希值)

上传时间 Python 3

由以下组织支持