Metadata-Version: 2.4
Name: odoo-dependency-graph
Version: 0.1.1
Summary: Analyze and visualize dependencies between Odoo addons
Keywords: odoo,dependencies,plantuml,graph
Author: Nikita Novikov
Author-email: Nikita Novikov <nikitanovvval@gmail.com>
License-Expression: LGPL-2.1-or-later
License-File: LICENSE
Requires-Dist: odoo-dependency-graph-plantuml==1.2026.2 ; extra == 'plantuml'
Requires-Python: >=3.9
Project-URL: Repository, https://github.com/Novvval/odoo_dependency_graph
Provides-Extra: plantuml
Description-Content-Type: text/markdown

# 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

```bash
pip install odoo-dependency-graph
```

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

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

## Usage

```bash
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`.

```bash
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.
