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 --no-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: enabled)
-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. This will only add a # TRIAL comment to the version assignment, as the -TRIAL indication is not part of the version and should be added to the name of the archive you upload to PAUSE, which is outside of the scope of this tool.
-u, --allow-underscore
Allow decimal versions with underscores. Enabled by default, use --no-allow-underscore to disable. 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)