我在哪里可以找到cpanfile格式定义？

Question

我们考虑使用Minilla或Dist :: Milla进行perl开发.声明依赖关系是通过cpanfile完成的.我期望找到一个确切的定义,以及如何宣布.但

• perldoc cpanfile:仅显示主要用法."另请参见"部分没有帮助.

• perldoc Module :: CPANfile:与cpanfile相同.

• perldoc cpanfile-faq:仅解释确切的语法或链接

熟悉的DSL语法

这是一种新的文件类型,但格式和语法并不是全新的.它可以声明的元数据恰好是CPAN Meta Spec中"Prereqs"的子集.

语法从Module :: Install中借鉴了很多.Module :: Install是一种轻松声明模块元数据(如名称,作者和依赖项)的好方法.cpanfile格式只是将依赖项提取到一个单独的文件中,这意味着大多数开发人员都熟悉语法.

• 网:我找到了(但没有回答我的问题)
  • https://speakerdeck.com/miyagawa/cpanfile
  • http://weblog.bulknews.net/post/44963580392/what-is-cpanfile-and-why-do-i-want-to-use-it
  • http://blogs.perl.org/users/lestrrat/2013/03/the-main-problem-with-cpan-modules-on-github.html

有谁知道在哪里可以找到cpanfile语法/格式的确切描述？

Answer 1

我安装Module::CPANFile和perldoc cpanfile并perldoc cpanfile-faq 可用.

国家的POD cpanfile:

[the] cpanfile specification (this document) is based on Ruby's
Gemfile http://gembundler.com/man/gemfile.5.html specification.

cpanfile手册页中的链接已断开.它应该指向:http://bundler.io/v1.3/man/gemfile.5.html

cpanfile旨在与Module::InstallDSL语法"向后兼容",并"可转换为CPAN :: Meta :: Prereqs"并受到启发CPAN::Meta Spec v.2等.

据我所知,它cpanfile有点像"元格式",适用于一系列TIMTOWTDI方法(参见miyagawa的博客描述cpanfile),兼容Module::Install并且主要是自我记录.例如,如果您mymeta-cpanfile在包含META文件的目录中运行,它将cpanfile为您构建一个; 你可以编写一个描述先决条件的脚本,CPAN::Meta::Prereqs然后$file->save('cpanfile');编写一个cpanfile.

至于Dist::Milla教程(见POD附带Dist::Milla),miyagawa指出"如果你决定手动构建[a] new cpanfile,那么格式大多与Module::InstallDSL的要求兼容 ".本教程还给出了一个简短的例子.

我认为要求miyagawa澄清分发文档中cpanfile规范/格式的状态和用例是公平的.那个和更多的例子会回答像你这样的问题.他已经大部分时间完成了这方面的工作 - 它不仅仅在一个地方完成.