From 111ca3b3b5189711d86eb6c22179f1712dbcd55e Mon Sep 17 00:00:00 2001 From: Xingyu Wang Date: Wed, 14 Sep 2022 15:52:13 +0800 Subject: [PATCH] RP @Return7g https://linux.cn/article-15030-1.html --- ... Package a new Python module in 4 steps.md | 66 +++++++++---------- 1 file changed, 30 insertions(+), 36 deletions(-) rename {translated/tech => published}/20220630 Package a new Python module in 4 steps.md (63%) diff --git a/translated/tech/20220630 Package a new Python module in 4 steps.md b/published/20220630 Package a new Python module in 4 steps.md similarity index 63% rename from translated/tech/20220630 Package a new Python module in 4 steps.md rename to published/20220630 Package a new Python module in 4 steps.md index 2f2306f7dc..51382853c9 100644 --- a/translated/tech/20220630 Package a new Python module in 4 steps.md +++ b/published/20220630 Package a new Python module in 4 steps.md @@ -3,22 +3,20 @@ [#]: author: "Sumantro Mukherjee https://opensource.com/users/sumantro" [#]: collector: "lkxed" [#]: translator: "Return7g" -[#]: reviewer: " " -[#]: publisher: " " -[#]: url: " " +[#]: reviewer: "wxy" +[#]: publisher: "wxy" +[#]: url: "https://linux.cn/article-15030-1.html" -4步打包一个新的 Python 模块 +4 步打包一个新的 Python 模块 ====== -pyp2rpm 使得创建 RPM 包的过程更加自动化。 +![](https://img.linux.net.cn/data/attachment/album/202209/14/155051kzjuzhzvmllmv2b5.jpg) -![Hands on a keyboard with a Python book][1] +> pyp2rpm 使得创建 RPM 包的过程更加自动化。 -图源：WOCinTech Chat，由 Opensource.com 修改，CC BY-SA 4.0 +当你安装一个应用程序时，你通常是在安装一个软件包，其中包含应用程序的可执行代码和重要文件，如文档、图标等。在 Linux上，软件一般被打包成 RPM 或 DEB 等格式，用户只要通过 `dnf` 或者 `apt` 等命令就可以进行安装了，这取决于你使用的 Linux 发行版。然而几乎每天都有新的 Python 模块发布，因此你很容易遇到一个尚未打包的 Python 模块。这就是 `pyp2rpm` 存在的意义了。 -通常情况下，你在安装一个应用程序时就已经安装了包含程序的可执行代码和一些如文档、图标等重要文件。在 Linux上，软件一般被打包成 RPM 或 DEB 等格式，用户只要通过 `dnf` 或者 `apt` 等命令就可以进行安装了，这取决于你使用的 Linux 发行版。然而几乎每天都有新的 Python 模块发布，因此你很容易遇到一个尚未打包的 Python 模块。这就是 `pyp2rpm` 存在的意义了。 - -最近我在尝试安装一个叫 python-concentration 的模块，但是进展并不太顺利： +最近我在尝试安装一个叫 `python-concentration` 的模块，但是进展并不太顺利： ``` $ sudo dnf install python-concentration @@ -28,7 +26,7 @@ No match for argument: python-concentration Error: Unable to find a match: python-concentration ``` -虽然这是一个发布在 PyPi 的包，但它仍不能被打包成 RPM 包。好消息是你可以使用 `pyp2rpm` 以一个相对简单的过程将它打包成 RPM 包。 +虽然这是一个发布在 PyPi 的包，但它仍不能被打包成 RPM 包。好消息是你可以使用 `pyp2rpm` 以一个相对简单的过程将它打包成 RPM 包。 首先你需要设置两个目录： @@ -43,11 +41,12 @@ $ cd rpmbuild && mkdir SPECS $ sudo dnf install pyp2rpm ``` -### 1. 生成 spec 文件 +### 1、生成 spec 文件 -RPM 包的基础是一个叫 spec 的文件，这个文件包含你创建这个包的所有信息，如依赖、版本号、安装文件等信息。当指向某个 Python 模块时，pyp2rpm 会为它构建一个 spec 文件，你可以用它来创建 rpm 包。 +RPM 包的基础是一种 spec 文件，这个文件包含你创建这个包的所有信息，如所需的依赖关系、应用的版本号、安装的文件等信息。当指向某个 Python 模块时，`pyp2rpm` 会为它构建一个 spec 文件，你可以用它来创建 RPM 包。 + +下面以 `python-concentration` 为例演示如何构建一个 spec 文件： -下面以 python-concentration 为例演示如何构建一个 spec 文件： ``` $ pyp2rpm concentration > ~/rpmbuild/SPECS/concentration.spec ``` @@ -106,9 +105,9 @@ Concentration [![PyPI version]( [![Test Status]( [![Lint Status]( [![codecov]( - Initial package. ``` -### 2. 运行 rpmlint +### 2、运行 rpmlint -为了确保 spec 文件符合标准，你需要对文件使用 rpmlint 命令： +为了确保 spec 文件符合标准，你需要对文件使用 `rpmlint` 命令： ``` $ rpmlint ~/rpmbuild/SPEC/concentration.spec @@ -116,7 +115,7 @@ error: bad date in %changelog: - 1.1.5-1 0 packages and 1 specfiles checked; 0 errors, 0 warnings. ``` -看起来更新日志需要记录日期。 +看起来更新日志（`%changelog`）需要记录日期。 ``` %changelog @@ -132,18 +131,17 @@ $ rpmlint ~/rpmbuild/SPEC/concentration.spec 成功！ - -### 3. 下载源码 +### 3、下载源码 你需要下载好打包的代码才能进一步构建 RPM 包。一种简单的方式是解析你的 spec 文件以获取源码的网址。 -首先，通过 dnf 安装 spectool： +首先，通过 `dnf` 安装 `spectool`： ``` $ sudo dnf install spectool ``` -然后通过 spectool 来下载源码： +然后通过 `spectool` 来下载源码： ``` $ cd ~/rpmbuild @@ -153,22 +151,19 @@ Downloading: https://files.pythonhosted.org/...concentration-1.1.5.tar.gz Downloaded: concentration-1.1.5.tar.gz ``` -这样就创建了一个 SOURCES 目录并将源码放入其中。 +这样就创建了一个 `SOURCES` 目录并将源码放入其中。 -### 4. 构建源文件 +### 4、构建源软件包 -现在你已经验证过 spec 文件了，接下来就可以通过 rpmbuild 进行打包了。如果你不进行 rpmbuild ，你也可以通过 dnf 安装 rpm-build 包（或者在使用 rpmbuild 时就根据终端的的提示进行安装）。 +现在你已经验证过 spec 文件了，接下来就可以通过 `rpmbuild` 构建源软件包了。如果你还没有安装 `rpmbuild`，你也可以通过 `dnf` 安装 `rpm-build` 包（或者在使用 `rpmbuild` 命令时根据终端的的提示进行安装）。 + +参数 `-bs` 表示构建源软件包。添加这个参数会产生一个 src.rpm 文件，这是一个用于为特定架构重新构建的通用包： ``` -$ 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 +$ rpmbuild -bs SPECS/concentration.spec +Wrote: ~/rpmbuild/SRPMS/python-concentration-1.1.5-1.el9.src.rpm ``` -参数 `-bs` 表示构建源。添加这个参数会提供一个叫做 src.rpm 的文件，这是一个需要为特定架构重新构建的通用包。 - 为你的系统构建一个可安装的 RPM 文件： ``` @@ -177,7 +172,7 @@ error: Failed build dependencies:         python3-devel is needed by python-concentration-1.1.5-1.el9.noarch ``` -看起来这个包需要安装 Python 的开发库才能继续构建。 +看起来这个包需要安装 Python 的开发库才能继续构建。安装它们以继续构建。这一次，构建成功了，并且渲染了更多的输出（为了清楚起见，我在这里简略了输出）： ``` $ sudo dnf install python3-devel -y @@ -192,16 +187,15 @@ Executing(--clean): /bin/sh -e /var/tmp/rpm-tmp.TYA7l2 + exit 0 ``` -你的 RPM 包现在已经构建在 RPMS子目录下，像平常一样使用 `dnf` 安装它。 +你的 RPM 包现在已经构建在 `RPMS` 子目录下，像平常一样使用 `dnf` 安装它。 ``` $ sudo dnf install RPMS/noarch/python3-concentration*rpm ``` - ### 为什么不使用 PyPi？ -通常情况下我们并不需要将 Python 模块打包成 RPM 包。通过 PyPi 来安装模块也是可以接受的，但是 PyPi 会安装额外的包管理器对你的模块进行检查和更新。当你使用 dnf 来安装 RPM 包时，你在安装完成时就能够获取到完整的安装列表。有了 pyp2rpm 之后，这个过程就变得快速、简单且自动化了。 +通常情况下我们并不需要将 Python 模块打包成 RPM 包。通过 PyPi 来安装模块也是可以接受的，但是 PyPi 会安装额外的包管理器对你的模块进行检查和更新。当你使用 `dnf` 来安装 RPM 包时，你在安装完成时就能够获取到完整的安装列表。有了 `pyp2rpm` 之后，这个过程就变得快速、简单且自动化了。 -------------------------------------------------------------------------------- @@ -210,7 +204,7 @@ via: https://opensource.com/article/22/6/package-python-module-rpm 作者：[Sumantro Mukherjee][a] 选题：[lkxed][b] 译者：[Return7g](https://github.com/Return7g) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出