Rev-dep

Funktionen  •   Installation  •   Dokumentation  •   Explorations-Toolkit  •   CLI-Referenz

Toolkit zur Abhängigkeitsanalyse und -optimierung für moderne JavaScript- und TypeScript-Codebasen.
Erzwinge Hygiene im Abhängigkeitsgraphen und entferne ungenutzten Code mit einer sehr schnellen CLI.

---

Über 📣

Mit dem Wachstum von Codebasen wird es unmöglich, eine mentale Karte der Abhängigkeiten zu behalten. Rev-dep ist ein hochgeschwindigkeits-Static-Analysis-Tool, das entwickelt wurde, um Architekturintegrität und Abhängigkeitshygiene in groß angelegten JS/TS-Projekten durchzusetzen.

Betrachte Rev-dep als einen Hochgeschwindigkeits-Linter für deinen Abhängigkeitsgraphen.

Konsolidiere fragmentierte, sequenzielle Prüfungen aus mehreren langsamen Tools in einer einzigen, hochperformanten Engine. Rev-dep führt eine vollständige Suite von Governance-Prüfungen aus – einschließlich Zirkularität, Waisen, Modulgrenzen und mehr – in einem einzigen parallelisierten Durchlauf. Implementiert in Go, um die Leistungsengpässe der Node-basierten Analyse zu umgehen, kann es ein Projekt mit über 500k LoC in etwa 150ms prüfen. Siehe den Leistungsvergleich

Automatisierte Codebase-Governance

Rev-dep geht über passives Scannen hinaus zu aktiver Durchsetzung und beantwortet (und lässt CI fehlschlagen für) die schwierigen Fragen:

• Architekturintegrität: „Importiert meine ‚Domain A‘ illegal aus ‚Domain B‘?“.
• Toter Code & Ballast: „Sind diese Dateien unerreichbar, oder sind diese node_modules ungenutzt?“.
• Refactoring-Sicherheit: „Welche Einstiegspunkte verwenden tatsächlich dieses Utility, und gibt es zirkuläre Ketten?“.
• Workspace-Hygiene: „Sind meine Imports konsistent und sind alle Abhängigkeiten deklariert?“.

Rev-dep dient als Hochgeschwindigkeits-Torwächter für deine CI und stellt sicher, dass dein Abhängigkeitsgraph schlank bleibt und deine Architektur intakt bleibt, während du iterierst.

Warum Rev-dep? 🤔

🏗️ Erstklassige Monorepo-Unterstützung

Entwickelt für moderne Workspaces (pnpm, yarn, npm). Rev-dep löst nativ package.json exports/imports-Maps, TypeScript-Aliase auf und verfolgt Abhängigkeiten über Paketgrenzen hinweg.

🛡️ Konfigurationsbasierte Codebase-Governance

Gehe über passives Scannen hinaus. Verwende die Konfigurations-Engine, um Modulgrenzen und Import-Konventionen durchzusetzen. Führe eine vollständige Suite von Hygiene-Prüfungen (Zirkularität, Waisen, ungenutzte Module und mehr) in einem einzigen, parallelisierten Durchlauf aus, der als Hochgeschwindigkeits-Torwächter für deine CI dient.

🔍 Explorations-Toolkit

CLI-Toolkit, das hilft, Probleme mit Abhängigkeiten zwischen Dateien zu debuggen. Verstehe transitive Beziehungen zwischen Dateien und behebe Probleme.

⚡ Für Geschwindigkeit und CI-Effizienz entwickelt

Implementiert in Go, um die Leistungssteuer der Node-basierten Analyse zu eliminieren. Durch die parallele Verarbeitung von Dateien bietet Rev-dep eine 17x-90x schnellere Ausführung als Alternativen, was CI-Kosten und Wartezeiten für Entwickler erheblich reduziert.

Rev-dep kann ein Projekt mit über 500k LoC in etwa 150ms prüfen. Siehe den Leistungsvergleich

Funktionen 🚀

Governance und Wartung (konfigurationsbasiert) 🛡️

