Architektur-Prüfung

Der Code-Index erfasst Dateien, Symbole und ihre Beziehungen. Architekturansichten ordnen diese Belege an, damit Sie die Struktur eines Repositorys untersuchen können. Systeme erfasst außerdem die größere Struktur von Repositorys und Ressourcen.

Die Architektur eines Repositorys lesen

Öffnen Sie ein repositorygestütztes System in Systeme. Unter Architektur, wählen Sie Code-Komponenten, Klassen oder Aufrufablauf. Der System -Tab zeigt die Systemstruktur. Daten und Externe Abhängigkeiten bieten andere Lesarten des Repositorys.

Wählen Sie eine Darstellung für Lesarten, die einen Graphen enthalten:

• Diagramm: Erkunden Sie die erfassten Knoten und Beziehungen.
• UML: Klassenschreibweise, verfügbar für Klassen- und Entitätsbeziehungs-Lesarten.
• Fokussierter Ablauf: Wählen Sie einen Knoten und folgen Sie seinen eingehenden und ausgehenden Beziehungen. Wählen Sie einen Nachbarn, um die Erkundung fortzusetzen.
• Abhängigkeitsmatrix: Zeilen verweisen auf Spalten. Eine Zahl zählt erfasste Beziehungen; wählen Sie sie, um ihre Typen zu lesen. Filtern Sie nach Knotennamen, um die Matrix einzugrenzen.

Pfeile zeigen die indexierte Richtung, nicht Laufzeitverkehr oder Ausführungsreihenfolge. Die Ablaufzeichnung zeigt bis zu zehn Nachbarn auf jeder Seite; die Matrix zeigt bis zu 24 übereinstimmende Knoten. Eine leere Zelle bedeutet keine Beziehung in dieser Lesart. Wenn der Index eine Lesart nicht unterstützen kann, erklärt die Seite, warum.

Lokale Komponenten inspizieren

Nach dem Einrichten des lokalen Agenten und der Indexierung eines Repositorys verwenden Sie dessen Bezeichner aus sourceant repos:

sourceant architecture acme/billing
sourceant architecture acme/billing --depth 2
sourceant architecture acme/billing --depth 2 --tests

Komponenten folgen Verzeichnisgrenzen. Die Tiefe reicht von 1 bis 4 und ist standardmäßig 1. Tests werden ausgeschlossen, sofern Sie nicht --testsübergeben. Der Befehl liest den aktuellen Index, ohne Modellaufrufe durchzuführen oder einen neuen Indexierungslauf zu starten.

Mit einer Baseline vergleichen

Exportieren Sie die aktuelle Architektur, bevor Sie den Code ändern:

sourceant architecture acme/billing --depth 2 --json > architecture.json

Nachdem das Repository erneut indexiert wurde, vergleichen Sie es mit dem gespeicherten Snapshot:

sourceant architecture acme/billing --baseline architecture.json

Das Ergebnis meldet hinzugefügte, entfernte und geänderte Komponenten und Beziehungen. Vergleiche verwenden Repository, Tiefe und Testauswahl der Baseline, übergeben Sie daher nicht --depth oder --tests mit --baseline.

Dies vergleicht indexierte Snapshots, nicht Git-Commits. Unvollständige Snapshots werden abgelehnt, da fehlende Belege nicht feststellen können, dass eine Komponente oder Beziehung entfernt wurde. Aktualisieren Sie den Index über den Zeitplan des Agenten oder die Seite Repositories, bevor Sie vergleichen.