Liking cljdoc? Tell your friends :D

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

Can you improve this documentation? These fine people already did:
Arne Brasseur & Gabriel
Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close