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
.
If the distribution is not a --trial
release (i.e. release_status
in metadata is stable
), this plugin does nothing.
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.
Inspiration for this module came about through multiple toolchain conversations with David Golden (xdg).
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
.
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.