0.11 -- 17 Nov 2023

Use the same separator (,, not /) for tool options as for command options.

Added net.lewisship.cli-tools.job-status namespace, which provides dynamic feedback for multiple long-running jobs.

Closed Issues

0.10 -- 20 Sep 2023

Added new function select-option, used to build the option spec for an option selected from a list of possible values.

Improved the output of command mismatches (where the input is not sufficient to uniquely identify a command), and removed the fuzzy match ("did you mean?") that did not seem to provide any real benefit.

Tools that make use of dispatch now add two new leading switches:

• -C, --color: enables ANSI colors, even if otherwise disabled
• -N, --no-color: disables ANSI colors, even if otherwise enabled

Like -h, --help, these must precede any command names.

See org.clj-commons/pretty for details on when ANSI is enabled or disabled normally.

Closed Issues

0.9 -- 11 Sep 2023

Testing was simplified; command functions can be tested by passing them a single map of option and argument values (previously the values map was nested in another map).

Namespaces now represent categories of related commands; this changes the output from the help command. Further, categories may also be command groups, which applies a prefix to all commands within the category (this is useful with tools that define large numbers of subcommands).

Closed Issues

0.8 -- 5 Jul 2023

Switched from io.aviso/pretty to org.clj-commons/pretty.

0.7 -- 26 May 2023

Make use of more fonts, and bump io.aviso/pretty to version 1.4.2.

0.6 -- 7 Oct 2022

Exposed a best-match function which uses the same match logic as the dispatch function.

Added default for :tool-name option (to dispatch), determined from the babashka.file system property.

Added :validate directive to command interface, allowing for validations that involve multiple options.

0.5 -- 29 Aug 2022

Add public exit function as a testable way to call System/exit.

Now highlights the tool name and command name in bold, in error messages.

Now suggests the most likely command name when the given name doesn't match exactly one command.

0.4 -- 18 Aug 2022

Added support for the :let keyword in the command interface.

Changed defcommand to create a variadic function.

Added checks that options and argument symbols are unique; now all parsed options and positional arguments are provided in a single :options map, which simplifies testing.

0.3 -- 11 Aug 2022

Fix logic for default command summary to just be first line of docstring.

0.2 -- 11 Aug 2022

Don't catch exceptions in dispatch.

Split the dispatch function into dispatch and dispatch*.

Added locate-commands, for when invoking dispatch* directly.

Detect command name conflicts when locating commands.

Added :summary to interface.

0.1 -- 8 Aug 2022

Initial release.