如何向CPAN发布Perl模块



我需要创建一个CPAN模块,但我不知道从哪里开始,也不知道如何创建。我已经用Perl编写了我的模块,但我不知道如何继续。有人能帮忙吗?

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

首先,您需要创建一个PAUSE帐户。PAUSE是维护CPAN内容的服务。它有点过时,但从这里开始,通读一遍。它可以归结为选择一个名字,创建一个帐户,然后等待批准。

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

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

您可能还想阅读我链接的每一个的"另见"部分。他们互相指向对方。玩一玩,选一个能和你说话的。

然后您必须为您的分发选择一个名称。在我上面链接的暂停页面中有一些关于这方面的指导。

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

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

上传可以通过网站手动完成,使用cpan上传等命令行工具,或者使用bundler(如果它包含该功能(。过了一段时间,你会收到一封来自PAUSE的电子邮件,告诉它在那里,正在等待索引(CPAN Upload:…(,然后它会显示在metacpan.org上。你会收到另一封来自PAUSE的邮件(

PAUSE Indexer report…再过一段时间,你可能会收到来自CPAN测试人员的电子邮件,他们会在众多平台上测试所有新上传的内容。有时候东西坏了,你会听到的。这就是为什么有好的测试很重要。

以下是一些额外的资源:

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

最新更新