Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Der Topologiegraph

Topology graph — stellt die kompilierte IR des ausgewählten Release als interaktiven Graphen dar: Container für Grenzen und Subsysteme, wobei jede Grenze und jedes Subsystem, die innerhalb einer anderen Grenze oder eines anderen Subsystems deklariert sind, darin gezeichnet werden, nach Herkunft gestaltete Kanten, Schwenken und Zoomen, Klicken auf einen Knoten, um ihn auszuwählen, und Doppelklicken, um seine Quelldatei zu öffnen, sowie Klicken auf eine Kante, um die Verbindung auszuwählen, die sie darstellt.

Der Topologiegraph eines Release: drei Komponenten in den Kästen, die die Knoten enthalten, die keine Grenze und kein Subsystem deklariert, Kanten von der Web-Komponente zu ihrer Datenbank und ihrem Cache, und die Legende unten links.

Der Titel jedes Containers nennt neben seiner Gruppierung auch seine Art, sodass sich der äußere und der innere Kasten auch in einem Workspace unterscheiden lassen, der keines von beiden deklariert — wo beide sonst denselben Namen tragen würden. Eine Gruppierung, die niemand deklariert hat und die der Compiler für Komponenten anlegt, die ein Release oder ein Aggregate auf oberster Ebene aufführt, erhält einen Titel, der angibt, dass keine deklariert ist, und ihr Kasten wird anders gezeichnet als der einer deklarierten Gruppierung — mit einem gepunkteten, neutralen Rahmen —, damit sie nicht als Gruppierung dieses Namens gelesen wird; eine von Ihnen deklarierte Gruppierung behält ihren Namen, wie auch immer er lautet, default eingeschlossen.

Jede Kante trägt eine Pfeilspitze an dem Ende, auf das sie zeigt: Eine Kante verläuft von der konsumierenden Komponente zu ihrem Ziel, und die Pfeilspitze wird in der Farbe und Strichart der Kante selbst gezeichnet. Der Kasten eines Knotens wird anhand des Textes bemessen, den er darstellt, also sowohl des Knotennamens als auch der Komponente darunter, sodass keiner von beiden über den Rahmen hinausragt, wie lang der Komponentenname auch ist.

Eine Legende unten links benennt jede Gruppierung nach dem Dokument, das sie deklariert — eine Grenze nach dem Release, ein Subsystem nach dem Aggregate — und, wo die Darstellung einen solchen hat, den Kasten mit den Knoten, die in keiner Gruppierung liegen, samt seinem Inhalt; sie gibt an, welches Ende einer Kante deren Ziel ist; und sie benennt den Farbbalken an der vorderen Kante eines Knotens und jede Farbe, die die Darstellung ihm gibt, neben dem Wert von component.aggrega.ai/type, für den diese Farbe steht, genau so, wie das Label geschrieben ist, mit einer Zeile für Knoten ohne ein solches Label, sofern es welche gibt. Sie sagt auch, was diese Farben nicht bedeuten: Sie werden bei jedem Zeichnen eines Graphen zugewiesen, gruppieren Knoten also innerhalb eines Graphen nach Typ, und dieselbe Farbe in einem anderen Graphen steht nicht für denselben Typ. Die Legende bleibt an ihrem Platz, was auch immer Sie mit der Darstellung tun; wann immer die Darstellung also an das Panel angepasst wird — beim ersten Zeichnen und jedes Mal, wenn Sie den Graphen anfordern —, wird sie an den Teil des Panels oberhalb der Legende angepasst: innerhalb der gesamten Breite des Panels und der oberhalb der Legende verbleibenden Höhe, horizontal zentriert, sodass die Legende nichts von der Darstellung verdeckt, wie viele Zeilen sie auch enthält. In einem Panel, das zu niedrig ist, um oberhalb der Legende Platz zu lassen, wird die Darstellung an das gesamte Panel angepasst.

Wenn Sie einen Knoten auswählen, öffnet sich ein Panel, das auflistet, was an ihn angehängt ist: für jeden Anhang das Feature und dessen aufgelöste Version, den Slot, den er belegt, oder dass er keinen deklarierten Slot belegt, das FeatureRecipe, das ihn realisiert, mit Name und Version, sofern der kompilierte Graph eines nennt, seine Herkunft, die Labels, die er deklariert, und die Werte, die sein Autor geschrieben hat. Ein Anhang, der an einer der Verbindungen der Komponente geschrieben ist — unter features: in einem uses-Eintrag, im Aggregate oder im Release —, steht nicht in dieser Liste: Er wird an der Verbindung gezeichnet, zu der er gehört, so wie der kompilierte Graph ihn erfasst, und das Panel des Knotens gibt an, wenn seine Verbindungen Anhänge tragen.

