odoo-dependency-graph

Build a dependency graph for Odoo addons, spot tightly coupled or frequently changed modules, and export the results as PlantUML, SVG, JSON, or JUnit XML.

Installation

pip install odoo-dependency-graph

For SVG output, install the PlantUML extra and make sure Java is available:

pip install "odoo-dependency-graph[plantuml]"
java -version

Usage

odoo-dependency-graph ADDON_PATHS [OUTPUT_FILE] [OPTIONS]

Separate multiple addon paths with commas. The output extension selects the format: .puml, .svg, .json, or .xml; the default is graph.puml.

odoo-dependency-graph ./odoo/addons,./custom-addons graph.svg --exclude-orphans

CLI options

• --exclude-orphans removes addons with no connections.
• --volatile-only keeps only modules above --volatility (default: 0.3).
• --danger-metric METRIC=MIN,MAX sets orange and red thresholds.
• --git-activity includes recent commits; tune with --git-since and --activity-weight (default: 0.3).
• --skip-file true prints metrics without creating an output file.
• --java PATH selects the Java executable used for SVG output.
• -h, --help shows the full command reference.