Le serveur de langage
État du language server — un indicateur dans la barre d’état, à gauche, à côté de l’indicateur de Release, affichant running, starting, ou not running en rouge. C’est la seule surface présente quoi que fasse le compilateur ; c’est donc là que vous découvrez que rien ne s’exécute plutôt que d’avoir à le déduire de surfaces devenues silencieuses — et son infobulle indique laquelle des deux raisons s’applique : aucun dossier ici n’est un dossier qu’Aggrega reconnaît, ou il y en a un et le serveur n’y est pas rattaché. Un clic dessus propose Start lorsque rien ne s’exécute et Restart lorsque quelque chose s’exécute, et exécute celui que vous choisissez. Voir Lorsque le language server ne s’exécute pas.
Lorsque le serveur de langage ne s’exécute pas
Chaque commande que cette extension fournit existe dès son démarrage, qu’un serveur de langage s’exécute ou non, et deux seulement attendent un serveur avant que l’index des commandes les liste : celle nommée ci-dessous, et Aggrega: Attach a Feature to the connection at the cursor, qui n’est listée que dans un document que le serveur de langage signale comme un Aggregate ou une Release. Une commande qui n’apparaîtrait qu’une fois un serveur attaché manquerait à l’index des commandes précisément dans la fenêtre qui en a le plus besoin — celle où rien ne s’exécute et où vous cherchez le moyen de le démarrer.
L’indicateur à gauche de la barre d’état est l’endroit où vous découvrez ce qui se passe. Il affiche running, starting ou not running en rouge, et son infobulle dit pourquoi : aucun dossier de cette fenêtre n’est un dossier qu’Aggrega reconnaît, ou il y en a un et le serveur n’y est pas attaché. Un clic dessus propose Start ou Restart — selon le cas — et l’exécute.

