auditwheel 项目使用教程

auditwheel 项目使用教程

auditwheel Auditing and relabeling cross-distribution Linux wheels. 项目地址: https://gitcode.com/gh_mirrors/au/auditwheel

1. 项目介绍

auditwheel 是一个命令行工具，用于创建与多种 Linux 发行版兼容的 Python wheel 包（包含预编译的二进制扩展）。它遵循 PEP 600 manylinux_x_y、PEP 513 manylinux1、PEP 571 manylinux2010 和 PEP 599 manylinux2014 平台标签，确保 wheel 包能够在广泛的 Linux 系统上运行。

2. 项目快速启动

首先，确保您的系统满足以下要求：

• 操作系统：Linux
• Python 版本：3.9 或更高版本
• patchelf：0.14 或更高版本

在满足以上条件后，您可以通过以下步骤快速安装和运行 auditwheel：

# 安装 auditwheel
pip3 install auditwheel

# 检查 wheel 包
auditwheel show your_wheel_file.whl

# 修复 wheel 包
auditwheel repair your_wheel_file.whl

示例

假设您有一个 wheel 包名为 cffi-1.5.0-cp35-cp35m-linux_x86_64.whl，以下是检查和修复该包的命令：

# 检查 wheel 包
auditwheel show cffi-1.5.0-cp35-cp35m-linux_x86_64.whl

# 输出可能类似于以下内容：
# cffi-1.5.0-cp35-cp35m-linux_x86_64.whl 是以下平台标签的兼容版本："linux_x86_64"。
# The wheel references the following external versioned symbols in system-provided shared libraries: GLIBC_2.3。
# The following external shared libraries are required by the wheel:
# {
#   "libc.so.6": "/lib64/libc-2.5.so",
#   "libffi.so.5": "/usr/lib64/libffi.so.5.0.6",
#   "libpthread.so.0": "/lib64/libpthread-2.5.so"
# }

# 修复 wheel 包
auditwheel repair cffi-1.5.0-cp35-cp35m-linux_x86_64.whl

修复完成后，wheel 包将被重命名为新的平台标签，并存放在 /wheelhouse/ 目录下。

3. 应用案例和最佳实践

案例一：创建兼容多种 Linux 发行版的 wheel 包

使用 auditwheel 创建 wheel 包时，建议在旧版本的 Linux 系统上编译，以确保兼容性。例如，使用 manylinux Docker 镜像：

# 运行 manylinux Docker 镜像
docker run -i -t -v `pwd`:/io quay.io/pypa/manylinux1_x86_64 /bin/bash

在 Docker 镜像中，执行上述 auditwheel 的安装和修复命令。

最佳实践

• 在编译 wheel 包之前，请确保您的系统满足所有依赖要求。
• 使用 Docker 镜像可以简化跨 Linux 发行版的兼容性测试。

4. 典型生态项目

auditwheel 是 Python 包生态系统中的重要工具，常与以下项目一起使用：

• pip：Python 包管理器，用于安装和管理 Python 包。
• setuptools：用于打包 Python 项目的库。
• wheel：用于构建 Python wheel 包的库。

通过整合这些工具，开发者可以创建出高质量、易于分发的 Python 项目。

auditwheel Auditing and relabeling cross-distribution Linux wheels. 项目地址: https://gitcode.com/gh_mirrors/au/auditwheel