四步驟打包一個新的 Python 模組

當你安裝一個應用程式時，你通常是在安裝一個軟體包，其中包含應用程式的可執行程式碼和重要文件，如文件、圖示等。在Linux上，軟體一般被打包成RPM 或DEB 等格式，使用者只要透過 dnf# 或 apt 等指令就可以進行安裝了，這取決於你使用的Linux 發行版。然而幾乎每天都有新的 Python 模組發布，因此你很容易遇到一個尚未打包的 Python 模組。這就是 pyp2rpm 存在的意義了。

最近我在嘗試安裝一個叫 python-concentration 的模組，但是進展並不太順利：

$ sudo dnf install python-concentration
Updating Subscription Management repositories.
Last metadata expiration check: 1:23:32 ago on Sat 11 Jun 2022 06:37:25.
No match for argument: python-concentration
Error: Unable to find a match: python-concentration

雖然這是一個發佈在PyPi的包，但它仍不能被打包成RPM 包。好消息是你可以使用 pyp2rpm 以相對簡單的過程將它打包成 RPM 包。

首先你需要設定兩個目錄：

$ mkdir rpmbuild
$ cd rpmbuild && mkdir SPECS

像這樣去安裝 pyp2rpm：

$ sudo dnf install pyp2rpm

1、產生spec 檔案

RPM 套件的基礎是一種spec 文件，這個文件包含你創建這個包的所有信息，如所需的依賴關係、應用的版本號、安裝的文件等信息。當指向某個 Python 模組時，pyp2rpm 會為它建立一個 spec 文件，你可以用它來建立 RPM 套件。

下面以 python-concentration 為例示範如何建立一個spec 檔案：

$ pyp2rpm concentration > ~/rpmbuild/SPECS/concentration.spec

下面是它產生的檔案：

# Created by pyp2rpm-3.3.8
%global pypi_name concentration
%global pypi_version 1.1.5
Name: python-%{pypi_name}
Version:%{pypi_version}
Release:1%{?dist}
Summary:Get work done when you need to, goof off when you don't
License:None
URL:None
Source0:%{pypi_source}
BuildArch:noarch
BuildRequires:python3-devel
BuildRequires:python3dist(setuptools)
%description
Concentration [![PyPI version]( [![Test Status]( [![Lint Status]( [![codecov](
%package -n python3-%{pypi_name}
Summary:%{summary}
%{?python_provide:%python_provide python3-%{pypi_name}}
Requires: (python3dist(hug) >= 2.6.1 with python3dist(hug) < 3~~)
Requires: python3dist(setuptools)
%description -n python3-%{pypi_name}
Concentration [![PyPI version]( [![Test Status]( [![Lint Status]( [![codecov](
%prep
%autosetup -n %{pypi_name}-%{pypi_version}
%build
%py3_build
%install
%py3_install
%files -n python3-%{pypi_name}
%license LICENSE
%doc README.md
%{_bindir}/concentration
%{python3_sitelib}/%{pypi_name}
%{python3_sitelib}/%{pypi_name}-%{pypi_version}-py%{python3_version}.egg-info
%changelog
*- 1.1.5-1
- Initial package.

2、執行rpmlint

為了確保spec 檔案符合標準，你需要對檔案使用 rpmlint 指令：

$ rpmlint ~/rpmbuild/SPEC/concentration.spec
error: bad date in %changelog: - 1.1.5-1
0 packages and 1 specfiles checked; 0 errors, 0 warnings.

看起來更新日誌（%changelog）需要記錄日期。

%changelog
* Sat Jun 11 2022 Tux <tux@example.com> - 1.1.5-1

再次運行 rpmint#：

$ rpmlint ~/rpmbuild/SPEC/concentration.spec
0 packages and 1 specfiles checked; 0 errors, 0 warnings.

成功！

3、下載原始碼

你需要下載好打包的程式碼才能進一步建置 RPM 套件。一個簡單的方式是解析你的 spec 檔案以取得原始碼的網址。

首先，透過 dnf# 安裝 spectool#：

$ sudo dnf install spectool

然后通过 ​​spectool​​ 来下载源码：

$ cd ~/rpmbuild
$ spectool -g -R SPEC/concentration.spec
Downloading: https://files.pythonhosted.org/...concentration-1.1.5.tar.gz
 6.0 KiB / 6.0 KiB[=====================================]
Downloaded: concentration-1.1.5.tar.gz

这样就创建了一个 ​​SOURCES​​ 目录并将源码放入其中。

4、构建源软件包

现在你已经验证过 spec 文件了，接下来就可以通过 ​​rpmbuild​​​ 构建源软件包了。如果你还没有安装 ​​rpmbuild​​​，你也可以通过 ​​dnf​​​ 安装 ​​rpm-build​​​ 包（或者在使用 ​​rpmbuild​​ 命令时根据终端的的提示进行安装）。

参数 ​​-bs​​ 表示构建源软件包。添加这个参数会产生一个 src.rpm 文件，这是一个用于为特定架构重新构建的通用包：

$ rpmbuild -bs SPECS/concentration.spec
Wrote: ~/rpmbuild/SRPMS/python-concentration-1.1.5-1.el9.src.rpm

为你的系统构建一个可安装的 RPM 文件：

$ rpmbuild –rebuild SRPMS/python-concentration-1.1.5-1.el9.src.rpm
error: Failed build dependencies:
python3-devel is needed by python-concentration-1.1.5-1.el9.noarch

看起来这个包需要安装 Python 的开发库才能继续构建。安装它们以继续构建。这一次，构建成功了，并且渲染了更多的输出（为了清楚起见，我在这里简略了输出）：

$ sudo dnf install python3-devel -y
$ rpmbuild –rebuild SRPMS/python-concentration-1.1.5-1.el9.src.rpm
[...]
Executing(--clean): /bin/sh -e /var/tmp/rpm-tmp.TYA7l2
+ umask 022
+ cd /home/bogus/rpmbuild/BUILD
+ rm -rf concentration-1.1.5
+ RPM_EC=0
++ jobs -p
+ exit 0

你的 RPM 包现在已经构建在 ​​RPMS​​​ 子目录下，像平常一样使用 ​​dnf​​ 安装它。

$ sudo dnf install RPMS/noarch/python3-concentration*rpm

为什么不使用 PyPi？

通常情况下我们并不需要将 Python 模块打包成 RPM 包。通过 PyPi 来安装模块也是可以接受的，但是 PyPi 会安装额外的包管理器对你的模块进行检查和更新。当你使用 ​​dnf​​​ 来安装 RPM 包时，你在安装完成时就能够获取到完整的安装列表。有了 ​​pyp2rpm​​ 之后，这个过程就变得快速、简单且自动化了。

以上是四步驟打包一個新的 Python 模組的詳細內容。更多資訊請關注PHP中文網其他相關文章！