classmap-hanthink 0.2.0

Scan Python class inheritance relationships and render them as readable maps.

classmap-hanthink

classmap-hanthink is a small Python developer tool that scans Python files and shows class inheritance relationships as a readable tree.

Simple explanation:

It helps you see which class is the parent and which classes are children.

Technical explanation:

It parses Python source code with the standard ast module, extracts class definitions and base classes, builds a parent-to-child inheritance map, and renders the result as a text tree.

Installation

pip install classmap-hanthink

CLI Usage

Scan the current folder:

classmap .

Scan a specific file:

classmap examples/sample_classes.py

Show explanation text:

classmap . --explain

Show Mermaid class diagram output:

classmap . --mermaid

Python Usage

from classmap_hanthink import scan_path, build_inheritance_map, render_text_tree

classes = scan_path("examples/sample_classes.py")
tree = build_inheritance_map(classes)
print(render_text_tree(classes, tree))

Example Output

classmap report

Target: examples/sample_classes.py
Classes found: 6

Inheritance Tree

Animal [examples/sample_classes.py:1]
├── Cat [examples/sample_classes.py:13]
└── Dog [examples/sample_classes.py:5]
    └── Puppy [examples/sample_classes.py:9]

Independent Classes

- Config [examples/sample_classes.py:17]
- ExternalChild [examples/sample_classes.py:21]

Development

uv sync --group dev
uv run pytest tests/ -v
uv build

Release Roadmap

v0.1.0

• Scan Python files and folders
• Extract class names, base classes, file paths, and line numbers
• Build parent-to-child inheritance relationships
• Render text tree output
• Render optional explanation output
• Render optional Mermaid classDiagram output
• Provide CLI command: classmap

External Base Classes

Use --show-external to show classes that inherit from external or built-in base classes.

classmap examples/sample_classes.py --show-external

Example output:

External Base Classes

dict
└── ExternalChild [examples/sample_classes.py:21]