perl-bump-version - A tool to bump your Perl module versions
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)
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.
lib
script
bin
V
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 = '...';.
v
our $VERSION = '...';
See the script perl-rewrite-version to update all modules to a specific version.
Distribution directory to operate on, defaults to current working directory.
Run as normal but don't actually update any files. Useful with --verbose to verify expected functionality.
--verbose
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.
Update all instances of version assignment, instead of just the first occurrence in each file.
Follow directory symlinks when traversing the distribution for perl files to rewrite.
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.
# TRIAL
-TRIAL
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.
--no-allow-underscore
Print progress output to STDOUT.
Report any issues on the public bugtracker.
Dan Book <dbook@cpan.org>
This software is Copyright (c) 2015 by Dan Book.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
Dist::Zilla::Plugin::RewriteVersion, Version::Next
To install App::RewriteVersion, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::RewriteVersion
CPAN shell
perl -MCPAN -e shell install App::RewriteVersion
For more information on module installation, please visit the detailed CPAN module installation guide.