Overview

Master branch
Latest release

Cloup (= Click + groups) contains a set of Click extensions that enable you to:

• define option groups with a clean API;
• define constraints, including conditional constraints, on any group of parameters (e.g. mutually_exclusive, RequireAtLeast(1) etc.);
• (optionally) show an auto-generated description of defined constraints in the command help;
• organize the subcommands of a MultiCommand in multiple help sections.

These features are implemented in three "mixins" following the same pattern of click-contrib extensions (cooperative multiple inheritance). For ease of use, Cloup also provides:

• its own versions of Click commands classes, obtained by mixing Click classes with the above mentioned mixins;
• its own versions of Click command decorators, for creating such commands.

Documentation

Read more in the documentation:

• latest release
• development version.