Cli4J

A CLI command framework for Java. Heavily inspired by Click and JAX-RS. Based on parsing from JCommander and console interaction from JLine.

The goal is to make it simple and easy for Java developers to write multi-command style shell tools.

I'll also note that the style and content of this file borrows heavily from Click -- at least for now.

Provides

• annotation based command definition, similar to JAX-RS
• annotation based option/argument parsing vi JCommander
• automatic help page generation
• arbitrarily deep nesting of commands
• lazy instantiation of command backing classes to reduce startup time

Simple?

Here's an example of what a command would look like (note that this is currently, not our end goal):

public class HelloCommand {
  public static class HelloArgs {
    @Parameter(names = "--count", description = "Number of greetings.")
    private int count = 1;

    @Parameter(names = "--name", required = true, description = "The person to greet.")
    private String name;
  }

  @Command(name = "hello")
  public void hello(final CliAdapter cliAdapter, final HelloArgs args) {
    for (int i = 0; i < args.count; i++) {
      cliAdapter.printf("Hello %s!%n", args.name);
    }
  }

  public static void main(final String ... args) {
    Cli4J cli = new Cli4J();
    cli.addResource(HelloCommand.class);

    cli.execute(args);
  }
}