Cet indicateur existe parce qu’une commande qui ne peut pas s’exécuter n’explique rien : l’index des commandes l’omet au lieu de dire pourquoi, et aucune surface de l’éditeur n’affiche d’infobulle sur un contrôle désactivé. L’indicateur est l’endroit où la raison est écrite, et c’est aussi là que vous agissez en conséquence.
Un démarrage qui échoue indique ce qui ne va pas dans le chemin du compilateur. Lorsque aggrega.server.binaryPath ne désigne rien, la notification affiche Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Échec du démarrage du serveur de langage Aggrega : le compilateur situé à ⟨path⟩ est introuvable.) ; lorsqu’il désigne un fichier qui ne peut pas être exécuté, elle affiche … ⟨path⟩ is not an executable file. (… ⟨path⟩ n’est pas un fichier exécutable.) ⟨path⟩ est le fichier que l’extension a tenté de démarrer : un paramètre commençant par ~/ ou ${userHome} est affiché résolu à partir de votre dossier personnel, tel qu’il a été recherché. Toutes deux indiquent ensuite de faire pointer aggrega.server.binaryPath vers le binaire aggrega, et proposent Open binary path setting, qui ouvre l’écran des paramètres sur ce seul paramètre, et Show output. Lorsque le chemin ne désigne rien, la notification propose aussi Download the compiler et Choose another file avant ces deux-là, car il n’y a alors aucun compilateur à remplacer : le premier en télécharge un comme le décrit Obtenir le compilateur, et le second demande un fichier de compilateur dont vous disposez et y fait pointer le paramètre. Un fichier présent qui ne peut pas être exécuté est un fichier que vous avez placé là, aussi cette notification ne propose-t-elle aucun téléchargement. Tout autre échec de démarrage donne la raison qui lui a été fournie, après la même ouverture, puis nomme le compilateur qui a été exécuté et le paramètre qui le désigne. Le canal de sortie Aggrega contient le même compte rendu.
Validate indique que le serveur ne s’exécute pas, et propose le moyen d’y remédier. Pressé alors qu’aucun serveur de langage ne s’exécute, il répond Aggrega: the language server is not running. (Aggrega : le serveur de langage ne s’exécute pas.) — suivi, lorsque le dernier démarrage a échoué, de la raison, dans les mots par lesquels cet échec a été signalé — avec Show output, Open binary path setting et le Start de l’indicateur de la barre d’état.
Les panneaux de liste indiquent que le serveur ne s’exécute pas au lieu de signaler un échec. Sans serveur de langage en cours d’exécution, les panneaux Registries et Catalog affichent chacun The Aggrega language server is not running. (Le serveur de langage Aggrega ne s’exécute pas.) à la place de leur liste, avec l’infobulle de l’indicateur, et presser la ligne démarre le serveur. La liste du panneau Plugins provient de l’exécution du compilateur en tant que commande et non du serveur de langage, donc lorsque cette commande n’a pas pu être lancée, sa ligne indique ce qui ne va pas dans le chemin avec les mots de la notification, et la presser ouvre le paramètre.
Aggrega: Open status bar menu est omise de l’index des commandes tant qu’aucun serveur de langage ne répond : tout ce qu’elle propose est une action sur un serveur de langage en cours d’exécution, et votre éditeur ne liste pas une commande qui ne peut pas s’y exécuter. Elle réapparaît dès qu’un serveur répond.
Une commande qui fonctionne sans serveur reste dans l’index des commandes, même si elle concerne le serveur. Aggrega: Toggle the artifact-rendering stage while inspecting écrit une préférence, et le serveur lit cette préférence au démarrage — un serveur arrêté est donc le moment le plus utile pour la définir, et non une raison de la masquer.
Cycle de vie
L’extension gère tout le cycle de vie du processus du serveur de langage. Lorsqu’elle arrête le serveur de langage — à la fermeture de l’éditeur, lorsque le serveur de langage passe à un autre espace de travail Aggrega, ou lorsqu’il ne reste plus un espace de travail unique auquel le rattacher — elle demande d’abord au serveur de langage de se terminer de manière coopérative, ce qui permet au travail en cours de s’achever. Si le serveur de langage travaille encore lorsque ce délai de grâce expire, on le lui demande une fois de plus — cette fois pour abandonner ce travail au lieu de l’achever. S’il ne s’est toujours pas terminé, l’extension se rabat sur une terminaison au niveau du système d’exploitation. Un redémarrage — la commande de redémarrage, une modification de aggrega.server.binaryPath ou une modification de configuration faite par l’extension elle-même — ne demande rien : il termine le processus au niveau du système d’exploitation et en démarre un nouveau. Chacune de ces étapes est signalée dans le canal de sortie Aggrega, de sorte qu’un arrêt lent montre quelle étape prend du temps et si le serveur de langage a répondu. La sémantique est identique sur les hôtes POSIX et Windows.
Un serveur de langage qui s’arrête sans qu’on le lui ait demandé est redémarré, un nombre limité de fois. Lorsqu’un serveur en cours d’exécution se termine, l’extension en démarre un nouveau ; si celui-ci se termine aussi — au démarrage, avant d’avoir répondu à la requête d’ouverture de l’extension, ou une fois en cours d’exécution — il est à son tour redémarré, jusqu’à aggrega.server.respawnAttempts redémarrages en aggrega.server.respawnWindowSeconds secondes. La fin qui suit le dernier d’entre eux laisse le serveur arrêté et déclenche Aggrega language server has stopped responding. (Le serveur de langage Aggrega a cessé de répondre.), en nommant la commande qui le redémarre, et ensuite plus rien ne le redémarre de lui-même — un serveur qui meurt à chaque démarrage est donc redémarré ce nombre de fois et pas davantage. Le canal de sortie Aggrega décrit chaque étape en toutes lettres : que le serveur s’est arrêté de manière inattendue et comment il s’est terminé, chaque redémarrage et combien le paramètre en autorise, un redémarrage qui n’a pas abouti et pourquoi, et qu’il n’est plus redémarré. Un arrêt ou un redémarrage que vous avez demandé — la commande de redémarrage, une modification de aggrega.server.binaryPath ou une modification de configuration faite par l’extension elle-même — n’est pas compté, et un redémarrage remet le compte à zéro. Le premier démarrage, et un redémarrage que vous avez demandé, ne sont pas répétés en cas d’échec : chacun se termine par la notification indiquant que le serveur de langage n’a pas pu démarrer, avec la raison.
Chaque serveur de langage commence le panneau Problems à partir de ce qu’il signale lui-même. Au démarrage d’un serveur — le premier, un redémarrage quelle que soit la manière dont il a été demandé, un serveur redémarré après l’arrêt inattendu du dernier, un serveur déplacé vers un autre espace de travail Aggrega, et un serveur démarré là où aucun ne tournait — le panneau Problems est vidé de tout ce que le serveur précédent avait signalé, et chaque fichier YAML ouvert est vérifié auprès du nouveau dès qu’il répond. Un serveur ne peut pas retirer ce qu’il a signalé, et celui qui démarre après lui ne sait pas ce que c’était, de sorte qu’un constat laissé en place serait un constat qu’aucun serveur en cours d’exécution ne soutient — après un déplacement, un constat concernant l’espace de travail que vous avez quitté. Les constats disparaissent puis réapparaissent pendant la vérification des fichiers ouverts. Un constat que seule une autre requête calcule reste absent jusqu’à ce que cette requête soit de nouveau exécutée : les constats du build reviennent lorsque le graphe est dessiné ou qu’un build ou un build d’aperçu s’exécute, l’avertissement de dérive d’un lockfile lorsque le graphe est dessiné — les deux à la fois lorsqu’un panneau de graphe est ouvert sur cette Release, puisqu’il est redessiné au retour du serveur — et les constats sur les conventions de publication lorsque vous lancez Lint. Un serveur qui s’arrête et n’est pas remplacé — ses redémarrages épuisés, ou plus aucun espace de travail Aggrega auquel se rattacher — laisse le panneau Problems tel qu’il était.
Le serveur de langage lit sa configuration au démarrage et la conserve jusqu’à son arrêt. La ligne de commande la relit à chaque exécution, de sorte qu’une modification de .aggrega-config.yaml ou de ~/.config/aggrega/config.yaml change immédiatement ce que fait un terminal et ne change rien dans un serveur de langage déjà en cours d’exécution. L’extension surveille donc les fichiers de configuration que le serveur en cours d’exécution indique avoir lus — les chemins de fichiers que Show config liste parmi les fichiers qui ont contribué — et lorsque l’un d’eux change sur le disque, est supprimé ou réapparaît, et ne correspond donc plus à ce que le serveur a lu, elle émet un avertissement qui nomme le fichier et indique que le serveur de langage lit sa configuration au démarrage, avec un bouton Restart server qui exécute Aggrega: Start or restart the language server. Plusieurs écritures issues d’un même enregistrement émettent un seul avertissement. L’avertissement n’est pas émis de nouveau pour ce fichier tant qu’il est à l’écran, ni après que vous l’avez fermé tant que le fichier ne change pas de nouveau, et un redémarrage fait repartir la surveillance de ce que le serveur redémarré a lu. Un fichier de configuration qui n’existait pas au démarrage du serveur n’a pas été lu, il n’est donc pas surveillé et le créer n’émet rien ; le démarrage suivant le lit. Les fichiers surveillés sont indiqués dans le canal de sortie Aggrega à chaque démarrage d’un serveur.
Une modification de configuration faite par l’extension elle-même est appliquée en redémarrant le serveur de langage, sans demander. L’ajout ou la suppression d’un registre, l’amorçage d’un registre depuis la page d’accueil, l’ajout ou la suppression d’un plugin, la création de la configuration de l’espace de travail depuis la page d’accueil et Aggrega: Set authoring_release in .aggrega-config.yaml… lorsqu’il doit créer le fichier sont chacun suivis d’un redémarrage, affiché pendant son exécution sous forme de notification nommant le fichier que le serveur s’apprête à lire, et aucun d’eux n’émet l’avertissement : c’est vous qui avez demandé cette modification. Lorsque la création de la configuration de l’espace de travail démarre elle-même le serveur de langage — aucun ne tournait, ou il tournait pour un autre dossier — ce démarrage lit le nouveau fichier, et aucun second redémarrage ne suit. Une fois qu’un serveur de langage démarré après la modification l’a lue, la conclusion de l’opération elle-même ajoute une phrase indiquant que la modification est désormais en vigueur, au lieu d’une seconde notification ; lorsque le redémarrage a échoué, ou qu’aucun serveur de langage ne tournait pour lire la modification, la phrase est omise, car la modification est alors dans le fichier et pas encore en vigueur. Définir authoring_release se termine par l’ouverture du fichier plutôt que par une phrase, et n’ajoute donc rien.