Il grafo di topologia
Topology graph — mostra l’IR compilato della Release selezionata come grafo interattivo: contenitori di confine e di sottosistema, con ogni confine o sottosistema dichiarato dentro un altro disegnato al suo interno, archi con uno stile che ne indica la provenienza, panoramica e zoom, clic su un nodo per selezionarlo e doppio clic per aprirne il file sorgente, e clic su un arco per selezionare la connessione che disegna.

Il titolo di ogni contenitore ne indica il tipo oltre al raggruppamento, così il riquadro esterno e quello interno si distinguono anche in un workspace che non dichiara nessuno dei due — dove altrimenti avrebbero lo stesso nome. Un raggruppamento che nessuno ha dichiarato, che il compilatore crea per i componenti che una Release o un Aggregate elenca al livello superiore, ha un titolo che indica che non ne è stato dichiarato nessuno, e il suo riquadro è disegnato in modo diverso da quello di un raggruppamento dichiarato — un bordo puntinato e neutro — così da non leggersi come un raggruppamento con quel nome; uno che hai dichiarato tu mantiene il suo nome, qualunque esso sia, default compreso.
Ogni arco porta una punta di freccia all’estremità verso cui punta: un arco va dal componente consumatore al suo target, e la punta di freccia è disegnata con il colore e il tratteggio dell’arco stesso. Il riquadro di un nodo è dimensionato misurando il testo che disegna, sia il nome del nodo sia il componente sotto di esso, così nessuno dei due supera il bordo, per quanto lungo sia il nome del componente.
Una legenda in basso a sinistra indica ogni raggruppamento con il documento che lo dichiara — un confine con la Release, un sottosistema con l’Aggregate — e, dove il disegno ne ha uno, il riquadro che contiene i nodi che non stanno in nessuno, con ciò che contiene; indica quale estremità di un arco è il suo target; e indica la barra colorata lungo il bordo iniziale di un nodo e ogni colore che il disegno le assegna, accanto al valore di component.aggrega.ai/type che quel colore rappresenta, esattamente come è scritta l’etichetta, con una riga per i nodi privi di tale etichetta dove ce ne sono. Indica anche ciò che quei colori non significano: sono assegnati a ogni disegno di un grafo, quindi raggruppano i nodi per tipo all’interno di un grafo, e lo stesso colore in un altro grafo non è lo stesso tipo. La legenda resta dov’è qualunque cosa tu faccia al disegno, quindi ogni volta che il disegno viene adattato al pannello — al primo disegno, e ogni volta che richiedi il grafo — viene adattato alla parte del pannello sopra la legenda: entro l’intera larghezza del pannello e l’altezza rimasta sopra la legenda, centrato orizzontalmente, così la legenda non copre alcuna parte del disegno, per quante righe abbia. In un pannello troppo basso per lasciare spazio sopra la legenda, il disegno viene adattato all’intero pannello.
Selezionare un nodo apre un pannello che elenca ciò che vi è associato: per ogni associazione, la Feature e la versione risolta, lo slot che occupa o il fatto che non occupa alcuno slot dichiarato, la FeatureRecipe che la realizza, con nome e versione, quando il grafo compilato ne indica una, la sua provenienza, le etichette che dichiara e i valori scritti dal suo autore. Un’associazione scritta su una delle connessioni del componente — sotto features: in una voce uses, nell’Aggregate o nella Release — non è in quell’elenco: è disegnata sulla connessione a cui appartiene, come la registra il grafo compilato, e il pannello del nodo indica quando le sue connessioni ne portano.
Fare clic su un arco seleziona la connessione che disegna e apre il pannello su di essa, intitolato con il componente consumatore e il suo target e con l’indicazione del socket e dell’alias, con le associazioni di quella connessione presentate come quelle di un nodo — per ognuna la Feature e la versione risolta, lo slot che occupa, la FeatureRecipe che la realizza quando il grafo compilato ne indica una, e i suoi valori — oppure una frase che dice che non vi è associato nulla. Selezionare un nodo annulla la selezione di una connessione e viceversa; Escape o il pulsante di chiusura del pannello annullano l’una o l’altra, e un nuovo disegno mantiene la selezione finché il grafo ricostruito disegna ancora il nodo, oppure la connessione dallo stesso componente attraverso lo stesso socket con lo stesso alias.
Sotto le associazioni di un nodo, in May attach, il pannello elenca le Features la cui applicabilità dichiarata è soddisfatta dalle etichette di quel nodo nel grafo della Release mostrata dal pannello — le Features dichiarate dai documenti del workspace letti da quella Release, tutte tranne quelle in una directory di catalogo letta solo da altre Releases, e quelle contenute nelle directory di catalogo su cui quella Release viene compilata — ciascuna indicata con il suo tipo e con il file del workspace che la dichiara o con il catalogo configurato da cui è stata risolta. Quell’elenco è ciò a cui quelle Features dichiarano di applicarsi, non la decisione che associarne una produrrà una build riuscita — e quando è vuoto dice che l’applicabilità dichiarata di nessuna Feature corrisponde a quelle etichette, un’affermazione più ristretta del fatto che non si possa associare nulla. Una richiesta a cui il language server non ha potuto rispondere lo dice al posto dell’elenco, invece di lasciarlo vuoto. Una Feature dichiarata dietro un collegamento che porta fuori dal workspace — un collegamento a una directory esterna, o un collegamento con il nome di un file YAML che porta a un file esterno — non viene proposta, perché il language server non legge alcuna entità attraverso un collegamento simile, anche se l’albero dei file del tuo editor mostra la Feature. Dove il workspace contiene un collegamento simile, una riga sotto l’elenco, o sotto la frase che sostituisce un elenco vuoto, lo segnala: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (Le Features raggiunte tramite questo collegamento non vengono proposte, perché porta fuori dal workspace Aggrega:) seguito dal percorso del collegamento relativo al workspace — oppure Features reached through these links are not offered, because each leads outside the Aggrega workspace: (Le Features raggiunte tramite questi collegamenti non vengono proposte, perché ognuno porta fuori dal workspace Aggrega:) per più collegamenti, prima quelli verso directory. Indica i collegamenti che il language server riporta nei termini della Release mostrata dal pannello, come fa il pannello Catalog nei termini della Release selezionata. Dove quel resoconto non può essere letto, l’elenco viene disegnato senza la riga e il motivo viene scritto nel canale di output Aggrega; un elenco che non è stato possibile produrre non ha alcuna riga.

