使用Perl5进行编程,使用Dist::Zilla
(dzil
)进行部署到CPAN时,出现了问题。但是这个问题可能是一个普遍的问题,其含义与编程语言无关。
问题描述
假设我要发布模块0.1
的新版本Foo
,并具有名为bar
的新功能。我想将其作为试用版(dzil build --trial
)发布,以便能够获得有关更改的反馈,而不必将其强加给无意识的用户。使用工具链进行操作时,Changes
文件将如下所示:
1 Revision history for Foo
2
3 0.1 2019-06-19 17:49:09+02:00 Continent/City (TRIAL RELEASE)
4 - added bar
打包分发文件(用于上传到CPAN)是这样的文件:Foo-0.1-TRIAL.tar.gz
直到这里,一切都很容易。但是从现在开始,我不确定如何应对即将发生的事件:
新版本(但未更改)的外观应如何?
我应该发布具有相同版本的版本还是增加版本?我应该在Changes
文件中添加新行(例如“将试用版0.1投入生产”)还是更改现有行(意味着只删除(TRIAL RELEASE)
)。
baz
。这里有同样的问题。当然,新的更改需要在Changes
中提及。但是再说一遍:算上版本,还是顺其自然?在Changes
中输入新条目还是更改现有条目?
这是我感觉到的以下问题之一:可能无关紧要,但是必须有“最佳实践”。从长远来看,做对是有回报的。
问题
在专门针对CPAN进行试用发布后,如何继续版本编号和Changes
文件?
(与Perl和CPAN无关的一般答案也很有趣)
答案 0 :(得分:1)
我的一般建议是:如果TRIAL证明是一次巨大的成功,并且在没有--trial
的情况下发布相同内容,则除了零更改之外,您可以重用该版本,因为在运行时,两个tarball会有相同的行为。如果必须进行可能影响用户或测试的任何更改,请更改版本。如果不确定,请更改版本-版本是免费的。请记住,如果没有不同的版本,其他发行版将无法区分其依赖项的更改,CPAN客户端也无法轻松地请求特定版本,等等。
就变更日志而言,如果it can parse your changelog和试用版均已标明,则MetaCPAN现在可在其变更预览中包括所有导致稳定版的试用版的变更。 (example)因此,我只为每个不同的版本添加一个条目。