Format click help output nicely with rich
Project description
Richly rendered command line interfaces in click.
Documentation · Source Code · Changelog
rich-click is a shim around Click that renders help output nicely using Rich.
- Click is a "Python package for creating beautiful command line interfaces".
- Rich is a "Python library for rich text and beautiful formatting in the terminal".
The intention of rich-click is to provide attractive help output from
Click, formatted with Rich, with minimal customisation required.
Features
- 🌈 Rich command-line formatting of click help and error messages
- 💫 Nice styles be default, usage is simply
import rich_click as click - 💻 CLI tool to run on other people's tools (prefix the command with
rich-click) - 📦 Export help text as HTML or SVG
- 🎁 Group commands and options into named panels
- ❌ Well formatted error messages
- 🔢 Easily give custom sort order for options and commands
- 🎨 Extensive customisation of styling and behaviour possible
Installation
pip install rich-click
Read the docs for all supported installation methods.
Examples
Simple Example
To use rich-click in your code, replace import click with import rich_click as click in your existing click CLI:
import rich_click as click
@click.command()
@click.option("--count", default=1, help="Number of greetings.")
@click.option("--name", prompt="Your name", help="The person to greet.")
def hello(count, name):
"""Simple program that greets NAME for a total of COUNT times."""
for _ in range(count):
click.echo(f"Hello, {name}!")
if __name__ == '__main__':
hello()
Screenshot from examples/11_hello.py
More complex example
Screenshot from examples/03_groups_sorting.py
Usage
This is a quick overview of how to use rich-click. Read the docs for more information.
There are a couple of ways to begin using rich-click:
Import rich_click as click
Switch out your normal click import with rich_click, using the same namespace:
import rich_click as click
That's it! ✨ Then continue to use Click as you would normally.
See
examples/01_simple.pyfor an example.
Declarative
If you prefer, you can RichGroup or RichCommand with the cls argument in your click usage instead.
This means that you can continue to use the unmodified click package in parallel.
See
examples/02_declarative.pyfor an example.
rich-click CLI tool
rich-click comes with a CLI tool that allows you to format the Click help output from any package that uses Click.
To use, prefix rich-click to your normal command.
For example, to get richified Click help text from a package called awesometool, you could run:
$ rich-click awesometool --help
Usage: awesometool [OPTIONS]
..more richified output below..
License
This project is licensed under the MIT license.
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 rich-click-1.8.0.dev2.tar.gz.
File metadata
- Download URL: rich-click-1.8.0.dev2.tar.gz
- Upload date:
- Size: 36.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a48c32d2edc0c21a23e8282fb5719b454cf50ddc77abb01707f1ae65259abb1a |
|
| MD5 | 25fbe3729f05d56af719060c90381077 |
|
| BLAKE2b-256 | ad703b44d4d5cd3361fe2566cbc064e4309f4fa618677e6215e2e5642dd1e24a |
File details
Details for the file rich_click-1.8.0.dev2-py3-none-any.whl.
File metadata
- Download URL: rich_click-1.8.0.dev2-py3-none-any.whl
- Upload date:
- Size: 33.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 31a30f43f63a793ba1983aa3038e514afdd80141508c7102cdaa55648f148b9e |
|
| MD5 | a4fd62b4ad4f2c2fd0ec1a7dc569f3c4 |
|
| BLAKE2b-256 | 2d5e3ea9adb1308c48ba0c1ad758703e9f109f8ff5e0f225f5365d01821f9534 |
