click-option-group

Option groups missing in Click

click-option-group Permissive license BSD-3-Clause AGING ★ 121 v0.5.9 released 2025-10-09

Install

click-option-group on PyPI

pip

pip install click-option-group

uv

uv add click-option-group

poetry

poetry add click-option-group

Package facts

License	BSD-3-Clause (permissive)
Python support	supports the current Python release (>=3.7)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — click
Maintenance	aging — 308 days since the last release
Last repo commit	2025-10-09
First released	2019-12-04
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: click_option_group-0.5.9-py3-none-any.whl

Development Status :: 4 - BetaEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Libraries

About click-option-group

from the package's own PyPI description — quoted content, verbatim

click-option-group

PyPI version (image) Build status (image) Coverage Status (image) Supported Python versions (image) License (image)

click-option-group is a Click-extension package that adds option groups missing in Click.

Aim and Motivation

Click is a package for creating powerful and beautiful command line interfaces (CLI) in Python, but it has no the functionality for creating option groups.

Option groups are convenient mechanism for logical structuring CLI, also it allows you to set the specific behavior and set the relationship among grouped options (mutually exclusive...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Adds option groups to Click CLI applications, enabling logical grouping of command-line options and enforcing relationships like mutual exclusivity between grouped options.

Low friction: pure Python wheel with only click as a runtime dependency. Maintenance is aging—308 days since last release—but the repository remains active with recent commits and modest community engagement (121 stars).

BSD-3-Clause is permissive; you may use, modify, and distribute this package freely in commercial and private projects provided you retain the license notice.

Usage

pip install click-option-group

import click
from click_option_group import optgroup

@click.command()
@optgroup.group('Server config')
@optgroup.option('-h', '--host', default='localhost')
@optgroup.option('-p', '--port', type=int, default=8888)
def cli(host, port):
    print(f'{host}:{port}')

if __name__ == '__main__':
    cli()

Verdict: A stable, low-friction extension for Click that fills a genuine gap in the standard library. No known vulnerabilities, permissive license, and broad Python 3.7+ support make it safe to adopt. Aging maintenance (308 days) is a minor concern but not a blocker given the repository's continued activity and the package's focused, stable scope.

Needs verification

Whether the 308-day release gap reflects intentional stability or reduced active development
Compatibility with the latest Click major versions (8.x+) beyond what classifiers indicate

click option groupscli option groupingmutually exclusive click optionsclick command line groupsstructured cli argumentsclick option organization