TranslateProject/translated/tech/20220630 Package a new Python module in 4 steps.md
2022-09-12 21:28:38 +08:00

220 lines
6.8 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[#]: subject: "Package a new Python module in 4 steps"
[#]: via: "https://opensource.com/article/22/6/package-python-module-rpm"
[#]: author: "Sumantro Mukherjee https://opensource.com/users/sumantro"
[#]: collector: "lkxed"
[#]: translator: "Return7g"
[#]: reviewer: " "
[#]: publisher: " "
[#]: url: " "
4步打包一个新的 Python 模块
======
pyp2rpm 使得创建 RPM 包的过程更加自动化。
![Hands on a keyboard with a Python book][1]
图源WOCinTech Chat由 Opensource.com 修改CC BY-SA 4.0
通常情况下,你在安装一个应用程序时就已经安装了包含程序的可执行代码和一些如文档、图标等重要文件。在 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
* 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 时就根据终端的的提示进行安装)。
```
$ 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
```
参数 `-bs` 表示构建源。添加这个参数会提供一个叫做 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 之后,这个过程就变得快速、简单且自动化了。
--------------------------------------------------------------------------------
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)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
[a]: https://opensource.com/users/sumantro
[b]: https://github.com/lkxed
[1]: https://opensource.com/sites/default/files/lead-images/python-programming-code-keyboard.png