Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

El grafo de topología

Topology graph — representa el IR compilado de la Release seleccionada como un grafo interactivo: contenedores de límite y de subsistema, con cada límite o subsistema declarado dentro de otro dibujado dentro de él, aristas con un estilo según su procedencia, desplazamiento y zoom, clic en un nodo para seleccionarlo y doble clic para abrir su archivo de origen, y clic en una arista para seleccionar la conexión que dibuja.

El grafo de topología de una Release: tres componentes dentro de los recuadros que contienen los nodos que ningún límite ni subsistema declara, aristas desde el componente web hasta su base de datos y su caché, y la leyenda en la parte inferior izquierda.

El título de cada contenedor indica su tipo además de su agrupación, de modo que el recuadro exterior y el interior se distinguen incluso en un workspace que no declara ninguno de los dos — donde de otro modo ambos llevarían el mismo nombre. Una agrupación que nadie declaró, que el compilador crea para los componentes que una Release o un Aggregate enumera en el nivel superior, lleva un título que indica que no se declaró ninguna, y su recuadro se dibuja de forma distinta al de una agrupación declarada — un borde punteado y neutro — para que no se lea como una agrupación con ese nombre; una que hayas declarado tú conserva su nombre sea cual sea, default incluido.

Cada arista lleva una punta de flecha en el extremo hacia el que apunta: una arista va del componente consumidor a su destino, y la punta de flecha se dibuja con el color y el patrón de trazo propios de la arista. El recuadro de un nodo se dimensiona midiendo el texto que dibuja, tanto el nombre del nodo como el componente debajo de él, de modo que ninguno sobrepasa su borde por largo que sea el nombre del componente.

Una leyenda en la parte inferior izquierda nombra cada agrupación por el documento que la declara — un límite por la Release, un subsistema por el Aggregate — y, donde el dibujo tiene uno, el recuadro que contiene los nodos que no están en ninguna, con lo que contiene; indica qué extremo de una arista es su destino; y nombra la barra de color a lo largo del borde inicial de un nodo y cada color que el dibujo le da, junto al valor de component.aggrega.ai/type que ese color representa, exactamente como está escrita la etiqueta, con una fila para los nodos que no llevan esa etiqueta cuando los hay. Indica también lo que esos colores no significan: se asignan cada vez que se dibuja un grafo, por lo que agrupan los nodos por tipo dentro de un grafo, y el mismo color en otro grafo no es el mismo tipo. La leyenda permanece donde está hagas lo que hagas con el dibujo, así que siempre que el dibujo se ajusta al panel — en su primer dibujo y cada vez que solicitas el grafo — se ajusta a la parte del panel situada encima de la leyenda: dentro de todo el ancho del panel y la altura que queda por encima de la leyenda, centrado horizontalmente, de modo que la leyenda no cubre nada del dibujo por muchas filas que tenga. En un panel demasiado bajo para dejar espacio por encima de la leyenda, el dibujo se ajusta al panel completo.

Al seleccionar un nodo se abre un panel que enumera lo que tiene adjunto: para cada adjunto, la Feature y su versión resuelta, el slot que ocupa o que no ocupa ningún slot declarado, la FeatureRecipe que lo realiza, por nombre y versión, cuando el grafo compilado nombra una, su procedencia, las etiquetas que declara y los valores que escribió su autor. Un adjunto escrito en una de las conexiones del componente — bajo features: en una entrada uses, en el Aggregate o en la Release — no está en esa lista: se dibuja en la conexión a la que pertenece, tal como lo registra el grafo compilado, y el panel del nodo indica cuándo sus conexiones llevan alguno.

Al hacer clic en una arista se selecciona la conexión que dibuja y se abre el panel sobre ella, titulado con el componente consumidor y su destino y con el nombre del socket y del alias, con los adjuntos de esa conexión presentados como los de un nodo — para cada uno, la Feature y su versión resuelta, el slot que ocupa, la FeatureRecipe que lo realiza cuando el grafo compilado nombra una, y sus valores — o una frase que indica que no tiene nada adjunto. Seleccionar un nodo anula la selección de una conexión y viceversa; Escape o el botón de cierre del panel anulan cualquiera de las dos, y un redibujado conserva la selección mientras el grafo reconstruido siga dibujando el nodo, o la conexión desde el mismo componente a través del mismo socket con el mismo alias.

