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 servidor de linguagem

Estado do language server — um indicador na barra de status, à esquerda, ao lado do indicador de Release, exibindo running, starting ou not running em vermelho. É a única superfície presente seja o que for que o compilador esteja fazendo, então é ali que você descobre que nada está em execução em vez de ter que deduzir isso de superfícies que ficaram em silêncio — e sua dica informa qual dos dois motivos se aplica: nenhuma pasta aqui é uma que o Aggrega reconhece, ou há uma e o servidor não está vinculado a ela. Clicar nele oferece Start quando nada está em execução e Restart quando algo está, e executa o que você escolher. Veja Quando o language server não está em execução.

Quando o servidor de linguagem não está em execução

Todo comando que esta extensão fornece existe desde o momento em que ela inicia, haja ou não um servidor de linguagem em execução, e só dois deles esperam um servidor antes que o índice de comandos os liste: o nomeado abaixo, e Aggrega: Attach a Feature to the connection at the cursor, que só é listado em um documento que o servidor de linguagem informa ser um Aggregate ou uma Release. Um comando que só passasse a existir depois que um servidor se conectasse estaria ausente do índice de comandos exatamente na janela que mais precisa dele — aquela em que nada está em execução e você procura o jeito de iniciá-lo.

O indicador à esquerda na barra de status é onde você descobre o que está acontecendo. Ele mostra running, starting ou not running em vermelho, e seu tooltip diz por quê: nenhuma pasta nesta janela é uma que o Aggrega reconhece, ou há uma e o servidor não está conectado a ela. Clicar nele oferece Start ou Restart — o que se aplicar — e executa a ação.

A barra de status informando em vermelho que o servidor de linguagem do Aggrega não está em execução, e o menu que o indicador abre, oferecendo Start.

Esse indicador existe porque um comando que não pode ser executado não explica nada: o índice de comandos o omite em vez de dizer por quê, e nenhuma superfície do editor mostra um tooltip em um controle desabilitado. O indicador é onde o motivo fica escrito, e também onde você age a respeito.

Uma inicialização que falha diz o que há de errado com o caminho do compilador. Onde aggrega.server.binaryPath não aponta para nada, a notificação diz Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Falha ao iniciar o servidor de linguagem do Aggrega: o compilador em ⟨path⟩ não foi encontrado.); onde aponta para um arquivo que não pode ser executado, diz … ⟨path⟩ is not an executable file. (… ⟨path⟩ não é um arquivo executável.) ⟨path⟩ é o arquivo que a extensão tentou iniciar: uma configuração que começa com ~/ ou ${userHome} é mostrada resolvida a partir da sua pasta pessoal, como foi procurada. Ambas continuam dizendo para definir aggrega.server.binaryPath como o binário aggrega, e trazem Open binary path setting, que abre a tela de configurações nessa única configuração, e Show output. Onde o caminho não aponta para nada, a notificação traz também Download the compiler e Choose another file antes desses dois, porque então não há compilador a substituir: o primeiro baixa um como descrito em Como obter o compilador, e o segundo pede um arquivo de compilador que você tenha e aponta a configuração para ele. Um arquivo que está lá e não pode ser executado foi colocado por você, então essa notificação não oferece download. Qualquer outra falha de inicialização informa o motivo que lhe foi dado, após a mesma abertura, e então nomeia o compilador que foi executado e a configuração que o nomeia. O canal de saída do Aggrega traz o mesmo relato.

Validate diz que o servidor não está em execução e oferece o caminho de volta. Pressionado quando nenhum servidor de linguagem está em execução, ele responde Aggrega: the language server is not running. (Aggrega: o servidor de linguagem não está em execução.) — seguido, onde a última inicialização falhou, do motivo, nas palavras em que essa falha foi informada — com Show output, Open binary path setting e o próprio Start do indicador da barra de status.

Os painéis de lista dizem que o servidor não está em execução em vez de relatar uma falha. Sem nenhum servidor de linguagem em execução, os painéis Registries e Catalog mostram cada um The Aggrega language server is not running. (O servidor de linguagem do Aggrega não está em execução.) no lugar de sua lista, com o próprio tooltip do indicador, e pressionar a linha inicia o servidor. A lista do painel Plugins vem da execução do compilador como comando, e não do servidor de linguagem, então onde esse comando não pôde ser iniciado sua linha diz o que há de errado com o caminho nas palavras da notificação, e pressioná-la abre a configuração.

Aggrega: Open status bar menu fica fora do índice de comandos enquanto nenhum servidor de linguagem está respondendo: tudo o que ele oferece é uma ação sobre um servidor de linguagem em execução, e o seu editor não lista um comando que não pode ser executado ali. Ele volta no momento em que um servidor responde.

Um comando que funciona sem servidor permanece no índice de comandos, mesmo que diga respeito ao servidor. Aggrega: Toggle the artifact-rendering stage while inspecting grava uma preferência, e o servidor lê essa preferência ao iniciar — então um servidor parado é o momento mais útil para defini-la, não um motivo para ocultá-la.

Ciclo de vida

A extensão gerencia todo o ciclo de vida do processo do servidor de linguagem. Quando ela para o servidor de linguagem — ao fechar o editor, quando o servidor de linguagem passa para outro workspace do Aggrega, ou quando não resta um único workspace ao qual conectá-lo — primeiro pede ao servidor de linguagem que encerre de forma cooperativa, o que permite que o trabalho em andamento termine. Se o servidor de linguagem ainda estiver trabalhando quando esse período de tolerância terminar, ele é solicitado mais uma vez — desta vez a abandonar esse trabalho em vez de terminá-lo. Se ainda assim não tiver encerrado, a extensão recorre ao encerramento no nível do sistema operacional. Um reinício — o comando de reinício, uma alteração de aggrega.server.binaryPath ou uma alteração de configuração feita pela própria extensão — não pede: ele encerra o processo no nível do sistema operacional e inicia um novo. Cada uma dessas etapas é informada no canal de saída do Aggrega, de modo que um desligamento lento mostra qual etapa está demorando e se o servidor de linguagem chegou a responder. A semântica é idêntica em hosts POSIX e Windows.

