Skip to content

ADR-0002 — click over argparse

Update date : 2026-05-27 20:11

Status: accepted Date: 2026-05-26

Context

CLI framework choice for the pinky-provider command. Two candidates: - argparse (stdlib, zero dependency) - click (third-party)

Decision

click. Command = function + decorators. Integrates natively with rich and rich-click.

Consequences

  • Less boilerplate than argparse; shell completion via click + shellingham.
  • rich-click replaces --help rendering with rich output at zero extra cost.
  • Typed error handling built in.
  • One extra dependency (minor — click is stable and widely used).