REPOMATIC-UPDATE-DEP-GRAPH(1) REPOMATIC-UPDATE-DEP-GRAPH(1)

repomatic update-dep-graph - Generate dependency graph from uv lockfile

repomatic update-dep-graph [OPTIONS]

Generate a Mermaid dependency graph from the project's uv lockfile.

Parses the CycloneDX SBOM export from uv and renders it as a Mermaid flowchart for documentation. Version specifiers from uv.lock are shown as edge labels.

Include dependencies from the specified group. Can be repeated.
Include all dependency groups from pyproject.toml.
Exclude the specified group. Takes precedence over --all-groups and --group. Can be repeated.
Only include dependencies from the specified group, excluding main dependencies. Can be repeated.

Include dependencies from the specified extra. Can be repeated.
Include all optional extras from pyproject.toml.
Exclude the specified extra, if --all-extras is supplied. Can be repeated.
Only include dependencies from the specified extra, excluding main dependencies. Can be repeated.

Focus on a specific package's dependency tree.
Use --frozen to skip lock file updates.
Maximum depth of the dependency graph. 1 = directly-declared deps only, 2 = adds their deps, etc.
Output file path. Defaults to [tool.repomatic] config or stdout.
Show this message and exit.

Include dependencies from the specified group. Can be repeated.
Include all dependency groups from pyproject.toml.
Exclude the specified group. Takes precedence over --all-groups and --group. Can be repeated.
Only include dependencies from the specified group, excluding main dependencies. Can be repeated.
Include dependencies from the specified extra. Can be repeated.
Include all optional extras from pyproject.toml.
Exclude the specified extra, if --all-extras is supplied. Can be repeated.
Only include dependencies from the specified extra, excluding main dependencies. Can be repeated.
Focus on a specific package's dependency tree.
Use --frozen to skip lock file updates.
Maximum depth of the dependency graph. 1 = directly-declared deps only, 2 = adds their deps, etc.
Output file path. Defaults to [tool.repomatic] config or stdout.
Show this message and exit.

0
Success.
1
A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2
A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

Generate Mermaid graph

repomatic update\-dep\-graph

Include test dependencies

repomatic update\-dep\-graph \-\-group test

Include all groups and extras

repomatic update\-dep\-graph \-\-all\-groups \-\-all\-extras

Include all groups except typing

repomatic update\-dep\-graph \-\-all\-groups \-\-no\-group typing

Include all extras except one

repomatic update\-dep\-graph \-\-all\-extras \-\-no\-extra json5

Show only test group dependencies (no main deps)

repomatic update\-dep\-graph \-\-only\-group test

Show only a specific extra's dependencies

repomatic update\-dep\-graph \-\-only\-extra xml

Focus on a specific package

repomatic update\-dep\-graph \-\-package click\-extra

Limit graph depth to 2 levels

repomatic update\-dep\-graph \-\-level 2

Save to file

repomatic update\-dep\-graph \-\-output ./docs/assets/dependencies.mmd

Kevin Deldycke

2026-09-14 7.15.1.dev0