Verwende rev-dep config run, um mehrere Prüfungen in einem Durchlauf für alle Pakete auszuführen.

Verfügbare Prüfungen:

• moduleBoundaries - erzwingt Architekturgrenzen zwischen Modulen.
• importConventions - erzwingt Import-Stilkonventionen (bietet Autofix).
• unusedExportsDetection - erkennt Exporte, die nie verwendet werden (bietet Autofix).
• orphanFilesDetection - erkennt tote/Waisen-Dateien (bietet Autofix).
• unusedNodeModulesDetection - erkennt deklarierte, aber ungenutzte Abhängigkeiten.
• missingNodeModulesDetection - erkennt Imports, die in package json fehlen.
• unresolvedImportsDetection - erkennt unaufgelöste Import-Anfragen.
• circularImportsDetection - erkennt zirkuläre Imports.
• duplicatedCodeDetection - erkennt kopierten Code (wiederholte Blöcke und JSX-Elemente).
• devDepsUsageOnProdDetection - erkennt dev-Abhängigkeiten, die in Produktionscode verwendet werden.
• restrictedImportsDetection - blockiert das Importieren verbotener Dateien/Module aus ausgewählten Einstiegspunkten.
• restrictedImportersDetection - Whitelist, welche Einstiegspunkte transitiv eine Menge von Dateien/Modulen erreichen dürfen.
• restrictedDirectImportersDetection - beschränkt, welche Dateien direkt eine Menge von Dateien/Modulen importieren dürfen (nicht-transitiv).

Explorative Analyse (CLI-basiert) 🔍

Verwende CLI-Befehle für Ad-hoc-Abhängigkeitserkundung:

• entry-points - entdeckt Projekt-Einstiegspunkte.
• files - listet Abhängigkeitsbaum-Dateien für einen gegebenen Einstiegspunkt auf.
• resolve - verfolgt Abhängigkeitspfade zwischen Dateien (wer importiert diese Datei).
• imported-by - listet direkte Importeure einer Datei auf.
• circular - listet zirkuläre Abhängigkeitsketten auf.
• duplicated-code - findet kopierte Codeblöcke und JSX-Elemente.
• node-modules - inspiziert used, unused, missing und installed node modules.
• lines-of-code - zählt effektive LOC.
• unresolved - listet Imports auf, die nicht aufgelöst werden konnten, gruppiert nach Datei.
• list-cwd-files - listet alle Quellcode-Dateien im CWD auf
• debug - inspiziert, was rev-dep intern parst, auflöst und entdeckt.

Installation 📦

Vollständige Dokumentation: rev-dep.com/docs/intro

Lokal installieren, um Projekt-Prüfskripte einzurichten``` yarn add -D rev-dep

Ihre Zustimmung zu unserer Datenschutzrichtlinie und den Nutzungsbedingungen wird für die Nutzung unserer Dienste vorausgesetzt.```
npm install -D rev-dep

Ihre Anfrage ist bereit. Bitte senden Sie den zu übersetzenden Markdown-Inhalt (Chunk 5 von 205), und ich werde ihn gemäß den angegebenen Regeln ins Deutsche übersetzen.``` pnpm add -D rev-dep

Erstellen Sie eine Konfigurationsdatei für einen Schnellstart:```
npx rev-dep config init

Global installieren, um es als CLI-Tool zu verwenden:``` yarn global add rev-dep

Ihre Anfrage wird bearbeitet. Bitte warten Sie einen Moment.```
npm install -g rev-dep

| -s | --server | Server URL (default: http://localhost:8080) | | -t | --token | Authentication token | | -o | --output | Output file path | | -f | --format | Output format: json, yaml, table | | -v | --verbose | Enable verbose logging | | -q | --quiet | Suppress non-error output | | -h | --help | Show help message | | -V | --version | Show version information |

Examples

# Basic scan
scanner scan --target example.com

# Scan with custom output
scanner scan --target example.com --output results.json --format json

# Authenticated scan
scanner scan --target example.com --token YOUR_TOKEN