DependaMan

Understand your Python project's internal structure. Find cycles, dead modules, hotspots, and architecture problems — visualized as an interactive graph.

Installation

pip install dependaman

Usage

CLI:

dependaman                          # analyze the current directory, open the graph
dependaman /path/to/project         # analyze another project
dependaman --format json -o -       # print the analysis as JSON on stdout
dependaman -o graph.html            # choose the output file
dependaman --no-browser             # write the file, do not open a browser
dependaman --help

Point dependaman at the directory that contains your top-level package, not at the package itself — imports are resolved against the package name, so analyzing myproject/myproject/ leaves most modules without edges.

JSON output is the whole analysis, so it pipes:

dependaman --format json -o - | jq '.cycles'

Python API:

from dependaman import dependaman

dependaman()                                    # writes Dependaman.html, opens browser
dependaman("/path/to/project", in_memory=True)  # returns the HTML as a string
dependaman(".", output_format="json", output_path="graph.json") # returns a format correct json file in the output_path

Every argument after path is keyword-only:

With in_memory=True nothing is written and output_path / open_browser are ignored — useful for serving the graph from a web handler.

Documentation

• Website
• Design
• Constraints
• Changelog
• Repository