ToolStabil

Dependency Graph

Visualisiert Modul-Abhängigkeiten, erkennt zirkuläre Imports und analysiert die Projektstruktur.

Grundlegende Befehle

# Graph generieren
velin-deps graph

# Als DOT-Format exportieren
velin-deps graph --format dot > deps.dot

# Als JSON exportieren
velin-deps graph --format json > deps.json

# Nur bestimmtes Modul analysieren
velin-deps graph --module src/auth

Zirkuläre Abhängigkeiten

# Zirkuläre Imports finden
velin-deps cycles

# Output:
# ⚠ Circular dependency detected:
#   auth/user.velin → utils/helpers.velin → auth/permissions.velin → auth/user.velin

Zirkuläre Imports vermeiden

Zirkuläre Abhängigkeiten können zu Laufzeitfehlern führen. Nutze Interfaces oder extrahiere gemeinsamen Code.

Analyse-Features

Dependency Tree

Hierarchische Ansicht aller Abhängigkeiten

Cycle Detection

Findet zirkuläre Import-Ketten

Unused Imports

Erkennt nicht verwendete Module

Export Analysis

Zeigt exportierte Symbole pro Modul

Visualisierung

# SVG generieren (benötigt Graphviz)
velin-deps graph --format dot | dot -Tsvg > deps.svg

# Interaktive HTML-Ansicht
velin-deps graph --format html --output deps.html

# Im Browser öffnen
velin-deps graph --serve

Konfiguration

velin.tomltoml
[tools.dependency-graph]
# Ignorierte Pfade
ignore = ["test/", "examples/"]

# Maximale Tiefe
max_depth = 10

# Externe Dependencies einbeziehen
include_external = false

# Gruppierung nach Ordner
group_by_folder = true
Velin FlowBundle Analyzer