NAME

perl-bump-version - A tool to bump your Perl module versions

SYNOPSIS

 perl-bump-version [options] [subdir ...]
 
   perl-bump-version --from lib/Foo/Bar.pm
   perl-bump-version --trial --allow-underscore lib script
   perl-bump-version -LdgvD /opt/projects/Foo-Bar/
   V=v1.0.0 perl-bump-version

 Options:
   -D, --dist-dir <dir>         distribution directory to operate on (default: current directory)
   -d, --dry-run                don't actually update files (default: disabled)
   -f, --from <file>            file to read version from
   -g, --global                 rewrite versions globally instead of just the first per file (default: disabled)
   -L, --follow-symlinks        follow symlinks when finding perl files to rewrite (default: disabled)
   -t, --trial                  mark version as a trial version (default: disabled)
   -u, --allow-underscore       allow decimal versions with underscores (default: disabled)
   -v, --verbose                print progress messages to STDOUT (default: disabled)

DESCRIPTION

perl-bump-version is a command-line tool using App::RewriteVersion to bump Perl module versions in a distribution. The main module's version is read, bumped (using Version::Next), and then used to update the version in all perl files in the distribution with a version assignment. The subdirectories (relative to the distribution directory) to update versions in can be specified as arguments, defaulting to lib, script, and bin if no subdirectories are specified. The V environment variable can be used to set the "current" version instead of retrieving it from a module, this version will then be incremented for rewriting.

Existing version assignments and new versions must be parseable with the same rules as in "DESCRIPTION" in Dist::Zilla::Plugin::RewriteVersion, that is to say, they should either be a decimal number with a single decimal point, or a tuple version with a leading v and at least 3 segments separated by decimal points. Version assignments should be in the form our $VERSION = '...';.

See the script perl-rewrite-version to update all modules to a specific version.

OPTIONS

-D, --dist-dir <dir>

Distribution directory to operate on, defaults to current working directory.

-d, --dry-run

Run as normal but don't actually update any files. Useful with --verbose to verify expected functionality.

-f, --from <file>

File to read main version from. If unspecified, the main module of the distribution will be guessed in order to determine its version, see "current_version" in App::RewriteVersion. Ignored if the V environment variable is set.

-g, --global

Update all instances of version assignment, instead of just the first occurrence in each file.

-L, --follow-symlinks

Follow directory symlinks when traversing the distribution for perl files to rewrite.

-t, --trial

Mark version assignment as a trial release.

-u, --allow-underscore

Allow decimal versions with underscores. See "Using underscore in decimal $VERSION" in Dist::Zilla::Plugin::BumpVersionAfterRelease for more information.

-v, --verbose

Print progress output to STDOUT.

BUGS

Report any issues on the public bugtracker.

AUTHOR

Dan Book <dbook@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2015 by Dan Book.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

SEE ALSO

Dist::Zilla::Plugin::RewriteVersion, Version::Next

cpanm App::RewriteVersion

perl -MCPAN -e shell
install App::RewriteVersion