Debajo de los adjuntos de un nodo, en May attach, el panel enumera las Features cuya aplicabilidad declarada satisfacen las etiquetas de ese nodo en el grafo de la Release que muestra el panel — las Features declaradas por los documentos del workspace que lee esa Release, todas salvo las de un directorio de catálogo que solo leen otras Releases, y las contenidas en los directorios de catálogo con los que se compila esa Release — cada una nombrada con su tipo y con el archivo del workspace que la declara o con el catálogo configurado desde el que se resolvió. Esa lista es aquello a lo que esas Features declaran aplicarse, no una decisión de que adjuntar una dará un build correcto — y cuando está vacía indica que la aplicabilidad declarada de ninguna Feature coincide con esas etiquetas, lo cual es una afirmación más restringida que la de que no se pueda adjuntar nada. Una solicitud que el servidor de lenguaje no pudo responder lo indica en lugar de la lista, en vez de dejarla en blanco. Una Feature declarada tras un enlace que sale del workspace — un enlace a un directorio externo, o un enlace con nombre de archivo YAML que lleva a un archivo externo — no se ofrece, porque el servidor de lenguaje no lee ninguna entidad a través de un enlace así, aunque el árbol de archivos de tu editor muestre la Feature. Cuando el workspace contiene un enlace así, una línea debajo de la lista, o debajo de la frase que sustituye a una lista vacía, lo indica: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (Las Features alcanzadas a través de este enlace no se ofrecen, porque sale del workspace de Aggrega:) seguido de la ruta del enlace relativa al workspace — o Features reached through these links are not offered, because each leads outside the Aggrega workspace: (Las Features alcanzadas a través de estos enlaces no se ofrecen, porque cada uno sale del workspace de Aggrega:) cuando son varios, primero los enlaces a directorios. Nombra los enlaces que informa el servidor de lenguaje en los términos de la Release que muestra el panel, como hace el panel Catalog en los de la Release seleccionada. Cuando ese informe no se puede leer, la lista se dibuja sin la línea y el motivo se escribe en el canal de salida de Aggrega; una lista que no se pudo generar no lleva ninguna línea.

El grafo de topología con el componente web seleccionado y, a su lado, el panel que indica que no tiene nada adjunto y enumera bajo May attach las Features que se pueden adjuntar, cada una con un control Attach.

Cada fila lleva un control Attach que la confirma: se pregunta al compilador qué documento declara el componente seleccionado y en qué lugar de ese documento corresponde un adjunto así, y la entrada se escribe allí a través del editor — de modo que se suma al historial de deshacer, llega al búfer que estás viendo en lugar de a la última versión guardada en disco, y deja los comentarios y el formato que la rodean tal como los escribiste. No se guarda nada en tu nombre; la edición es un cambio como cualquier otro, y el compilador la vuelve a validar como lo haría tras cualquier edición. El grafo se redibuja al guardar, porque la topología se compila a partir de los documentos tal como están en disco y un adjunto que sigue en el búfer aún no forma parte de ellos. El adjunto recibe el nombre de la Feature, y adjuntar una Feature ya adjunta con ese nombre se rechaza en lugar de escribirse dos veces. Un componente declarado dentro de un subsistema se adjunta con la misma pulsación que uno declarado en el nivel superior, y ambos funcionan por la misma razón: el grafo identifica un componente por su posición en la topología compilada, esa posición no dice qué claves escribió el autor del componente, y por eso la extensión pregunta en lugar de reconstruir — la respuesta nombra el documento y la ruta al bloque dentro de él, y ambos se trasladan a la edición tal como llegaron. Cuando no hay un lugar así que nombrar — un id que el grafo no lleva, un nodo para el que no registra ningún documento, o un componente cuyo propio bloque no se puede nombrar en el documento en que se escribió — lo que muestra el panel es el motivo que dio el compilador, no una redacción propia de esta extensión.

