PomStrap command-line utility

The pom command-line utility is a native executable under Microsoft Windows and it can be defined as an alias under Unix operating system flavours.

Windows installation

You can download from here the latest stable release of the utility pom.

The jar contains the Windows native executable pom.exe. Extract the executable to a directory on the execution path with any utility capable of extracting ZIP archives.

Try to run

$ pom --version
org.tigris.pomstrap.cli 2.X-SNAPSHOT (built at 2009-05-12 10:37:51)

Unix installation

Download the latest stable version of the cli jar.

Defined an alias for the name pom as follows

alias pom="java -jar org.tigris.pomstrap.cli-2.X-SNAPSHOT.jar"

Try to run

$ pom --version
org.tigris.pomstrap.cli 2.X-SNAPSHOT (built at 2009-05-12 10:37:51)

Usage

The first argument to the pom utility is a Maven dependency reference in the format GROUPID:ARTIFACTID:VERSION The --help option displays the usage information.

$ pom --help
Usage: org.tigris.pomstrap.cli [OPTION]...
       groupId:artifactId[:type[:classifier]]:version

Executes a java application deployed to a maven repository.

 -d,--dependencyTransformer <LIST>   class file transformers list
 -e,--exclude <LIST>                 exclude dependency list
 -g,--group <CUSTOMGROUPS>           comma seperated list of space
                                     separated artifact families to group in the same class loader
 -h,--help                           display this help and exit
 -l,--localRepository <PATH>         local repository path
 -p,--password <PASSWORD>            repository password
 -r,--repository <URL>               remote repository URL
 -s,--singleton <LIST>               singleton dependency list
 -t,--classFileTransformer <LIST>    class file transformers list
 -u,--username <USERNAME>            repository username
 -v,--verbose                        print verbose messages
 -V,--version                        output version information and exit

If no remote repository URL is given, the local repository is used.

Argument to long options are separated by an equal sign '=', e.g.
'--output=/tmp/out.txt'. Arguments to short options are separated by
whitespace, e.g '-o /tmp/out.txt'.

Report bugs to <http://pomstrap.tigris.org/servlets/ProjectIssues>.

Repository configuration

The source artifact repository url can be specified either within the user's pomstrap configuration file or directly on the command line via the --repository option.

If no repository is configured, PomStrap will use the local repository.

The default local repository path is $HOME/.m2/repository.

An alternative local repository path can be specified via the --localRepository option or within the the user's pomstrap configuration file.

Application aliasing

To shorten application references, aliases to fully qualified Maven dependencies can be defined in the user's pomstrap configuration file located at $HOME/pomstrap.properties.

alias.hello-world.dependency=org.tigris.pomstrap:org.tigris.pomstrap.example.first:2.X-SNAPSHOT

The same application can now be accessed by using the shorter moniker hello-world:

# pom hello-world
Hello world!

If the application accepts command line arguments, they can be passed after the explicit or indirect - by using an alias - dependency reference.