CLI

Command Line Interface

License	MIT License
Categories	CLI User Interface
GroupId	org.testinfected
ArtifactId	cli
Last Version	1.0
Release Date	Aug 5, 2012
Type	jar
Description	CLI Command Line Interface
Project URL	https://github.com/testinfected/cli
Source Code Management	https://github.com/testinfected/cli

Download cli

Filename	Size
cli-1.0.pom
cli-1.0.jar	26 KB
cli-1.0-sources.jar	19 KB
cli-1.0-javadoc.jar	163 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.testinfected/cli/ -->
<dependency>
    <groupId>org.testinfected</groupId>
    <artifactId>cli</artifactId>
    <version>1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.testinfected/cli/
implementation 'org.testinfected:cli:1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.testinfected/cli/
implementation ("org.testinfected:cli:1.0")

Apache Buildr

'org.testinfected:cli:jar:1.0'

Apache Ivy

<dependency org="org.testinfected" name="cli" rev="1.0">
  <artifact name="cli" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.testinfected', module='cli', version='1.0')
)

Scala SBT

libraryDependencies += "org.testinfected" % "cli" % "1.0"

Leiningen

[org.testinfected/cli "1.0"]

Dependencies

test (4)

Group / Artifact	Type	Version
junit : junit-dep	jar	4.10
org.hamcrest : hamcrest-all	jar	1.3
org.jmock : jmock	jar	2.5.1
org.jmock : jmock-junit4	jar	2.5.1

Project Modules

There are no modules declared in this project.

Getting Started

Build yourself (for latest version) using Gradle or Maven, or simply download from Maven Central:

<dependency>
      <groupId>com.vtence.cli</groupId>
      <artifactId>cli</artifactId>
      <version>1.1</version>
</dependency>

First let's define a command line:

CLI cli = new CLI() {{
    name("petstore"); version("1.0");
    description("A web application built without frameworks");

    option("-e", "--environment ENV", "Environment to use for configuration (default: development)").defaultingTo("development");
    option("-h", "--host HOST", "Host address to bind to (default: 0.0.0.0)").defaultingTo("0.0.0.0");
    option("-p", "--port PORT", "Port to listen on (default: 8080)").ofType(int.class).defaultingTo(8080);
    option("--timeout SECONDS", "Session timeout in seconds (default: 15 min)").ofType(int.class).defaultingTo(900);
    flag("-q", "--quiet", "Operate quietly");
    flag("-h", "--help", "Print this help message");

    operand("webroot", "Location of the web application").ofType(File.class);
    
    epilog("use --help to show this help message");
}};

Now assuming program is started with:

-p 8088 -e production --timeout 9000 /path/to/webapp/root

Here's how we would parse the arguments:

cli.parse(args); // Typical program args

String env = cli.get("-e");
String host = cli.get("-h");
int port = cli.get("-p");
int timeout = cli.get("--timeout");
boolean quiet = cli.has("-q");

File webroot = cli.get("webroot");

Want to know more?

Checkout out usage examples

Versions

Version
1.0 Aug 5, 2012