maven-bin

A CLI to install & run executable libraries from Maven repositories, with automagic classpathing of dependencies, and aliases on your global path. Sort of like npm's install --global.

Features

• With a single command, install JARs and execute their main classes.
• Install from any Maven repo, off or on-prem, e.g. Bintray, Artifactory, Archiva, or Nexus, via settings.xml.

Use

Executing

Executing a library will be sure it and all its dependencies are downloaded, then run a class in the JAR, defaulting to its main class.

mvbn org.apache.ant:ant -help

Or the long way:

mvn me.andrz.maven:maven-bin-maven-plugin:exec "-Dartifact=org.apache.ant:ant" "-Darguments=-help"

Non-Main Classes

Non-main classes can be specified with an @... suffix on the artifact coordinates, e.g.:

mvbn org.antlr:antlr4@org.antlr.v4.gui.TestRig

Installing

Installing a library will first download as above, then create an executable script file as a shortcut to execute it.

mvbn -i org.apache.ant:ant

Or the long way:

mvn me.andrz.maven:maven-bin-maven-plugin:install "-Dartifact=org.apache.ant:ant"

Now, you'll have a command for it, e.g.:

ant--org.apache.ant--1.9.6

But you'll probably want to specify aliases.

Aliases

mvbn -i -a ant org.apache.ant:ant

Or the long way:

mvn me.andrz.maven:maven-bin-maven-plugin:install "-Dartifact=org.apache.ant:ant" "-Dalias=ant"

Now, you'll have a command for it:

ant

Classpaths

Get the classpath for an artifact:

mvbn -c org.antlr:antlr4

For example, to use when compiling:

javac -cp "$(mvbn -c org.antlr:antlr4)" MyGrammar*.java

Install

General

To install maven-bin:

1. Install Core

mvn me.andrz.maven:maven-bin-maven-plugin:installSelf

2. Add to PATH

Add ~/.mvbn/bin to your system executable PATH.

Unix (macOS, Linux, etc.)

In your shell startup script (e.g. .profile, .bashrc, .bash_profile, .zshrc), add something like:

MAVEN_BIN="${HOME}/.mvbn/bin"
if [ -d "${MAVEN_BIN}" ]; then
  export PATH="${MAVEN_BIN}:$PATH"
fi

Windows

In your PowerShell profile, add something like:

$env:Path = $env:Path + ";${env:UserProfile}\.mvbn\bin;"

Development

git clone https://github.com/AndersDJohnson/maven-bin.git
cd maven-bin
mvn install

Wishlist

• Aliasing (default group ID and versions)
  • Add aliased command executables to global path
• Auto-complete CLI
  • Maybe via a generic Groovy CliBuilder completion integration for Bash, zsh, PowerShell, etc.?
• Search repos
  • Base on Maven Central Search API? http://search.maven.org/#api

Dev

Set log level for slf4j simple:

Just this package:

org.slf4j.simpleLogger.log.me.andrz.maven.bin=debug

Or default (all packages):

-Dorg.slf4j.simpleLogger.defaultLogLevel=debug

Research

mvn dependency:copy "-Dartifact=org.apache.ant:ant:RELEASE" "-DoutputDirectory=./bin"

mvn dependency:get "-Dartifact=org.apache.ant:ant:RELEASE"

mvn -f "C:\Users\Anders\.m2\repository\com\google\guava\guava\18.0\guava-18.0.pom" org.apache.maven.plugins:maven-dependency-plugin:2.10:build-classpath

mvn org.apache.maven.plugins:maven-dependency-plugin:2.10:build-classpath "-Dmdep.outputFile=foo"

mvn -f .\mvn help:effective-pom

• https://github.com/takari/maven-wrapper
• https://github.com/TimMoore/mojo-executor
• https://maven.apache.org/plugin-testing/
• https://maven.apache.org/plugin-developers/plugin-testing.html
• https://mizdebsk.fedorapeople.org/xmvn/
• https://stackoverflow.com/questions/11799923/programmatically-resolving-maven-dependencies-outside-of-a-plugin-get-reposito
• https://wiki.eclipse.org/Aether/Creating_a_Repository_System_Session (settings.xml)
• http://git.eclipse.org/c/aether/aether-ant.git/tree/src/main/java/org/eclipse/aether/internal/ant/AntRepoSys.java (settings.xml)
• https://stackoverflow.com/questions/10536221/fetching-maven-artifacts-programmatically
• http://aether.jcabi.com/
• https://stackoverflow.com/questions/27818659/loading-mavens-settings-xml-for-jcabi-aether-to-use
• https://github.com/mguymon/naether
• http://git.eclipse.org/c/aether/aether-demo.git/tree/aether-demo-snippets/src/main/java/org/eclipse/aether/examples
• https://issues.jboss.org/browse/FORGE-2184 (A required class was missing while executing: org/eclipse/aether/spi/connector/transport/TransporterFactory)
• https://maven.apache.org/ref/3.0.3/maven-core/apidocs/org/apache/maven/repository/RepositorySystem.html
• https://maven.apache.org/ref/3.2.5/maven-artifact/apidocs/org/apache/maven/artifact/repository/ArtifactRepository.html
• https://maven.apache.org/ref/3.2.5/maven-artifact/apidocs/org/apache/maven/artifact/repository/ArtifactRepository.html#getMirroredRepositories()
• https://maven.apache.org/ref/3.2.5/maven-artifact/apidocs/org/apache/maven/artifact/repository/ArtifactRepository.html#find(org.apache.maven.artifact.Artifact)
• https://maven.apache.org/ref/3.2.5/maven-artifact/apidocs/org/apache/maven/artifact/Artifact.html
• https://stackoverflow.com/questions/4381460/get-mavenproject-from-just-the-pom-xml-pom-parser
• http://sonatype.github.io/sonatype-aether/apidocs/org/sonatype/aether/repository/LocalRepository.html
• https://rolfje.wordpress.com/2013/07/18/non-java-binary-dependencies-in-maven/
• http://mojo.codehaus.org/exec-maven-plugin/index.html
• http://www.petrikainulainen.net/programming/tips-and-tricks/creating-a-runnable-binary-distribution-with-maven-assembly-plugin/
• https://stackoverflow.com/questions/2022032/building-a-runnable-jar-with-maven-2
• https://stackoverflow.com/questions/574594/how-can-i-create-an-executable-jar-with-dependencies-using-maven
• http://mojo.codehaus.org/exec-maven-plugin/
• http://maven.40175.n5.nabble.com/Can-mvn-install-packages-globally-e-g-command-line-tools-like-nutch-td5767828.html
• https://maven.apache.org/guides/mini/guide-using-one-source-directory.html
• http://blog.sonatype.com/2010/01/how-to-create-two-jars-from-one-project-and-why-you-shouldnt/
• https://github.com/cstamas/maven-indexer-examples
• https://stackoverflow.com/questions/2063378/how-can-i-get-the-list-of-artifacts-from-my-maven-repository
• https://github.com/kumarshantanu/lein-localrepo
• https://maven.apache.org/guides/plugin/guide-java-plugin-development.html
• http://books.sonatype.com/mvnref-book/reference/writing-plugins-sect-custom-plugin.html
• http://docs.codehaus.org/display/MAVENUSER/Mojo+Developer+Cookbook
• http://blog.sonatype.com/2011/01/how-to-use-aether-in-maven-plugins/