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:
Change Log
v0.7.1 (2021-05-02)
Fixed a bug with & and | Predicate operators giving AttributeError when used.
Fixed the error message of accept_none which didn’t include {param_list}.
Improved all_or_none error message.
Minor docs fixes.
v0.7.0 (2021-03-24)
Compatible changes and features
In constraint errors, the way the parameter list is formatted has changed. Instead of printing a comma-separated list of single labels:
each parameter is printed on a 2-space indented line and
both the short and long name of options are printed.
See the relevant commit.
Minor improvements to code and docs.
v0.6.1 (2021-03-01)
This patch release fixes some problems in the management and releasing of the package.
Add a py.typed file to ship the package with type hints (PEP 561).
Use setuptools-scm to automatically manage the version of the package and the content of the source distribution based on the git repository:
the source distribution now matches the git repository, with the only exception of _version.py, which is not tracked by git; it’s generated by setuptools-scm and included in the package;
tox.ini and Makefile were updated to account for the fact that _version.py doesn’t exist in the repository before installing the package.
The new attribute cloup.__version_tuple__ stores the version as a tuple (of at least 3 elements).
v0.6.0 (2021-02-28)
Incompatible changes
Removed the deprecated GroupSection as previously announced. Use the new name instead: Section.
In Group.group() and Group.command, the argument section was moved after the cls argument so that the signatures are now fully compatible with those of the parent class (the Liskov substitution principle is now satisfied). If you (wisely) passed section and cls as keyword arguments in your code, you don’t need to change anything.
Compatible changes
Slightly improved return type (hint) of command decorators.
Minor refactoring of ConstraintMixin.
Improved the documentation.
v0.5.0 (2021-02-10)
Requirements
Drop support to Python 3.5.
Deprecated
GroupSection was renamed as Section.
Compatible changes and features
Added a subpackage for defining constraints on parameters groups (including OptionGroup’s).
The code for adding support to option groups was extracted to OptionGroupMixin.
Most of the code for adding support to subcommand sections was extracted to SectionMixin.
Project changes
Migrated from TravisCI to GitHub Actions.
v0.4.0 (2021-01-10)
Requirements
This is the last release officially supporting Python 3.5.
Compatible changes and features
Changed the internal (non-public) structure of the package.
Minor code improvements.
Repository-wise:
New documentation (hosted by ReadTheDocs)
Tox, TravisCI, Makefile completely rewritten.
v0.3.0 (2020-03-26)
Backward incompatible API changes
option_groups decorator now takes options as positional arguments *options;
Group.section decorator now takes sections as positional arguments *sections;
align_sections_help was renamed to align_sections;
GroupSection.__init__() sorted_ argument was renamed to sorted.
Other changes
Additional signature for option_group: you can pass the help argument as 2nd positional argument.
Aligned option groups (option align_option_groups with default True).
More refactoring and testing.
v0.2.0 (2020-03-11)
[Feature] Add possibility of organizing subcommands of a cloup.Group in multiple help sections.
Various code improvements.
- Backward incompatible change:
rename CloupCommand and CloupGroup resp. to just Command and Group.
v0.1.0 (2020-02-25)
First release on PyPI.
1 maintainer
Metadata
1 maintainer
Release files for cloup 0.7.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cloup-0.7.1.tar.gz | 55.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cloup-0.7.1-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 79.8 kB
Release files / cloup-0.7.1.tar.gz
| Download URL | cloup-0.7.1.tar.gz |
|---|---|
| Size | 55.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f26cc500dda4e4c9444ac1008b82376df8d72ecfa43a6310a9b3d54ef98add7b
|
|
BLAKE2b-256 checksum How to use checksums |
f15f2c7616582665b2dd2f7689c44a4618d3a019c0ccd4ea19da2975c56528ff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4
|
Release files / cloup-0.7.1-py2.py3-none-any.whl
| Download URL | cloup-0.7.1-py2.py3-none-any.whl |
|---|---|
| Size | 23.9 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
947c881ada77ea2f7b2876f7b5bb2fc7e5406daac5a045342acf8de35bcce5d7
|
|
BLAKE2b-256 checksum How to use checksums |
4bc50a47ad3613dc43a6a984efdadb85b3afbc6f4acff2e6dc5c05e3752d680b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4
|
