Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

O grafo de topologia

Topology graph — renderiza a IR compilada da Release selecionada como um grafo interativo: contêineres de limite e de subsistema, com cada limite ou subsistema declarado dentro de outro desenhado dentro dele, arestas estilizadas conforme a procedência, panorâmica e zoom, clique em um nó para selecioná-lo e clique duplo para abrir seu arquivo de origem, e clique em uma aresta para selecionar a conexão que ela desenha.

O grafo de topologia de uma Release: três componentes dentro das caixas que contêm os nós que nenhum limite ou subsistema declara, arestas do componente web para seu banco de dados e seu cache, e a legenda no canto inferior esquerdo.

O título de cada contêiner indica seu tipo além do seu agrupamento, de modo que a caixa externa e a interna se distinguem mesmo em um workspace que não declara nenhuma das duas — onde, de outra forma, ambas teriam o mesmo nome. Um agrupamento que ninguém declarou, que o compilador cria para os componentes que uma Release ou um Aggregate lista no nível superior, recebe um título indicando que nenhum foi declarado, e sua caixa é desenhada de forma diferente da de um agrupamento declarado — uma borda pontilhada e neutra — para que não seja lida como um agrupamento com aquele nome; um que você declarou mantém seu nome, seja ele qual for, default inclusive.

Cada aresta tem uma ponta de seta na extremidade para a qual aponta: uma aresta vai do componente consumidor ao seu destino, e a ponta de seta é desenhada com a cor e o tracejado da própria aresta. A caixa de um nó é dimensionada medindo o texto que ela desenha, tanto o nome do nó quanto o componente abaixo dele, de modo que nenhum dos dois ultrapassa a borda, por mais longo que seja o nome do componente.

Uma legenda no canto inferior esquerdo nomeia cada agrupamento pelo documento que o declara — um limite pela Release, um subsistema pelo Aggregate — e, onde o desenho tiver uma, a caixa que contém os nós que não estão em nenhum, com o que ela contém; indica qual extremidade de uma aresta é o seu destino; e nomeia a barra de cor ao longo da borda inicial de um nó e cada cor que o desenho lhe atribui, ao lado do valor de component.aggrega.ai/type que essa cor representa, exatamente como o rótulo está escrito, com uma linha para os nós sem esse rótulo, quando houver. Ela também diz o que essas cores não significam: elas são atribuídas a cada desenho de um grafo, portanto agrupam os nós por tipo dentro de um grafo, e a mesma cor em outro grafo não é o mesmo tipo. A legenda permanece onde está, faça você o que fizer com o desenho; assim, sempre que o desenho é ajustado ao painel — no primeiro desenho e cada vez que você solicita o grafo — ele é ajustado à parte do painel acima da legenda: dentro de toda a largura do painel e da altura que resta acima da legenda, centralizado horizontalmente, de modo que a legenda não cobre nenhuma parte do desenho, por mais linhas que tenha. Em um painel baixo demais para deixar espaço acima da legenda, o desenho é ajustado ao painel inteiro.

Selecionar um nó abre um painel que lista o que está anexado a ele: para cada anexo, a Feature e sua versão resolvida, o slot que ele preenche ou o fato de não preencher nenhum slot declarado, a FeatureRecipe que o realiza, por nome e versão, quando o grafo compilado indica uma, sua procedência, os rótulos que declara e os valores que seu autor escreveu. Um anexo escrito em uma das conexões do componente — em features: em uma entrada uses, no Aggregate ou na Release — não está nessa lista: ele é desenhado na conexão à qual pertence, conforme o grafo compilado o registra, e o painel do nó informa quando suas conexões têm algum.

Clicar em uma aresta seleciona a conexão que ela desenha e abre o painel sobre ela, intitulado pelo componente consumidor e seu destino e nomeando o socket e o alias, com os anexos dessa conexão apresentados como os de um nó — para cada um, a Feature e sua versão resolvida, o slot que preenche, a FeatureRecipe que o realiza quando o grafo compilado indica uma, e seus valores — ou uma frase dizendo que nada está anexado a ela. Selecionar um nó limpa a seleção de uma conexão e vice-versa; Escape ou o botão de fechar do painel limpa qualquer uma das duas, e um redesenho mantém a seleção enquanto o grafo reconstruído ainda desenhar o nó, ou a conexão a partir do mesmo componente pelo mesmo socket com o mesmo alias.