Ein Klick auf eine Kante wählt die Verbindung aus, die sie darstellt, und öffnet das Panel dazu, betitelt mit der konsumierenden Komponente und ihrem Ziel und mit Angabe von Socket und Alias, wobei die Anhänge dieser Verbindung wie die eines Knotens dargestellt werden — für jeden das Feature und dessen aufgelöste Version, der belegte Slot, das FeatureRecipe, das ihn realisiert, sofern der kompilierte Graph eines nennt, und seine Werte — oder ein Satz, der angibt, dass nichts angehängt ist. Die Auswahl eines Knotens hebt die Auswahl einer Verbindung auf und umgekehrt; Escape oder die Schließen-Schaltfläche des Panels hebt beide auf, und ein Neuzeichnen behält die Auswahl bei, solange der neu aufgebaute Graph den Knoten noch darstellt bzw. die Verbindung von derselben Komponente über denselben Socket unter demselben Alias.

Unterhalb der Anhänge eines Knotens listet das Panel unter May attach die Features auf, deren deklarierte Anwendbarkeit die Labels dieses Knotens im Graphen des im Panel gezeigten Release erfüllen — die Features, die von den Dokumenten im Workspace deklariert werden, die dieses Release liest, alle außer denen in einem Katalogverzeichnis, das nur andere Releases lesen, sowie die in den Katalogverzeichnissen, gegen die dieses Release gebaut wird —, jedes mit seiner Art und entweder der Workspace-Datei, die es deklariert, oder dem konfigurierten Katalog, aus dem es aufgelöst wurde. Diese Liste gibt an, worauf sich diese Features laut ihrer Deklaration anwenden lassen, nicht die Entscheidung, dass ein Build mit einem angehängten Feature gelingt — und wenn sie leer ist, besagt sie, dass die deklarierte Anwendbarkeit keines Features zu diesen Labels passt, was eine engere Aussage ist, als dass sich nichts anhängen lässt. Eine Anfrage, die der Language Server nicht beantworten konnte, meldet dies anstelle der Liste, statt sie leer zu lassen. Ein Feature, das hinter einem Link deklariert ist, der aus dem Workspace hinausführt — einem Link auf ein Verzeichnis außerhalb oder einem wie eine YAML-Datei benannten Link, der auf eine Datei außerhalb führt —, wird nicht angeboten, weil der Language Server keine Entität über einen solchen Link liest, auch wenn der Dateibaum Ihres Editors das Feature anzeigt. Wo der Workspace einen solchen Link enthält, weist eine Zeile unter der Liste oder unter dem Satz, der an die Stelle einer leeren Liste tritt, darauf hin: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (Über diesen Link erreichte Features werden nicht angeboten, weil er aus dem Aggrega-Workspace hinausführt:) gefolgt vom Pfad des Links relativ zum Workspace — oder Features reached through these links are not offered, because each leads outside the Aggrega workspace: (Über diese Links erreichte Features werden nicht angeboten, weil jeder aus dem Aggrega-Workspace hinausführt:) bei mehreren, die Links auf Verzeichnisse zuerst. Sie nennt die Links, die der Language Server meldet, bezogen auf das im Panel gezeigte Release, so wie es das Catalog-Panel bezogen auf das ausgewählte Release tut. Wo diese Meldung nicht gelesen werden kann, wird die Liste ohne die Zeile dargestellt und der Grund in den Aggrega-Ausgabekanal geschrieben; eine Liste, die nicht erzeugt werden konnte, trägt keine Zeile.

Der Topologiegraph mit ausgewählter Web-Komponente und daneben das Panel, das angibt, dass nichts an sie angehängt ist, und unter May attach die Features auflistet, die angehängt werden können, jedes mit einem Attach-Steuerelement.

