Apache Commons CLI

The Apache Commons CLI library provides an API for parsing command-line options passed to an application. It can also print help detailing the options available for that application.

Commons CLI supports different types of options:

• POSIX like options, for exampletar -zxvf foo.tar.gz
• GNU like long options, for exampledu --human-readable --max-depth=1
• Java like properties, for examplejava -Djava.awt.headless=true -Djava.net.useSystemProxies=true Foo
• Short options with value attached, for examplegcc -O2 foo.c
• long options with single hyphen, for exampleant -projecthelp

A typical help message displayed by Commons CLI looks like this:

usage: ls -A,--almost-all          do not list implied . and .. -a,--all                 do not hide entries starting with . -B,--ignore-backups      do not list implied entried ending with ~ -b,--escape              print octal escapes for nongraphic characters    --block-size <SIZE>   use SIZE-byte blocks -c                       with -lt: sort by, and show, ctime (time of last                          modification of file status information) with                          -l:show ctime and sort by name otherwise: sort                          by ctime -C                       list entries by columns

Check out theintroduction page for a detailed presentation.

Documentation

A fullUser's Guide is available as are variousproject reports.

The Javadoc API documents are available online:

• Javadoc latest
• Javadoc archives

Thesource repository can bebrowsed.

Releases

Download the latest version.
Therelease notes are also available.

For previous releases, see theApache Archive.

Support

Thecommons mailing lists act as the main support forum. The user list is suitable for most library usage queries. The dev list is intended for the development discussion. Please remember that the lists are shared between all commons components, so prefix your email subject by[cli].

Issues may be reported via theASF JIRA.

CLI 2?

Commons CLI 1.0 was formed from the merger of ideas and code from three different libraries - Werken, Avalon and Optz. In dealing with the bugs and the feature requests a freshly designed and not backwards compatible CLI 2 was created in 2004, but never finished or released.

The current plan is to continue to maintain the 1.x line. The CLI2 work may be found in the Commons Sandbox.