click-extra

library7.20.1pypypiunverified

A drop-in replacement for Click that adds colorful and user-friendly CLI output, extended help formatting, table rendering, configuration management, and more. Version 7.14.1 supports Python >=3.10 and acts as a thin wrapper around Click, providing extra decorators, commands, and utilities. Releases are frequent, typically monthly.

devops web-framework database

pip install click-extra

github ↗package ↗homepage ↗changelog ↗

INSTALL

IMPORT

SIG · CLICK-EXTRA

click-extra

devopspythonv7.20.1

Install

3.3s avg

Import

1588ms

Disk

30MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v7.20.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 1.612s · 33.7MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.3s · import 1.246s · 34MB

30MB installed

● package 30MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ExtraGroup

✓ from click_extra import ExtraGroup

✗ from click_extra import ExtraGroup

Creates a CLI with colorful help using ExtraGroup and the click-extra help option.

import click from click_extra import ExtraGroup, help_option @click.group(cls=ExtraGroup) @click.option('--name', default='world', help='Who to greet.') @click.pass_context def cli(ctx, name): ctx.ensure_object(dict) ctx.obj['name'] = name @cli.command() @help_option('-h', '--help') @click.pass_context def greet(ctx): click.echo(f"Hello, {ctx.obj['name']}!") if __name__ == '__main__': cli()

Debug

Known issues

breakingIn version 7.7.0, the `version` parameter was removed from `ExtraCommand` and `ExtraGroup`. Use `version_fields` instead.

fix

Replace `version=value` with `version_fields={'version': value}` or use `ExtraVersionOption` directly.

affects: >=7.7.0

deprecatedThe `config_schema` parameter accepts both dataclasses and callables. Legacy config section names using `fallback_sections` will issue deprecation warnings in future versions.

fix

Migrate your config section names to the new default and remove `fallback_sections`.

affects: >=7.8.0

gotchaWhen using `click-extra`'s `wrap` subcommand, the target script must be a valid console_scripts entry point or a `module:function` string. Otherwise, it will fail silently or produce no output.

fix

Ensure the SCRIPT argument matches an installed entry point (e.g., from pyproject.toml) or is in `module:function` format.

affects: >=7.14.0

gotchaThe `click-extra` `ExtraGroup` changes Click's default help ordering and adds color by default. Existing Click code that relies on default help behavior may see different formatting.

fix

If you need standard Click behavior, use `cls=click.Group` instead of `ExtraGroup`, or pass `colorize=False` to the decorator.

affects: all

Upgrade

Version history

7.20.1latest on PyPI · released Jun 18, 2026

Audit

Dependencies

clickrequiredCore dependency; click-extra extends Click. Requires Click >=8.1 (compatible with 8.1, 8.2, 8.3+).

tabulaterequiredRequired for table rendering with --table-format. Backward compatible with >=0.9.

pygmentsrequiredUsed for syntax highlighting in help output and the wrap command.

Agent activity

5 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/kdeldycke/click-extra ↗

packagehttps://pypi.org/project/click-extra/ ↗

homepagehttps://kdeldycke.github.io/click-extra ↗

changeloghttps://github.com/kdeldycke/click-extra/blob/main/changelog.md ↗