Jede Zeile trägt ein Attach-Steuerelement, das sie übernimmt: Der Compiler wird gefragt, welches Dokument die ausgewählte Komponente deklariert und wo innerhalb dieses Dokuments ein solcher Anhang hingehört, und der Eintrag wird dort über den Editor geschrieben — so wird er Teil des Rückgängig-Verlaufs, landet im Puffer, den Sie gerade sehen, statt in der zuletzt auf der Festplatte gespeicherten Version, und lässt die Kommentare und die Formatierung darum herum so, wie Sie sie geschrieben haben. Nichts wird in Ihrem Namen gespeichert; die Bearbeitung ist eine Änderung wie jede andere, und der Compiler validiert sie erneut, wie er es nach jeder Bearbeitung tun würde. Der Graph wird beim Speichern neu gezeichnet, weil die Topologie aus den Dokumenten in ihrem Zustand auf der Festplatte kompiliert wird und ein Anhang, der noch im Puffer steht, noch nicht dazugehört. Der Anhang wird nach dem Feature benannt, und das Anhängen eines Features, das unter diesem Namen bereits angehängt ist, wird abgelehnt, statt doppelt geschrieben zu werden. Eine Komponente, die in einem Subsystem deklariert ist, wird mit demselben Klick angehängt wie eine auf oberster Ebene deklarierte, und beides funktioniert aus demselben Grund: Der Graph identifiziert eine Komponente über ihre Position in der kompilierten Topologie, diese Position sagt nicht, welche Schlüssel der Autor der Komponente geschrieben hat, und daher fragt die Erweiterung nach, statt zu rekonstruieren — die Antwort nennt das Dokument und den Pfad zum Block darin, und beides wird so, wie es angekommen ist, in die Bearbeitung übernommen. Wo es keine solche Stelle zu benennen gibt — eine ID, die der Graph nicht trägt, ein Knoten, für den er kein Dokument erfasst, oder eine Komponente, deren eigener Block in dem Dokument, in dem sie verfasst wurde, nicht benannt werden kann —, zeigt das Panel den vom Compiler angegebenen Grund, nicht eine eigene Formulierung dieser Erweiterung.

Das Panel einer ausgewählten Verbindung hat einen eigenen Abschnitt May attach: die Slots, die der Socket dieser Verbindung deklariert, in der Reihenfolge, in der die Komponente sie deklariert, jeweils mit der Angabe, ob er erforderlich ist, ob das, was ihn füllt, sensibles Material verarbeitet, welche Übergabe er zulässt, seinem Selektor und seiner Beschreibung, und unter jedem Slot die Features, die ihn laut Antwort des Language Servers auf dieser Verbindung füllen dürfen – diejenigen, deren deklarierte Anwendbarkeit die Labels der konsumierenden Komponente erfüllen und deren eigene Labels den Selektor des Slots erfüllen. Wo kein Slot gefüllt werden darf, sagt das Panel in den Begriffen des Language Servers, warum – ein Feature hat die Verbindung gezogen, der Socket ist keiner, den die Komponente deklariert, oder der Socket deklariert keine Slots – und bietet nichts zum Anhängen an. Ein Klick auf Attach unter einem Slot schreibt das Feature unter dem Namen des Slots, einen <slot>:-Eintrag, dessen type: das Feature nennt, in den Eintrag dieser Verbindung in dem Dokument, das die Verbindung gezogen hat: das Release bei einer Verbindung, die das Release gezogen hat, sonst das Aggregate. Eine Verbindung, die über ihren Eintrag in einem Dokument mit Aggrega: Attach a Feature to the connection at the cursor ausgewählt wurde, wird stattdessen in dieses Dokument geschrieben – das Release, beim eigenen Eintrag des Release für eine Verbindung, die das Aggregate gezogen hat –, und die Zeile des Panels unter May attach sagt dann, dass das Feature in den Eintrag dieser Verbindung in dem Dokument geschrieben wird, in dem der Befehl ausgeführt wurde. Der Compiler wird gefragt, wohin dieser Eintrag in diesem Dokument gehört, jeder Teil des Pfads, den das Dokument noch nicht enthält, wird mitgeschrieben, und die Änderung landet wie die eines Knotens ungespeichert im Editor. Ein Slot, den der Graph auf dieser Verbindung bereits als gefüllt zeigt, wird abgelehnt, bevor etwas gefragt wird, und eine Ablehnung des Compilers wird in dessen eigenen Worten angezeigt.

