/ 
Dist-Zilla-4.300005
River stage three • 670 direct dependents • 727 total dependents
/ Dist::Zilla::Plugin::NextRelease

NAME

Dist::Zilla::Plugin::NextRelease - update the next release number in your changelog

VERSION

version 4.300005

SYNOPSIS

In your dist.ini:

[NextRelease]

In your Changes file:

{{$NEXT}}

DESCRIPTION

Tired of having to update your Changes file by hand with the new version and release date / time each time you release your distribution? Well, this plugin is for you.

Add this plugin to your dist.ini, and the following to your Changes file:

{{$NEXT}}

The NextRelease plugin will then do 2 things:

  • At build time, this special marker will be replaced with the version and the build date, to form a standard changelog header. This will be done to the in-memory file - the original Changes file won't be updated.

  • After release (when running dzil release), since the version and build date are now part of your dist's history, the real Changes file (not the in-memory one) will be updated with this piece of information.

The module accepts the following options in its dist.ini section:

filename

the name of your changelog file; defaults to Changes

update_filename

the file to which to write an updated changelog to; defaults to the filename

format

sprintf-like string used to compute the next value of {{$NEXT}}; defaults to %-9v %{yyyy-MM-dd HH:mm:ss VVVV}d

time_zone

the timezone to use when generating the date; defaults to local

The module allows the following sprintf-like format codes in the format:

  • v - the version of the dist

  • d - the CLDR format for DateTime

  • n - a newline

  • t - a tab

AUTHOR

Ricardo SIGNES <rjbs@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.