如何将 Perl 模块发布到 CPAN？

Question

我需要创建一个 CPAN 模块，但我不知道从哪里开始或如何做。我已经用 Perl 编写了我的模块，但我不知道如何继续。有人可以帮忙吗？

Answer 1

在开始之前，您需要做两件主要的事情。

首先，您需要创建一个PAUSE 帐户。PAUSE 是维护进入 CPAN 的服务。它有点过时了，但从这里开始并通读它。归结为选择名称、创建帐户并等待批准。

接下来，您必须决定如何打包您的模块。您可以从各种工具中进行选择，也可以自己构建发行版。

• perlnewmod对此进行了一些解释，并建议Module::Starter，这是一个非常简单的工具。
• Dist::Zilla是一个非常大的发行版构建器，有很多插件可以为你创建文档和运行各种测试，自动列出谁通过你的 git 为你的代码做出了贡献，以及许多其他事情。中间还有一些工具。
• 我经常使用Minilla，它制作一个新的模块脚手架，运行你的测试，创建一个 dist 并将它上传到 CPAN，但没有别的。

您可能还想阅读有关我链接的每个部分的另见部分。他们互相指指点点。玩一玩，然后选择与您交谈的那个。

然后您必须为您的发行版选择一个名称。在我上面链接的 PAUSE 页面中有一些关于此的指导。

确保包含有用的文档、编写测试并将代码放在 github 上。将其放入元数据文件中。

最后，您将其打包，然后将其上传到 PAUSE。捆绑包是具有特定名称的 tarbal。您可以手动或使用上述工具之一进行创建。

上传可以通过网站手动完成，使用像cpan-upload这样的命令行工具，或者使用打包器（如果它包含该功能）。过了一会儿，你会收到一封来自 PAUSE 的电子邮件，告诉你它在那里等待索引（CPAN Upload: ...），然后它显示在metacpan.org 上。您会从 PAUSE 收到另一封电子邮件（PAUSE Indexer report ...），告诉您何时准备就绪。

再过一段时间，您可能会收到来自CPAN 测试人员的电子邮件，他们会针对多种平台对所有新上传的内容进行冒烟测试。有时东西坏了，你会听到它。这就是为什么进行良好的测试很重要。

以下是一些额外的资源：

• 一个关于滚动你自己的 dist 及其目录结构的老问题
• 使用 Minilla 的分步教程
• 当你上传到 CPAN 时会发生什么？