Abaixo dos anexos de um nó, em May attach, o painel lista as Features cuja aplicabilidade declarada é satisfeita pelos rótulos desse nó no grafo da Release que o painel mostra — as Features declaradas pelos documentos do workspace que essa Release lê, todas exceto as de um diretório de catálogo que somente outras Releases leem, e as contidas nos diretórios de catálogo com os quais essa Release é compilada — cada uma nomeada com seu tipo e com o arquivo do workspace que a declara ou com o catálogo configurado a partir do qual foi resolvida. Essa lista é aquilo a que essas Features declaram se aplicar, não uma decisão de que anexar uma resultará em um build bem-sucedido — e, quando está vazia, informa que a aplicabilidade declarada de nenhuma Feature corresponde a esses rótulos, o que é uma afirmação mais restrita do que a de que nada pode ser anexado. Uma solicitação que o servidor de linguagem não conseguiu responder informa isso no lugar da lista, em vez de deixá-la em branco. Uma Feature declarada por trás de um link que leva para fora do workspace — um link para um diretório externo, ou um link com nome de arquivo YAML que leva a um arquivo externo — não é oferecida, porque o servidor de linguagem não lê nenhuma entidade por meio de um link assim, embora a árvore de arquivos do seu editor mostre a Feature. Onde o workspace contém um link assim, uma linha abaixo da lista, ou abaixo da frase que substitui uma lista vazia, informa isso: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (As Features alcançadas por este link não são oferecidas, porque ele leva para fora do workspace do Aggrega:) seguido do caminho do link relativo ao workspace — ou Features reached through these links are not offered, because each leads outside the Aggrega workspace: (As Features alcançadas por estes links não são oferecidas, porque cada um leva para fora do workspace do Aggrega:) quando são vários, primeiro os links para diretórios. Ela nomeia os links que o servidor de linguagem relata nos termos da Release que o painel mostra, como o painel Catalog faz nos da Release selecionada. Quando esse relatório não pode ser lido, a lista é desenhada sem a linha e o motivo é escrito no canal de saída do Aggrega; uma lista que não pôde ser produzida não tem nenhuma linha.

O grafo de topologia com o componente web selecionado e, ao lado, o painel dizendo que nada está anexado a ele e listando em May attach as Features que podem ser anexadas, cada uma com um controle Attach.

Cada linha tem um controle Attach que a confirma: o compilador é consultado sobre qual documento declara o componente selecionado e em que ponto desse documento um anexo assim deve ficar, e a entrada é escrita ali por meio do editor — assim ela entra no histórico de desfazer, vai para o buffer que você está vendo, e não para a última versão salva em disco, e mantém os comentários e a formatação ao redor como você os escreveu. Nada é salvo em seu nome; a edição é uma alteração como qualquer outra, e o compilador a revalida como faria após qualquer edição. O grafo é redesenhado quando você salva, porque a topologia é compilada a partir dos documentos como estão em disco, e um anexo que ainda está no buffer ainda não faz parte deles. O anexo recebe o nome da Feature, e anexar uma Feature já anexada com esse nome é recusado em vez de ser escrito duas vezes. Um componente declarado dentro de um subsistema é anexado com o mesmo clique que um declarado no nível superior, e ambos funcionam pelo mesmo motivo: o grafo identifica um componente pela sua posição na topologia compilada, essa posição não diz quais chaves o autor do componente escreveu, e por isso a extensão pergunta em vez de reconstruir — a resposta indica o documento e o caminho até o bloco dentro dele, e ambos são levados para a edição tal como chegaram. Onde não há um lugar assim para indicar — um id que o grafo não tem, um nó para o qual ele não registra nenhum documento, ou um componente cujo próprio bloco não pode ser indicado no documento em que foi escrito — o que o painel mostra é o motivo dado pelo compilador, e não uma formulação própria desta extensão.

