NAME
perl-rewrite-version - A tool to rewrite your Perl module versions
SYNOPSIS
perl-rewrite-version [options] [subdir ...]
perl-rewrite-version --from lib/Foo/Bar.pm
perl-rewrite-version --trial --allow-underscore -V 3.30_3 lib script
perl-rewrite-version -LdvgD /opt/projects/Foo-Bar/
V=v1.0.0 perl-rewrite-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, --set-version <version> set version manually instead of from file
-v, --verbose print progress messages to STDOUT (default: disabled)DESCRIPTION
perl-rewrite-version is a command-line tool using App::RewriteVersion to update Perl module versions in a distribution. The main module's version is read, 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, and the -V option overrides the version to rewrite regardless of the current version.
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-bump-version for automatic incrementing of the version across your distribution.
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 or the -V option 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, --set-version <version>
Override the version to use for rewriting, ignoring any existing versions and the V environment variable.
-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)