Dist::Zilla::Plugin::TrialVersionComment - Add a "# TRIAL" comment after your version declaration in trial releases
version 0.007
In your dist.ini:
[TrialVersionComment]
This is a Dist::Zilla plugin that munges your .pm files to add a # TRIAL comment after $VERSION assignments, if the release is --trial.
# TRIAL
$VERSION
--trial
If the distribution is not a --trial release (i.e. release_status in metadata is stable), this plugin does nothing.
release_status
stable
Other plugins that munge versions into files also add the # TRIAL comment (such as [PkgVersion], [OurPkgVersion], and [RewriteVersion], so you would generally only need this plugin if you added the version yourself, manually.
Nothing currently parses these comments, but the idea is that things like Module::Metadata might make use of this in the future.
This is a rather silly plugin, and doesn't really add any value. I suppose if you are adding $VERSION statements with [PkgVersion] it could be useful, but in that case I think I'd rather patch [PkgVersion] to add the comment as well, rather than going to all the effort of re-parsing the perl document again. I only really wrote this as an exercise in using PPI, to help diagnose some issues I was seeing with Acme::LookOfDisapproval and utf8-encoded perl code.
[PkgVersion]
Inspiration for this module came about through multiple toolchain conversations with David Golden (xdg).
[OurPkgVersion]
[BumpVersionAfterRelease]
[OverridePkgVersion]
[SurgicalPkgVersion]
[PkgVersionIfModuleWithPod]
Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-TrialVersionComment@rt.cpan.org).
There is also a mailing list available for users of this distribution, at http://dzil.org/#mailing-list.
There is also an irc channel available for users of this distribution, at #distzilla on irc.perl.org.
#distzilla
irc.perl.org
I am also usually active on irc, as 'ether' at irc.perl.org.
Karen Etheridge <ether@cpan.org>
David Golden <dagolden@cpan.org>
This software is copyright (c) 2014 by Karen Etheridge.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Dist::Zilla::Plugin::TrialVersionComment, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::TrialVersionComment
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::TrialVersionComment
For more information on module installation, please visit the detailed CPAN module installation guide.