O painel de uma conexão selecionada tem uma seção May attach própria: os slots que o socket dessa conexão declara, na ordem em que o componente os declara, cada um com a indicação de se é obrigatório, se o que o preenche lida com material sensível, a entrega que permite, seu seletor e sua descrição, e sob cada slot as Features que o language server responde que podem preenchê-lo nessa conexão — aquelas cuja aplicabilidade declarada é satisfeita pelos rótulos do componente consumidor e cujos próprios rótulos satisfazem o seletor do slot. Onde nenhum slot pode ser preenchido, o painel diz por quê nos termos do language server — uma Feature traçou a conexão, o socket não é um que o componente declara, ou o socket não declara slots — e não oferece nada para anexar. Pressionar Attach sob um slot grava a Feature com o nome do slot, uma entrada <slot>: cujo type: nomeia a Feature, na entrada dessa conexão no documento que traçou a conexão: a Release, para uma conexão que a Release traçou, e o Aggregate nos demais casos. Uma conexão selecionada a partir de sua entrada em um documento, por Aggrega: Attach a Feature to the connection at the cursor, é gravada nesse documento em vez disso — a Release, para a entrada própria da Release referente a uma conexão que o Aggregate traçou — e a linha do painel sob May attach diz então que a Feature é gravada na entrada dessa conexão no documento em que o comando foi executado. O compilador é consultado sobre onde essa entrada fica nesse documento, qualquer parte do caminho que o documento ainda não contém é gravada junto com ela, e a edição chega ao editor como a de um nó, sem salvar. Um slot que o grafo já mostra preenchido nessa conexão é recusado antes de qualquer pergunta, e uma recusa do compilador é exibida com as palavras dele.

Um valor que o compilador relata como sensível é retido pelo language server no grafo que ele envia, e retido novamente pela extensão antes mesmo de o grafo ser entregue à visualização, de modo que não está na visualização para ser exibido — o painel nomeia o campo e diz por que ele é retido, e um anexo cuja marcação de sensibilidade tem um formato que o painel não reconhece retém todos os valores em vez de tentar adivinhar. Um anexo desenhado em uma conexão é retido exatamente pela mesma regra que um desenhado em um nó, sob a mesma configuração. aggrega.graph.showSensitiveValues desativa a retenção para um autor que precisa reler o que escreveu: só enquanto ela está ativada a solicitação do grafo pede esses valores ao language server, e a página de configurações diz o que isso exibe.

Os nós são dispostos na ordem em que as ondas da Release são iniciadas, de modo que um boundary que declara um syncWave: aparece antes dos boundaries que esperam por ele. Passar o ponteiro sobre um nó mostra seu componente e a versão resolvida, seus rótulos, sua onda declarada e os metadados próprios da entidade do catálogo — licença, repositório, página inicial, palavras-chave e mantenedores —, exibindo apenas os campos que a entidade realmente declara.

Um grafo aberto é renderizado novamente sempre que um documento criado no workspace é salvo, de modo que acompanha suas edições sem precisar ser reaberto; ele é redesenhado ao salvar, e não a cada tecla, porque a topologia é compilada a partir do que está em disco. Ele também é redesenhado quando o lockfile da Release selecionada é gravado — por Aggrega: Pull, por um build com Auto pull ou por aggrega pull em um terminal —, porque o grafo é fixado nesse lockfile, e também quando o language server volta a responder, de modo que um grafo deixado aberto durante uma reinicialização se recupera sozinho.

Um redesenho que você não pediu mantém sua visualização onde você a deixou: o deslocamento e o zoom que você tinha são mantidos, quer a topologia reconstruída seja diferente ou não, de modo que um nó que o layout reconstruído coloca onde estava permanece sob a mesma parte do painel, e um que ele coloca em outro lugar — um componente adicionado pode deslocar os que estão ao redor — se move dentro da visualização que você manteve, em vez de levar a visualização consigo. Isso inclui um redesenho que ocorre enquanto o grafo está atrás de outra aba, à qual você volta como a deixou.

Aggrega: Show topology graph ajusta o desenho ao painel novamente, que é a maneira de voltar à forma inteira depois de dar zoom em uma parte. Uma topologia grande é ajustada por inteiro, e não cortada, então uma grande chega pequena: você vê como ela está montada e chega aos nomes dando zoom. Onde dois ou mais agrupamentos contidos em uma caixa ficariam mais altos do que largos, eles são desenhados lado a lado em vez de empilhados em uma coluna, de modo que uma topologia grande usa a largura do painel e seu primeiro ajuste a desenha maior do que uma única coluna permitiria.

Uma reconstrução que o compilador recusa mantém o desenho que você tinha em vez de apagá-lo — a topologia ainda vale a leitura e ainda está onde você estava trabalhando — e o esmaece, para que um desenho que não está mais atualizado não seja confundido com um que está; o aviso acima dele traz o motivo do próprio compilador. O desenho volta à intensidade total assim que um novo é construído. O layout é calculado na visualização; o compilador entrega topologia, nunca coordenadas.