The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.