Skip to content

CHANGELOG.md

Latest commit

 

History

History
258 lines (150 loc) · 5.88 KB

CHANGELOG.md

File metadata and controls

258 lines (150 loc) · 5.88 KB

Unreleased

Added

Fixed

Changed

1.29.127 (2026-04-10 / c8d5d75)

Changed

  • When there are a large number of flags/subcommands, split the synopsis across multiple lines, breaking at 120 characters

1.28.124 (2026-04-10 / 37a0800)

Fixed

  • Ignore leading whitespace on consecutive lines of flag docs

1.27.121 (2025-10-27 / 8245765)

Fixed

  • Hide :no-doc flags from help text
  • Correctly quote in .zshrc completion declaration

1.26.116 (2025-10-20 / 1d9739a)

Fixed

  • Fix completion when no docstring is present

1.25.107 (2025-10-16 / 678a49c)

Added

  • Experimentally add zsh and bash completions
  • Support both :command and :commands on the same level

0.24.97 (2025-07-12 / 449155f)

Fixed

  • When having named positional arguments and trailing unnamed positional arguments, assign them correctly

0.23.93 (2025-02-25 / a192123)

Added

  • Add source tracking (config provenance) for keys in the initial context

Fixed

  • Only apply flag defaults if they are not yet present in the initial context

0.22.87 (2025-02-09 / afd4eb0)

Added

  • :middleware can now be a single function, not only a sequence of functions

Changed

  • [BREAKING] When setting a :handler for a boolean flag (one that looks like --[no-]...), the handler now receives the boolean value as a second argument
  • [BREAKING] Invoke flag handlers/middleware in the order they are specified, so that later flags can override earlier flags

0.21.84 (2025-02-09 / fa56d06)

Added

  • Support :middleware in command specs, not just in flag handlers

0.20.81 (2025-02-06 / 4f86a6e)

Fixed

  • Call parse of default value, as documented, also when no :handler for a flag is specified. Fixes #9

0.19.78 (2024-12-23 / a1f884e)

Added

  • Add provenance tracking, :lambdaisland.cli/sources is a map from options key to human readable description of where that key came from, e.g. --foo command line flag, or positional command line argument idx=0. See lambdaisland/config for a use case.

0.18.74 (2024-08-05 / 14b74ba)

Added

  • Allow using a var that points to a map as a command specification

0.17.71 (2024-07-24 / ac0239c)

Fixed

  • Add missing require for clojure.pprint

0.16.68 (2024-07-17 / 3c1b328)

Added

  • Added :coll? flagopt for flags that can be specified multiple times
  • Correctly print multiline flag docstrings

Fixed

Changed

0.15.65 (2024-07-16 / 8917f5a)

Fixed

  • Make sure cli/*opts* reflects what the main command receives

0.14.62 (2024-07-04 / 8a515f3)

Added

  • Allow :init also on nested subcommands, gets merged into top level init. Flags are processed afterwards, so this is good way to set initial data that flags can filter/change
  • Flags handlers can now be specified directly as vars, the docstring is used as flag doc

0.13.58 (2024-06-07 / 09cd1f9)

Fixed

  • Fix generated help text when subcommand is not recognized

0.12.53 (2024-05-30 / 7b52e6d)

Changed

  • When catching a top-level exception, print the ex-data, if any
  • If the ex-data contains an :exit key, use that as exit code instead of 1
  • Rework the help layout be more man-page-like

0.11.48 (2024-05-27 / d98625f)

Fixed

  • Show correct help for subcommands

Changed

  • Change the help layout to be man-page style
  • When catching a top-level exception, print the ex-data (if any)
  • Use the :exit in the ex-data as exit code (1 otherwise)

0.10.45 (2024-05-27 / 025991c)

Added

  • Better help messages: say why we are showing the help (no such command, missing positional args)

0.9.42 (2024-05-27 / 3b81e73)

Changed

  • Exit with error message if conditional arguments are missing

0.8.39 (2024-05-24 / e967e9c)

Added

  • Added :required for :flags
  • Support commands with arguments and subcommands at the same time

0.7.33 (2024-02-27 / cb19704)

Fixed

  • Remove debug call

0.6.30 (2024-02-27 / c9696a0)

Added

  • -h can now be used to get help, in addition to --help

Changed

  • When encountering parse errors (invalid arguments), print a message and exit, rather than throwing (which looks quite ugly from a bb script)

0.5.27 (2024-02-26 / 28f559d)

Added

  • Allow a command spec to be just a function

Fixed

  • Preserve command order in help text when using a vector

0.4.24 (2024-02-17 / 5a1e316)

Added

  • Bind the options map to cli/*opts*, for easy access.
  • Show the default for a flag in the help text.
  • Add a docstring to the main entry point (dispatch)
  • Bind *opts* during flag handler execution

Fixed

  • Recognize - and \\--foo as positional args

Changed

  • When given both a :default and a :handler for a flag, call the handler with the default, rather than just assoc-ing it.
  • When given a string :default and a :parse function for a flag, run the default value through the parse function, rather than using it directly. Using the unparsed string form for the default is preferable over for instance using a keyword, since it leads to better help text rendering.
  • Improve and document the processing logic, especially when it comes to subcommand flags with handler functions.

0.3.19-alpha (2024-02-11 / d79ac0c)

Much expanded and improved version, see README for all details. This is approaching the envisioned scope for this library.

  • take docstring/command from var
  • :strict? mode
  • :handler and :middleware on flags
  • Much improved help text rendering
  • More lenient flag parsing
  • Add :default and :parse

0.2.11-alpha (2024-02-08 / 0a352bc)

Added

  • Handle named command arguments
  • Support --flag FOO and --flag=<foo> (and --flag <foo>)
  • Boolean flags count by default, e.g. -vvv => {:verbose 3}

Changed

  • Command handlers take a single unified map

0.1.6-alpha (2024-02-04 / 593806e)

Added

  • subcommand handling
  • rudimentary flag handling
  • help text generation