cli-dependency-graph 0.1.0

CLI tool to statically analyze and visualize Click/Typer command trees.

CLI Dependency Graph

Statically analyze and visualize the structure of Python CLI apps built with Click or Typer.

Features

• Detects click.Group, click.command, and Typer apps (Typer()) via static AST parsing (no code execution)
• CLI commands:
  • scan <path>: Discover command tree
  • show: Print ASCII tree
  • export --format {dot,svg}: Save graph file (planned)
• Renders CLI structure as ASCII (terminal) or DOT/SVG (export)

Installation

pip install .

Usage

1. Scan a Python CLI app

python -m cli_dependency_graph scan example_click_app.py

2. Show the discovered CLI structure

python -m cli_dependency_graph show

3. (Optional) Export the CLI graph

python -m cli_dependency_graph export --format dot --output cli_graph.dot

Example CLI App

import click

@click.group()
def cli():
    pass

@cli.command()
def hello():
    """Say hello"""
    print("Hello!")

@cli.command()
def goodbye():
    """Say goodbye"""
    print("Goodbye!")

if __name__ == "__main__":
    cli()

Development

• Source code: src/cli_dependency_graph/
• Tests: tests/unit/

Run tests

pytest

Requirements

• Python 3.9+
• Typer >= 0.12.3
• Click >= 8.1.7
• rich >= 13.7.1
• graphviz >= 0.20.3
• pytest (for tests)

---

Contributions welcome!