Ricardo SIGNES > Dist-Zilla-5.006 > Dist::Zilla::Plugin::NextRelease

Download:
Dist-Zilla-5.006.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 5.006   Source   Latest Release: Dist-Zilla-5.015

NAME ^

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

VERSION ^

version 5.006

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:

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

user_stash

the name of the stash where the user's name and email address can be found; defaults to %User

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

%v

The distribution version

%{-TRIAL}T

Expands to -TRIAL (or any other supplied string) if this is a trial release, or the empty string if not. A bare %T means %{-TRIAL}T.

%{-TRIAL}V

Equivalent to %v%{-TRIAL}T, to allow for the application of modifiers such as space padding to the entire version string produced.

%{CLDR format}d

The date of the release. You can use any CLDR format supported by DateTime. You must specify the format; there is no default.

%U

The name of the user making this release (from user_stash).

%E

The email address of the user making this release (from user_stash).

%n

A newline

%t

A tab

SEE ALSO ^

Core Dist::Zilla plugins: AutoVersion, PkgVersion, PodVersion.

Dist::Zilla roles: AfterRelease, FileMunger, TextTemplate.

AUTHOR ^

Ricardo SIGNES <rjbs@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2013 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.

syntax highlighting: