Scroll to navigation

Dist::Zilla::Plugin::Git::NextVersion(3pm) User Contributed Perl Documentation Dist::Zilla::Plugin::Git::NextVersion(3pm)

NAME

Dist::Zilla::Plugin::Git::NextVersion - provide a version number by bumping the last git release tag

VERSION

version 1.121820

SYNOPSIS

In your dist.ini: 
    [Git::NextVersion]
    first_version = 0.001       ; this is the default
    version_regexp  = ^v(.+)$   ; this is the default

DESCRIPTION

This does the Dist::Zilla::Role::VersionProvider role. It finds the last version number from your git tags, increments it using Version::Next, and uses the result as the "version" parameter for your distribution.
The plugin accepts the following options:
•
"first_version" - if the repository has no tags at all, this version is used as the first version for the distribution. It defaults to "0.001".
•
"version_regexp" - regular expression that matches a tag containing a version. It must capture the version into $1. Defaults to ^v(.+)$ which matches the default "tag_format" from Dist::Zilla::Plugin::Git::Tag. If you change "tag_format", you must set a corresponsing "version_regexp".
You can also set the "V" environment variable to override the new version. This is useful if you need to bump to a specific version. For example, if the last tag is 0.005 and you want to jump to 1.000 you can set V = 1.000. 
  $ V=1.000 dzil release

AUTHOR

Jerome Quelin

COPYRIGHT AND LICENSE

This software is copyright (c) 2009 by Jerome Quelin.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
2012-06-30 perl v5.14.2