pallets / click

This repository is named 'click' in its recorded platform topics, and its GitHub description calls it a 'Python composable command line interface toolkit' with homepage https://click.palletsprojects.com. The primary language is Python, with 927,014 recorded Python language bytes. Platform metadata records a BSD-3-Clause license, a latest release 8.5.0 published on 2026-08-27, and 17,665 stargazers as of 2026-09-14. The source lives under a src/click package; for example, src/click/core.py defines classes Context and Command. The analyzer inventoried 177 files in total.

The analyzer detected one executable entrypoint, examples/complex/complex/cli.py, using a filename heuristic rather than runtime confirmation. Five bounded execution paths were traced from it, and each terminates with reason 'unresolved_boundary' at an external or unresolved call. The reached boundaries are os.path.abspath, click.make_pass_decorator, os.path.dirname, os.path.join, and dict. Beyond these boundary calls, the packet establishes no resolved local flow for a run of this script.

The analyzer identified three top-level subsystems: docs, src, and tests. The analyzed tree holds 58 files under tests, 41 under docs, 39 under examples, 18 under src, 10 under .github, and 2 under .devcontainer. By static call degree, src/click/_compat.py (90 incoming, 35 outgoing) and src/click/utils.py (47 incoming, 16 outgoing) attract the most incoming calls among library modules, which suggests they act as shared helpers. src/click/core.py has the highest outgoing count among recorded src/click modules (15 incoming, 52 outgoing), consistent with an orchestration role. Other connected modules include exceptions.py (25/12), types.py (18/25), termui.py (17/34), and shell_completion.py (13/17). Two test modules are also labeled 'service/core candidate' — tests/test_shell_completion.py (73/73) and tests/test_termui.py (21/21) — so the metric does not separate tests from library code. These role labels come from static resolved call degree and entrypoint membership, not from runtime measurement.

The analyzer recorded 11 build/dependency manifest files, and pyproject.toml is a project-level important file. This packet nonetheless contains no parsed dependency records: dependency extraction covers only requirements-style manifests and does not parse pyproject.toml dependency tables. Of 5,640 static relations, 590 are local and 5,050 are external or unresolved. The analyzer counted 58 test files or test-like files. Recorded test symbols include test_command, test_group, and test_chained in tests/test_shell_completion.py, plus progressbar tests such as test_progressbar_strip_regression and test_progressbar_eta in tests/test_termui.py.

Start with README.md, a project-level important file, and treat what it says as author claims. Then read pyproject.toml for packaging configuration and LICENSE.txt for the BSD-3-Clause terms. Open examples/complex/complex/cli.py next; it is the detected entrypoint and shows the library used from a script. Then read src/click/core.py for the Context and Command classes, src/click/types.py for ParamType, and src/click/shell_completion.py for ShellComplete. Finish with src/click/termui.py (prompt, confirm, progressbar) and src/click/utils.py (echo, open_file) for user-facing helpers.

This analysis is static only: reflection, dynamic imports, monkey-patching, generated code, framework runtime wiring, and dynamic dispatch are not resolved. Install, run, and build inference is partial, and installation commands were not exercised. Dependency evidence covers only requirements-style manifests, so the declared dependencies of this project are not established here. Analysis is bounded: files over 400 kB, minified bundles, and vendored directories are inventoried but not parsed, and relation extraction is capped at 2,500 per file and 150,000 per repository. 5,050 of 5,640 relations are external or unresolved, and the bounded execution paths end at 'unresolved_boundary', so runtime flow through the entrypoint is not established. README claim extraction is line-based, so README-derived statements count as author claims at most.

src/click/core.py records class Context at lines 213-961 and class Command at lines 964-1659. src/click/exceptions.py defines ClickException, UsageError, BadParameter, MissingParameter, NoSuchOption, and NoSuchCommand. src/click/types.py defines ParamType, CompositeParamType, FuncParamType, Choice, DateTime, and IntParamType. src/click/shell_completion.py provides shell_complete, a ShellComplete base class, and per-shell subclasses BashComplete, ZshComplete, FishComplete, and PowerShellComplete, plus add_completion_class for registration. src/click/termui.py provides prompt, confirm, and progressbar; src/click/utils.py provides echo, open_file, format_filename, and get_app_dir; src/click/_termui_impl.py provides ProgressBar and Editor.