I am writing command line application in Java and I\'ve chosen Apache Commons CLI to parse input arguments.
Let\'s say I have two required options (
There is a fluent wrapper for the commons-cli library: https://github.com/bogdanovmn/java-cmdline-app
The help option is built-in. Also there are a few convenient features. For example, if you must to specify one of two options:
new CmdLineAppBuilder(args)
// Optional argument
.withArg("input", "input description")
.withArg("output", "output description")
// "input" or "output" must be specified
.withAtLeastOneRequiredOption("input", "output")
.withEntryPoint(
cmdLine -> {
...
}
).build().run();
In this situation you have to define two sets of options and parse the command line twice. The first set of options contains the options that precede the required group (typically --help
and --version
), and the second set contains all the options.
You start by parsing the first set of options, and if no match is found, you go on with the second set.
Here is an example:
Options options1 = new Options();
options1.add(OptionsBuilder.withLongOpt("help").create("h"));
options1.add(OptionsBuilder.withLongOpt("version").create());
// this parses the command line but doesn't throw an exception on unknown options
CommandLine cl = new DefaultParser().parse(options1, args, true);
if (!cl.getOptions().isEmpty()) {
// print the help or the version there.
} else {
OptionGroup group = new OptionGroup();
group.add(OptionsBuilder.withLongOpt("input").hasArg().create("i"));
group.add(OptionsBuilder.withLongOpt("output").hasArg().create("o"));
group.setRequired(true);
Options options2 = new Options();
options2.addOptionGroup(group);
// add more options there.
try {
cl = new DefaultParser().parse(options2, args);
// do something useful here.
} catch (ParseException e) {
// print a meaningful error message here.
}
}