El panel de una conexión seleccionada tiene su propia sección May attach: los slots que declara el socket de esa conexión, en el orden en que el componente los declara, cada uno indicando si es obligatorio, si lo que lo llena maneja material sensible, la entrega que permite, su selector y su descripción, y bajo cada slot las Features que, según responde el language server, pueden llenarlo en esa conexión: aquellas cuya aplicabilidad declarada satisfacen las etiquetas del componente consumidor y cuyas propias etiquetas satisfacen el selector del slot. Donde no se puede llenar ningún slot, el panel explica por qué en los términos del language server —una Feature trazó la conexión, el socket no es uno que el componente declare, o el socket no declara slots— y no ofrece nada que adjuntar. Pulsar Attach bajo un slot escribe la Feature con el nombre del slot, una entrada <slot>: cuyo type: nombra la Feature, en la entrada de esa conexión del documento que trazó la conexión: la Release para una conexión que trazó la Release y, en otro caso, el Aggregate. Una conexión seleccionada desde su entrada en un documento, mediante Aggrega: Attach a Feature to the connection at the cursor, se escribe en cambio en ese documento —la Release, para la entrada propia de la Release de una conexión que trazó el Aggregate— y la línea del panel bajo May attach indica entonces que la Feature se escribe en la entrada de esa conexión del documento en el que se ejecutó el comando. Se pregunta al compilador dónde va esa entrada en ese documento, cualquier parte de la ruta que el documento aún no contenga se escribe con ella, y la edición llega al editor como la de un nodo, sin guardar. Un slot que el grafo ya muestra lleno en esa conexión se rechaza antes de preguntar nada, y un rechazo del compilador se muestra con sus propias palabras.

Un valor que el compilador notifica como sensible lo retiene el language server en el grafo que envía, y lo vuelve a retener la extensión antes de que el grafo llegue siquiera a la vista, de modo que no está en la vista para mostrarse: el panel nombra el campo y explica por qué se retiene, y un adjunto cuya marca de sensibilidad tiene una forma que el panel no reconoce retiene todos los valores en lugar de adivinar. Un adjunto trazado en una conexión se retiene exactamente con la misma regla que uno trazado en un nodo, bajo el mismo ajuste. aggrega.graph.showSensitiveValues desactiva la retención para un autor que necesita releer lo que escribió: solo mientras está activado la solicitud del grafo pide esos valores al language server, y la página de ajustes indica qué se muestra entonces.

Los nodos se disponen en el orden en que se ponen en marcha las oleadas de la Release, de modo que un boundary que declara un syncWave: aparece antes que los boundaries que esperan por él. Al pasar el puntero sobre un nodo se muestran su componente y su versión resuelta, sus etiquetas, su oleada declarada y los metadatos propios de la entidad del catálogo —licencia, repositorio, página de inicio, palabras clave y mantenedores—, mostrando solo los campos que la entidad declara realmente.

Un grafo abierto se vuelve a renderizar cada vez que se guarda un documento escrito en el espacio de trabajo, de modo que sigue tus ediciones sin tener que volver a abrirlo; se redibuja al guardar y no con cada pulsación porque la topología se compila a partir de lo que hay en disco. También se redibuja cuando se escribe el lockfile de la Release seleccionada —con Aggrega: Pull, con una compilación con Auto pull o con aggrega pull en un terminal—, porque el grafo está fijado a ese lockfile, y también cuando el language server vuelve a responder, de modo que un grafo que quedó abierto durante un reinicio se recupera solo.

Un redibujado que no pediste deja tu vista donde la pusiste: se conservan el desplazamiento y el zoom que tenías, difiera o no la topología reconstruida, de modo que un nodo que la disposición reconstruida coloca donde estaba permanece bajo la misma parte del panel, y uno que coloca en otro lugar —un componente añadido puede desplazar los que lo rodean— se mueve dentro de la vista que conservaste en lugar de llevarse la vista consigo. Eso incluye un redibujado que llega mientras el grafo está detrás de otra pestaña, a la que vuelves tal como la dejaste.

Aggrega: Show topology graph vuelve a ajustar el dibujo al panel, que es la manera de volver a la forma completa después de hacer zoom en una parte. Una topología grande se ajusta entera en lugar de recortarse, así que una grande llega pequeña: ves cómo está compuesta y llegas a los nombres acercando el zoom. Donde dos o más agrupaciones contenidas en una caja quedarían más altas que anchas, se dibujan una junto a otra en lugar de apiladas en una columna, de modo que una topología grande aprovecha el ancho del panel y su primer ajuste la dibuja más grande de lo que permitiría una sola columna.

Una reconstrucción que el compilador rechaza conserva el dibujo que tenías en lugar de dejarlo en blanco —la topología sigue mereciendo la lectura y sigue estando donde trabajabas— y lo atenúa, para que un dibujo que ya no está al día no se confunda con uno que sí lo está; el aviso que hay encima incluye el motivo del propio compilador. El dibujo recupera toda su intensidad en cuanto se construye uno. La disposición se calcula en la vista; el compilador entrega topología, nunca coordenadas.