Changes:
The abort function assumes an exit status of 1 if the first message passed is not numeric.
It also now prints the tool and command name in bold green (to be consistent with
the rest of the library).
The clj-kondo hook for the defcommand macro now produces slightly different code, that defeats
the clj-kondo static type analysis, preventing spurious warnings about vectors passed
to particular clojure.core functions.
Dependencies were not properly declared for Clojure applications that use cli-tools (libraries that are bundled with Babashka were omitted).
A number of minor issues related to single-command tools (those that use a defcommand
to define their single main entrypoint, usually named -main) were resolved.
Added optional namespace net.lewisship.cli-tools.completions, which is considered experimental.
The added completions command generates zsh command completions for the tool.
Added new functions to net.lewisship.cli-tools:
abortis used to terminate a tool with a status code and provide an error message to standard error
The help builtin command now includes an optional search term argument; if provided, only commands whose name
or command summary includes the search term (using a caseless match) are included in the output.
Added support for :command-ns meta-data on namespaces.
Added two optional namespaces (that appear as built-in commands):
net.lewisship.cli-tools.color(prints a chart of foreground and background colors)net.lewisship.cli-tools.job-status-demo(runs a demo of the job status system)
BREAKING CHANGES
The print-summary command was removed, and replaced with print-errors. When a command has input
errors, only a brief summary of the command name is printed (previously, it was the entire command summary
including options and arguments).
The tool and command name, when printed in summaries and errors, is now consistently in bold green.
Moves specs to their own namespace.
Ensure that most output (such as command summaries, prompts, help text)
goes to *err*, not *out*.
Added an on-disk caching mechanism to avoid loading most namespaces when dispatching to commands.
Added function net.lewisship.cli-tools/ask, which prompts the user
for input (such as "yes" or "no").
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.
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.
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).
Switched from io.aviso/pretty to org.clj-commons/pretty.
Make use of more fonts, and bump io.aviso/pretty to version 1.4.2.
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.
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.
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.
Fix logic for default command summary to just be first line of docstring.
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.
Initial release.