🌈 Extra colorization and configuration file for Click.
Project description
Click Extra
What is Click Extra?
click-extra is a collection of helpers and utilities for
Click, the Python CLI framework.
It provides boilerplate code and good defaults, as weel as some workarounds and patches that have not reached upstream yet (or are unlikely to).
Used in
- Meta Package Manager - A unifying CLI for multiple package managers.
- Mail Deduplicate - A CLI to deduplicate similar emails.
Installation
Install click-extra with pip:
$ pip install click-extra
Features
- TOML configuration file loader
- Colorization of help screens
--color/--no-coloroption flag- Colored
--versionoption - Colored
--verbosityoption and logs --time/--no-timeflag to measure duration of command execution- Platform recognition utilities
- New conditional markers for
pytest:@skip_linux,@skip_macosand@skip_windows@unless_linux,@unless_macosand@unless_windows@destructiveand@non_destructive
TOML configuration file
Allows a CLI to read defaults options from a configuration file.
Here is a sample:
# My default configuration file.
[my_cli]
verbosity = "DEBUG"
manager = ["brew", "cask"]
[my_cli.search]
exact = true
Colorization of help screen
Extend Cloup's own help formatter and theme to add colorization of:
- Options
- Choices
- Metavars
This has been discussed upstream at:
- https://github.com/janluke/cloup/issues/97
- https://github.com/click-contrib/click-help-colors/issues/17
- https://github.com/janluke/cloup/issues/95
Dependencies
Here is a graph of Python package dependencies:
Development
Development guidelines
are the same as
parent project mpm, from
which click-extra originated.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file click-extra-1.1.1.tar.gz.
File metadata
- Download URL: click-extra-1.1.1.tar.gz
- Upload date:
- Size: 20.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 450b93942d632be34c9b09b02f3d5193683fc2d24c58ee122a29303d6e2d4963 |
|
| MD5 | 82a2c74d6a6e5033c61928880b7e08ee |
|
| BLAKE2b-256 | f029ed9b71e5be40346dae8b8b71c47586f44239856aa3124aaf31fdb862046f |
File details
Details for the file click_extra-1.1.1-py3-none-any.whl.
File metadata
- Download URL: click_extra-1.1.1-py3-none-any.whl
- Upload date:
- Size: 30.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6e91cfc47c07723b4384595b2acd410ae2f56a36f3c39c272321ce0c280eb389 |
|
| MD5 | 7a551de1d5be8364051a6208869bf54a |
|
| BLAKE2b-256 | 7ee7dd61abcbb07e5cba2d3cc7eeb8f87a66712bf3465960c8b0bf3c5a453a01 |
