🌈 Extra colorization and configuration loading for Click.
Project description
What is Click Extra?
A ready-to-use wrapper for Click, the Python CLI framework.
It is a drop-in replacement with good defaults that saves lots of boilerplate code and frustration. It also comes with workarounds and patches that have not reached upstream yet (or are unlikely to).
Example
It transforms this vanilla click CLI:
Into this:
To undestrand how we ended up with the result above, go read the tutorial.
Features
- Configuration file loader for:
TOMLYAMLJSON, with inline and block comments (Python-style#and Javascript-style//)INI, with extended interpolation, multi-level sections and non-native types (list,set, …)XML
- Automatic inference of the configuration file structure from your CLI's options
- Remote loading of configuration files from URLs
- Optional strict validation of configuration
- Search of configuration file from default user folder and glob patterns
- Respect of
CLI>Configuration>Environment>Defaultsprecedence --show-paramsoption to debug parameters defaults, values, environment variables and provenance- Colorization of help screens
-h/--helpoption names (see rant on other inconsistencies)--color/--no-coloroption flag--telemetry/--no-telemetryflag to opt-in/out of tracking code- Recognize traditional environment variable conventions:
NO_COLORfromno-color.orgDO_NOT_TRACKfromconsoledonottrack.com
- Colored
--versionoption - Colored
--verbosityoption and logs --time/--no-timeflag to measure duration of command execution- Platform recognition utilities (macOS, Linux, Windows, UNIX, *BSD, …)
- New conditional markers for
pytest:@skip_linux,@skip_macosand@skip_windows@unless_linux,@unless_macosand@unless_windows@destructiveand@non_destructive
.. click:example::and.. click:run::Sphinx directives to document CLI source code and their execution- ANSI-capable Pygments lexers for shell session and console output
- Pygments styles and filters for ANSI rendering
- Fixes 30+ bugs from other Click-related projects
- Rely on
cloupto add:- option groups
- constraints
- subcommands sections
- aliases
- command suggestion (
Did you mean <subcommand>?)
Used in
Check these projects to get real-life examples of click-extra usage:
Meta Package Manager - A unifying CLI for multiple package managers.
Mail Deduplicate - A CLI to deduplicate similar emails.
fireproxng - A rewrite of the fireprox tool.
badger-proxy - An mDNS-based reverse proxy for naming services on a local network.
Molecular Dynamics Trajectory Analysis
Feel free to send a PR to add your project in this list if you are relying on Click Extra in any way.
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-4.0.0.tar.gz.
File metadata
- Download URL: click_extra-4.0.0.tar.gz
- Upload date:
- Size: 70.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.11.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1321816d8e4831ace2963a658c346b9be6641ff45ace9e73af39348b0d9417e3 |
|
| MD5 | 8578b972e119ab1fdf20e242277e93eb |
|
| BLAKE2b-256 | 71ecb9234aab3d9917e7756c7b0a0386143c056a04562666a2f09a18d43038fc |
File details
Details for the file click_extra-4.0.0-py3-none-any.whl.
File metadata
- Download URL: click_extra-4.0.0-py3-none-any.whl
- Upload date:
- Size: 93.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.11.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 99d78b7a838d753b49de71fce8b4889c4ac910d1d992f523cdef2f4cfe1b8caa |
|
| MD5 | ea48a3805da196c0ff575c90773d72f2 |
|
| BLAKE2b-256 | 1a05b467d2712b54ef9ed1e2d41324784697403d2c8a0743311f49d842bb7ad0 |