Einen Wert, den der Compiler als sensibel meldet, hält der Language Server aus dem Graphen zurück, den er sendet, und die Erweiterung hält ihn erneut zurück, bevor der Graph überhaupt an die Ansicht übergeben wird, sodass er nicht in der Ansicht ist, um angezeigt zu werden – das Panel nennt das Feld und sagt, warum es zurückgehalten wird, und eine Anhängung, deren Sensibilitätsmarkierung eine Form hat, die das Panel nicht erkennt, hält jeden Wert zurück, statt zu raten. Eine an einer Verbindung gezeichnete Anhängung wird nach genau derselben Regel zurückgehalten wie eine an einem Knoten gezeichnete, unter derselben Einstellung. aggrega.graph.showSensitiveValues schaltet das Zurückhalten für Autorinnen und Autoren ab, die nachlesen müssen, was sie geschrieben haben: Nur solange die Einstellung aktiviert ist, fragt die Graph-Anfrage den Language Server nach diesen Werten, und die Einstellungsseite sagt, was dann angezeigt wird.

Knoten werden in der Reihenfolge angeordnet, in der die Wellen des Release hochgefahren werden, sodass eine Boundary, die ein syncWave: deklariert, vor den Boundaries erscheint, die auf sie warten. Wenn Sie mit dem Mauszeiger über einen Knoten fahren, werden seine Komponente und deren aufgelöste Version, seine Labels, seine deklarierte Welle und die eigenen Metadaten der Katalogentität genannt – Lizenz, Repository, Homepage, Schlüsselwörter und Maintainer –, wobei nur die Felder gezeigt werden, die die Entität tatsächlich deklariert.

Ein geöffneter Graph wird neu gerendert, sobald ein verfasstes Dokument im Workspace gespeichert wird, sodass er Ihren Änderungen folgt, ohne neu geöffnet zu werden; er wird beim Speichern statt bei jedem Tastendruck neu gezeichnet, weil die Topologie aus dem kompiliert wird, was auf dem Datenträger liegt. Er wird auch neu gezeichnet, wenn die Lockfile des ausgewählten Release geschrieben wird – durch Aggrega: Pull, durch einen Build mit Auto pull oder durch aggrega pull in einem Terminal –, weil der Graph gegen diese Lockfile festgelegt ist, und ebenso, wenn der Language Server wieder antworten kann, sodass sich ein über einen Neustart hinweg geöffneter Graph von selbst erholt.

Ein Neuzeichnen, das Sie nicht angefordert haben, lässt Ihre Ansicht dort, wo Sie sie hingelegt haben: Verschiebung und Zoom bleiben erhalten, ob sich die neu aufgebaute Topologie unterscheidet oder nicht, sodass ein Knoten, den das neu aufgebaute Layout dorthin setzt, wo er war, unter demselben Teil des Panels bleibt, und einer, den es anderswohin setzt – eine hinzugefügte Komponente kann die umliegenden verschieben –, sich innerhalb der beibehaltenen Ansicht bewegt, statt die Ansicht mitzunehmen. Das gilt auch für ein Neuzeichnen, das eintrifft, während der Graph hinter einem anderen Tab liegt; Sie finden ihn so vor, wie Sie ihn verlassen haben.

Aggrega: Show topology graph passt die Zeichnung erneut an das Panel an; so kommen Sie nach dem Hineinzoomen in einen Teil wieder zur ganzen Form zurück. Eine große Topologie wird als Ganzes eingepasst statt beschnitten, sodass eine große klein ankommt: Sie sehen, wie sie aufgebaut ist, und erreichen die Namen durch Hineinzoomen. Wo zwei oder mehr Gruppierungen in einem Kasten höher als breit angeordnet würden, werden sie nebeneinander gezeichnet statt in einer Spalte gestapelt, sodass eine große Topologie die Breite des Panels nutzt und ihre erste Einpassung sie größer zeichnet, als es eine einzelne Spalte erlauben würde.

Ein Neuaufbau, den der Compiler ablehnt, behält die bisherige Zeichnung bei, statt sie zu leeren – die Topologie ist weiterhin lesenswert und weiterhin dort, wo Sie gearbeitet haben –, und blendet sie ab, damit eine nicht mehr aktuelle Zeichnung nicht für eine aktuelle gehalten wird; der Hinweis darüber enthält die Begründung des Compilers selbst. Die Zeichnung erhält ihre volle Deckkraft zurück, sobald eine neue aufgebaut ist. Das Layout wird in der Ansicht berechnet; der Compiler liefert Topologie, niemals Koordinaten.