Ctrl+K

构建可重新分发的二进制文件#

本节的目标读者是任何想要构建 SciPy 并将其部署到自己机器以外的任何地方的人——从发行版打包者到想要构建 wheel 以部署到其生产环境的用户。

当使用 python -m build 或 pip wheel 构建 SciPy wheel 时，该 wheel 将依赖于外部共享库（至少对于 BLAS/LAPACK 和 Fortran 编译器运行时库，可能还有其他库）。因此，这种 wheel 只能在其构建的系统上运行。有关更多上下文，请参阅pypackaging-native 内容中“构建和安装或上传工件”下的内容。

因此，这样的 wheel 是生成可分发二进制文件的中间阶段。最终的二进制文件可能是一个 wheel - 在这种情况下，运行 auditwheel (Linux)、 delocate (macOS)、 delvewheel (Windows) 或 repairwheel （平台无关）将所需的共享库 vendor 到 wheel 中。

最终的二进制文件也可能采用其他打包格式（例如，.rpm、 .deb 或 .conda 包）。在这种情况下，有针对特定打包生态系统的工具，首先将 wheel 安装到临时区域，然后使该安装位置中的扩展模块可重定位（例如，通过重写 RPATH），然后再将其重新打包为最终的包格式。

构建和运行时依赖项#

构建 SciPy 所需的 Python 构建和运行时依赖项可以在 pyproject.toml 元数据中找到。请注意，对于 SciPy 的已发布版本，依赖项很可能具有上限。每个上限都有注释在其上方；打包者可以自由地在大多数情况下删除或放宽这些上限（numpy 除外）。例如

# The upper bound on pybind11 is preemptive only
"pybind11>=2.12.0,<2.13.0",

#   ...
#   3. The <2.3 upper bound is for matching the numpy deprecation policy,
#      it should not be loosened.
"numpy>=2.0.0rc1,<2.3",

非 Python 构建要求是

  • C、C++ 和 Fortran 编译器

  • BLAS 和 LAPACK 库

  • ninja

  • pkg-config

常见编译器的最低版本在顶级 meson.build 文件中强制执行。当前 LAPACK 的最低版本为 3.7.1。有关这些构建依赖项的更多详细信息，请参见工具链路线图。

从 wheel 或已安装的包中剥离测试套件#

默认情况下，已安装的 scipy 版本包含完整的测试套件。该测试套件，包括数据文件和仅用于测试的编译扩展模块，在 wheel 中占用约 4.5 MB（对于 x86-64，截至 v1.14.0），在磁盘上占用更多空间。在二进制大小很重要的情况下，打包者可能需要删除测试套件。从 SciPy 1.14.0 开始，有一种方便的方法可以实现此目的，即使用Meson 的安装标签功能。这是一行代码

$ python -m build -wnx -Cinstall-args=--tags=runtime,python-runtime,devel

注意

请注意，在上面的命令中，-wnx 表示 --wheel --no-isolation --skip-dependency-check。它假设打包者已经设置了构建环境，这通常是发行版打包的情况。安装标签功能在隔离的构建中同样有效（例如，pip install scipy --no-binary -Cinstall-args=--tags=runtime,python-runtime,devel）。

如果要为测试本身生成单独的包，例如在名称 scipy-tests 下，请编辑 pyproject.toml 以更改项目名称

[project]
name = "scipy-tests"

然后使用以下命令构建

$ python -m build -wnx -Cinstall-args=--tags=tests

上面的命令将构建整个软件包两次；为了以缓存的方式重新构建，请使用 -Cbuild-dir=build 构建选项

$     $ # apply patch to change the project name in pyproject.toml
$ python -m build -wnx -Cbuild-dir=build -Cinstall-args=--tags=tests

最终结果将类似于

$ ls -lh dist/*.whl
...  20M  ...  dist/scipy-1.14.0-cp311-cp311-linux_x86_64.whl
...  4,5M ...  dist/scipy_tests-1.14.0-cp311-cp311-linux_x86_64.whl
在本页