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

NAME

Dist::Zilla::Plugin::VersionFromScript - run command line script to provide version number

VERSION

version 0.017

DESCRIPTION

This plugin performs the Dist::Zilla::Role::VersionProvider role. It runs a user-provided shell script and uses the output as Dist::Zilla's version.

This module installs a couple of small perl scripts by way of example.

svnversion.pl gets the current Subversion version of your project and adjusts it to be a useful version number. To use it, add this to your dist.ini file:

    [VersionFromScript]
    script = svnversion.pl

git-logs2version.pl counts the number of git log entries (commits) to find the version number. This versioning scheme can work in certain limited workflows. Add this to dist.ini:

    [VersionFromScript]
    script = git-logs2version.pl

Both svnversion.pl and git-logs2version.pl can take arguments of:

    --major  number   # add a major revision number
    --offset number   # add offset to the minor revision

So for example, if you are at revision 50, calling

    [VersionFromScript]
    script = svnversion.pl --major 3 --offset 22

produces 3.072 as the version number.

AUTHOR

Reid Augustin <reid@hellosix.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Reid Augustin.

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