Um servidor de linguagem que para sem que isso tenha sido pedido é iniciado novamente, um número limitado de vezes. Quando um servidor em execução termina, a extensão inicia um novo; se esse também terminar — ao iniciar, antes de ter respondido à solicitação inicial da extensão, ou depois de já estar em execução — ele é por sua vez iniciado novamente, até aggrega.server.respawnAttempts reinícios em aggrega.server.respawnWindowSeconds segundos. O término após o último deles deixa o servidor parado e exibe Aggrega language server has stopped responding. (O servidor de linguagem do Aggrega parou de responder.), nomeando o comando que o inicia novamente, e depois disso nada o inicia novamente por conta própria — assim, um servidor que morre toda vez que inicia é iniciado novamente esse número de vezes e não mais. O canal de saída do Aggrega descreve cada etapa em palavras: que o servidor parou inesperadamente e como terminou, cada reinício e quantos a configuração permite, um reinício que não subiu e por quê, e que ele não está sendo iniciado novamente. Uma parada ou um reinício que você pediu — o comando de reinício, uma alteração de aggrega.server.binaryPath ou uma alteração de configuração feita pela própria extensão — não é contado, e um reinício zera a contagem. O primeiro início, e um reinício que você pediu, não são repetidos quando falham: cada um termina na notificação de que o servidor de linguagem não conseguiu iniciar, com o motivo.

Cada servidor de linguagem começa o painel Problems a partir do que ele mesmo informa. Quando um servidor inicia — o primeiro, um reinício independentemente de como foi pedido, um iniciado novamente depois que o último parou inesperadamente, um movido para outro workspace do Aggrega e um iniciado onde nenhum estava em execução — o painel Problems é esvaziado de tudo o que o servidor anterior informou, e cada arquivo YAML aberto é verificado com o novo assim que ele responde. Um servidor não pode retirar o que informou, e o iniciado depois dele não sabe o que era, então uma constatação mantida seria uma que nenhum servidor em execução sustenta — depois de uma mudança, uma sobre o workspace que você deixou. As constatações somem e voltam enquanto os arquivos abertos são verificados. Uma constatação que só outra solicitação calcula fica de fora até essa solicitação ser executada novamente: as constatações do build voltam quando o grafo é desenhado ou quando um build ou um build de pré-visualização é executado, o aviso de desvio de um lockfile quando o grafo é desenhado — ambos ao mesmo tempo onde houver um painel de grafo aberto nessa Release, já que ele é redesenhado quando o servidor volta — e as constatações das convenções de publicação quando você executa Lint. Um servidor que para e não é substituído — esgotados seus reinícios, ou sem nenhum workspace do Aggrega ao qual se conectar — deixa o painel Problems como estava.

O servidor de linguagem lê sua configuração ao iniciar e a mantém até parar. A linha de comando a lê novamente a cada execução, de modo que uma edição em .aggrega-config.yaml ou em ~/.config/aggrega/config.yaml muda imediatamente o que um terminal faz e não muda nada em um servidor de linguagem que já está em execução. Por isso a extensão observa os arquivos de configuração que o servidor em execução informa ter lido — os caminhos de arquivo que Show config lista entre os arquivos que contribuíram — e, quando um deles muda no disco, é excluído ou volta, e assim deixa de corresponder ao que o servidor leu, exibe um aviso que nomeia o arquivo e diz que o servidor de linguagem lê sua configuração ao iniciar, com um botão Restart server que executa Aggrega: Start or restart the language server. Várias gravações de um mesmo salvamento exibem um único aviso. O aviso não é exibido novamente para esse arquivo enquanto estiver na tela, nem depois que você o dispensar até que o arquivo mude de novo, e um reinício recomeça a observação a partir do que o servidor reiniciado leu. Um arquivo de configuração que não existia quando o servidor iniciou não foi lido, então não é observado e criá-lo não exibe nada; o próximo início o lê. Quais arquivos estão sendo observados é escrito no canal de saída do Aggrega toda vez que um servidor inicia.

Uma alteração de configuração que a própria extensão faz é aplicada reiniciando o servidor de linguagem, sem perguntar. Adicionar ou remover um registro, inicializar um registro a partir da página de boas-vindas, adicionar ou remover um plugin, criar a configuração do workspace a partir da página de boas-vindas e Aggrega: Set authoring_release in .aggrega-config.yaml… quando ele precisa criar o arquivo são, cada um, seguidos de um reinício, mostrado enquanto é executado como uma notificação que nomeia o arquivo que o servidor está prestes a ler, e nenhum deles exibe o aviso: você pediu essa alteração. Onde criar a configuração do workspace inicia o próprio servidor de linguagem — nenhum estava em execução, ou ele estava em execução para outra pasta — esse início lê o novo arquivo, e não se segue um segundo reinício. Depois que um servidor de linguagem iniciado após a alteração a tiver lido, o próprio encerramento da operação acrescenta uma frase dizendo que a alteração agora está em vigor, em vez de uma segunda notificação; onde o reinício falhou, ou nenhum servidor de linguagem estava em execução para ler a alteração, a frase é omitida, porque a alteração está então no arquivo e ainda não em vigor. Definir authoring_release termina abrindo o arquivo em vez de com uma frase, então não acrescenta nada.