git-pom - Manage pom.xml (or package.json) file versions
This documentation refers to git-pom version 1.1.3
git-pom [uniq] [option] git-pom next [--update|-u] git-pom whos version [option] SUB-COMMAND: uniq Confirm that the current branch is the only branch using its version next Calculates the next available version number whos Which branch uses the pom version "version" OPTIONS: -P --pom[=]file Specify the pom file location (Default pom.xml) -u --update Update to next version (used with next) -t --tag[=]str Specify a tag that any branch with newer commits must contain -b --branch[=]str Similarly a branch that other branches with newer commits must contain (Default origin/master) -l --local Shorthand for --branch '^master$' -v --verbose Show more detailed option --version Prints the version information --help Prints this help information --man Prints the full documentation for git-pom
The git-pom tool helps working with Maven POM files by looking at all branches to see what versions are set. The sub commands allow different kinds of checking to be done.
git-pom
Check that the current branch's POM version is unique across all branches.
Finds the next available POM version number buy finding the current nighest POM version and incrementing the second number. If --update is used then the POM version is updated to that number.
--update
Find which branch or branches use a POM version number.
run ()
Executes the git workflow command
do_whos ()
do_next ()
do_uniq ()
do_bad_branches ($pom)
Show branches with pom.xml files that don't pass
Defaults for this script can be set through git config
git config
workflow.prod Sets how a prod release is determined eg the default equivalent is branch=^origin/master$ workflow.pom The default location for the pom.xml file (used by C<--new-pom> when updating pom.xml for the new branch)
You can set these values either by editing the repository local .git/config file or ~/.gitconfig or use the git config command
.git/config
~/.gitconfig
# eg Setting the global value git config --global workflow.prod 'branch=^origin/master$' # or set a repository's local value git config workflow.prod 'tag=^release_\d{4}_\d{2}\d{2}$' # or set pom.xml location to a sub directory git config workflow.pom 'somedir/pom.xml'
There are no known bugs in this module.
Please report problems to Ivan Wills (ivan.wills@gmail.com).
Patches are welcome.
Ivan Wills - (ivan.wills@gmail.com)
Copyright (c) 2014 Ivan Wills (14 Mullion Close, Hornsby Heights, NSW Australia 2077). All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
To install App::Git::Workflow, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::Git::Workflow
CPAN shell
perl -MCPAN -e shell install App::Git::Workflow
For more information on module installation, please visit the detailed CPAN module installation guide.