Ogni riga ha un controllo Attach che la applica: al compilatore viene chiesto quale documento dichiara il componente selezionato e in quale punto di quel documento va collocata un’associazione simile, e la voce viene scritta lì tramite l’editor — così entra nella cronologia degli annullamenti, finisce nel buffer che stai guardando anziché nell’ultima versione salvata su disco, e lascia i commenti e la formattazione intorno come li hai scritti. Nulla viene salvato al posto tuo; la modifica è una modifica come le altre, e il compilatore la riconvalida come farebbe dopo qualsiasi modifica. Il grafo si ridisegna quando salvi, perché la topologia è compilata dai documenti così come sono su disco e un’associazione ancora nel buffer non ne fa ancora parte. L’associazione prende il nome della Feature, e associare una Feature già associata con quel nome viene rifiutato anziché scritto due volte. Un componente dichiarato dentro un sottosistema si associa con la stessa pressione di uno dichiarato al livello superiore, ed entrambi funzionano per lo stesso motivo: il grafo identifica un componente in base alla sua posizione nella topologia compilata, quella posizione non dice quali chiavi ha scritto l’autore del componente, e quindi l’estensione chiede invece di ricostruire — la risposta indica il documento e il percorso del blocco al suo interno, ed entrambi sono riportati nella modifica così come sono arrivati. Dove non c’è un punto simile da indicare — un id che il grafo non porta, un nodo per cui non registra alcun documento, o un componente il cui blocco non può essere indicato nel documento in cui è stato scritto — ciò che il pannello mostra è il motivo fornito dal compilatore, non una formulazione propria di questa estensione.
Il pannello di una connessione selezionata ha una propria sezione May attach: gli slot che il socket di quella connessione dichiara, nell’ordine in cui il componente li dichiara, ciascuno con l’indicazione se è obbligatorio, se ciò che lo riempie gestisce materiale sensibile, la modalità di consegna che consente, il suo selettore e la sua descrizione, e sotto ogni slot le Features che secondo la risposta del language server possono riempirlo su quella connessione — quelle la cui applicabilità dichiarata è soddisfatta dalle etichette del componente consumatore e le cui etichette soddisfano il selettore dello slot. Dove nessuno slot può essere riempito, il pannello spiega il motivo nei termini del language server — una Feature ha tracciato la connessione, il socket non è uno di quelli che il componente dichiara, oppure il socket non dichiara slot — e non offre nulla da collegare. Premere Attach sotto uno slot scrive la Feature con il nome dello slot, una voce <slot>: il cui type: nomina la Feature, nella voce di quella connessione nel documento che ha tracciato la connessione: la Release per una connessione tracciata dalla Release, altrimenti l’Aggregate. Una connessione selezionata dalla sua voce in un documento, tramite Aggrega: Attach a Feature to the connection at the cursor, viene invece scritta in quel documento — la Release, per la voce propria della Release relativa a una connessione tracciata dall’Aggregate — e la riga del pannello sotto May attach dice allora che la Feature viene scritta nella voce di quella connessione nel documento in cui è stato eseguito il comando. Al compilatore si chiede dove va quella voce in quel documento, qualsiasi parte del percorso che il documento non contiene ancora viene scritta insieme a essa, e la modifica arriva nell’editor come quella di un nodo, non salvata. Uno slot che il grafo mostra già riempito su quella connessione viene rifiutato prima di chiedere qualsiasi cosa, e un rifiuto del compilatore viene mostrato con le sue stesse parole.
Un valore che il compilatore segnala come sensibile viene trattenuto dal language server nel grafo che invia, e trattenuto di nuovo dall’estensione prima ancora che il grafo venga passato alla vista, così non è nella vista per essere mostrato — il pannello nomina il campo e spiega perché è trattenuto, e un collegamento il cui contrassegno di sensibilità ha una forma che il pannello non riconosce trattiene ogni valore invece di tirare a indovinare. Un collegamento tracciato su una connessione viene trattenuto esattamente con la stessa regola di uno tracciato su un nodo, con la stessa impostazione. aggrega.graph.showSensitiveValues disattiva il trattenimento per un autore che ha bisogno di rileggere ciò che ha scritto: solo mentre è attiva la richiesta del grafo chiede quei valori al language server, e la pagina delle impostazioni dice che cosa viene così mostrato.
I nodi sono disposti nell’ordine in cui vengono avviate le ondate della Release, così un boundary che dichiara un syncWave: compare prima dei boundary che lo attendono. Passando il puntatore su un nodo se ne vedono il componente e la versione risolta, le etichette, l’ondata dichiarata e i metadati propri dell’entità del catalogo — licenza, repository, home, parole chiave e manutentori — mostrando solo i campi che l’entità dichiara effettivamente.
Un grafo aperto si ridisegna ogni volta che un documento scritto nel workspace viene salvato, così segue le tue modifiche senza essere riaperto; si ridisegna al salvataggio e non a ogni tasto premuto perché la topologia è compilata da ciò che si trova su disco. Si ridisegna anche quando viene scritto il lockfile della Release selezionata — da Aggrega: Pull, da una build con Auto pull o da aggrega pull in un terminale — perché il grafo è vincolato a quel lockfile, e si ridisegna inoltre quando il language server torna a rispondere, così un grafo lasciato aperto durante un riavvio si ripristina da solo.
Un ridisegno che non hai chiesto lascia la vista dove l’hai messa: la panoramica e lo zoom che avevi vengono mantenuti, che la topologia ricostruita sia diversa o no, così un nodo che il layout ricostruito mette dov’era resta sotto la stessa parte del pannello, e uno che mette altrove — un componente aggiunto può spostare quelli intorno — si sposta all’interno della vista che hai mantenuto invece di trascinare la vista con sé. Questo vale anche per un ridisegno che avviene mentre il grafo è dietro un’altra scheda, che ritrovi come l’avevi lasciata.
Aggrega: Show topology graph adatta di nuovo il disegno al pannello, ed è il modo per tornare alla forma intera dopo aver fatto zoom su una parte. Una topologia grande viene adattata per intero invece di essere ritagliata, quindi una molto grande arriva piccola: vedi come è composta e raggiungi i nomi facendo zoom. Dove due o più raggruppamenti contenuti in un riquadro si disporrebbero più alti che larghi, vengono disegnati uno accanto all’altro invece di essere impilati in una colonna, così una topologia grande usa la larghezza del pannello e il suo primo adattamento la disegna più grande di quanto permetterebbe una sola colonna.
Una ricostruzione che il compilatore rifiuta mantiene il disegno che avevi invece di svuotarlo — la topologia merita ancora di essere letta ed è ancora dove stavi lavorando — e lo attenua, così un disegno non più attuale non viene scambiato per uno che lo è; l’avviso sopra di esso riporta il motivo dato dal compilatore stesso. Il disegno torna a piena intensità non appena ne viene costruito uno. Il layout è calcolato nella vista; il compilatore fornisce la topologia, mai le coordinate.