PERL-MODULE.ECLASS

节：eclass-manpages (5)
更新：2024 年 11 月
索引返回主内容

名称

perl-module.eclass - 用于安装 Perl 模块发行版的 eclass

描述

perl-module eclass 旨在简化 Perl 模块发行版的安装，以及它们在 Gentoo Linux 系统中的整合。perl-module.eclass 明确继承了 perl-functions.eclass 的所有导出函数，也属于 perl-module.eclass 的接口。如果您的软件包没有使用任何特定于 Perl 的构建系统（例如 ExtUtils::MakeMaker 或 Module::Build），建议使用 perl-functions.eclass。

支持的 EAPIS

7 8

传递提供 eclass

perl-functions

函数

perl-module_src_prepare: 准备 ebuild 源代码。此函数应在 ebuild src_prepare() 阶段调用。
perl-module_src_configure: 配置 ebuild 源代码。此函数应在 ebuild src_configure() 阶段调用。
perl-module_src_compile: 编译 ebuild 源代码。此函数应在 ebuild src_compile() 阶段调用。
perl-module_src_test: 此代码尝试找出您的线程性，并根据 DIST_TEST 的设置使用 Test::Harness 运行测试。
perl-module_src_install: 安装 Perl ebuild。此函数应在 ebuild src_install() 阶段调用。
perl-module_pkg_postinst: 此函数应在 pkg_postinst() 阶段调用。它只对 perl-core 类别执行有用的操作，在该类别中，它处理文件重命名和符号链接，以防止双重生命周期软件包安装脚本时发生文件冲突。在任何其他类别中，它都会立即退出。
perl-module_pkg_postrm: 此函数应在 pkg_postrm() 阶段调用。它只对 perl-core 类别执行有用的操作，在该类别中，它处理文件重命名和符号链接，以防止双重生命周期软件包安装脚本时发生文件冲突。在任何其他类别中，它都会立即退出。

eclass 变量

GENTOO_DEPEND_ON_PERL

此变量控制 eclass 是否自动添加对 dev-lang/perl 的运行时和构建时依赖项。默认值为 yes。设置为 no 以禁用，设置为 noslotop 以添加不带插槽运算符的 perl 依赖项。所有安装到 vendor_perl 路径的软件包都必须在此处使用 yes。（EAPI=8 及更高版本）还添加了测试 useflag，对 virtual/perl-Test-Simple 的 use-conditional 构建时依赖项，以及所需的 RESTRICT 设置。

PERL_USEDEP = "perl_features_debug=,perl_features_ithreads=,perl_features_quadmath=" (由 eclass 生成)

eclass 生成的 USE 依赖项字符串，用于已安装 Perl 的功能。虽然远不像 Python 那样关键，但这应该至少用于依赖于安装已编译（二进制）文件的 Perl 软件包。

示例用法

RDEPEND=dev-perl/DBI[${PERL_USEDEP}]

示例值

perl_features_debug=,perl_features_ithreads=,perl_features_quadmath=

DIST_NAME

此变量提供了一种方法来覆盖 PN 以计算 S、SRC_URI 和 HOMEPAGE。如果未设置，则默认为 PN。

DIST_VERSION

此变量提供了一种方法来覆盖 PV 以计算 S 和 SRC_URI。使用它来提供未规范化的上游版本号。如果未设置，则默认为 PV。

DIST_A_EXT

此变量提供了一种方法来覆盖用于计算 SRC_URI 的发行版文件扩展名。如果未设置，则默认为 tar.gz。

DIST_A

此变量提供了一种方法来覆盖用于计算 SRC_URI 的发行版文件名。如果未设置，则默认为 ${DIST_NAME}-${DIST_VERSION}.${DIST_A_EXT}。

DIST_AUTHOR

此变量为计算 SRC_URI 设置模块作者名称。

DIST_SECTION

此变量为计算 SRC_URI 设置模块节。仅在罕见的情况下，对于非常特殊的用例才需要它。

DIST_EXAMPLES (在 inherit 之前设置)

此 Bash 数组允许传递示例文件列表，这些文件将安装在 /usr/share/doc/${PF}/examples 中。如果在 inherit 之前设置，则会自动添加 use-flag examples，否则您必须在 ebuild 中添加 useflag。仅当 useflag examples 存在且已激活时，才会安装示例。

DIST_WIKI

(EAPI=8 及更高版本) 此变量可以设置为包含与维护说明 Wiki 文章中的文章节相对应的空格分隔关键字。如果设置了关键字，ebuild 阶段可以输出一条消息和一个指向 Wiki 的链接。截至 EAPI=8 的当前关键字是：* 特性：关于可选特性的附加依赖项说明 * 测试：关于测试所需的附加依赖项和准备说明

DIST_MAKE = "* ]]; then

(EAPI=8 及更高版本) 此 Bash 数组包含从 ExtUtils::MakeMaker 调用 make 的参数。替换 EAPI=7 及更早版本中的 mymake。默认为 ( OPTIMIZE="${CFLAGS}" )

DIST_TEST

变量控制测试阶段是否完全运行测试，以及如果运行，则在什么条件下运行。如果未设置，则默认为 "do parallel" 如果既不识别 "do" 也不识别 "parallel"，则会跳过测试。以下空格分隔的关键字将被识别
  do       : 运行测试
  parallel : 并行运行测试
  verbose  : 提高测试详细程度
  network  : 不要尝试禁用网络测试

DIST_TEST_OVERRIDE (用户变量)

变量控制测试阶段是否完全运行测试，以及如果运行，则在什么条件下运行。它旨在供 ebuild 作者在测试期间在 make.conf 或环境中使用，并接受与 DIST_TEST 相同的值。如果设置，它会完全覆盖 DIST_TEST。请不要在 ebuild 中使用它！

作者

Seemant Kulleen <[email protected]>
Andreas K. Hüttel <[email protected]>

维护者

[email protected]

报告 Bug

请通过 https://bugs.gentoo.org/ 报告 Bug

文件

perl-module.eclass

另请参见

ebuild(5)
https://gitweb.gentoo.org/repo/gentoo.git/log/eclass/perl-module.eclass

本文件由 man2html 使用手册页创建。
时间：2024 年 11 月 12 日格林尼治标准时间 03:27:01