Serwer językowy
Stan serwera języka — wskaźnik po lewej stronie paska stanu, obok wskaźnika Release, pokazujący running, starting lub czerwone not running. To jedyny element, który jest obecny bez względu na to, co robi kompilator, więc właśnie tu można się dowiedzieć, że nic nie działa, zamiast wnioskować o tym z elementów, które ucichły — a jego etykietka podaje, która z dwóch przyczyn zachodzi: żaden folder tutaj nie jest rozpoznawany przez Aggrega albo taki folder jest, ale serwer nie jest do niego podłączony. Kliknięcie go proponuje Start, gdy nic nie działa, i Restart, gdy coś działa, i wykonuje wybraną czynność. Zob. Gdy serwer języka nie działa.
Gdy serwer językowy nie działa
Każde polecenie dostarczane przez to rozszerzenie istnieje od chwili jego uruchomienia, niezależnie od tego, czy działa serwer językowy, a tylko dwa z nich czekają na serwer, zanim indeks poleceń je wyświetli: to wymienione poniżej oraz Aggrega: Attach a Feature to the connection at the cursor, które jest wyświetlane tylko w dokumencie, który serwer językowy zgłasza jako Aggregate lub Release. Polecenia, które pojawiałoby się dopiero po podłączeniu serwera, brakowałoby w indeksie poleceń dokładnie wtedy, gdy jest najbardziej potrzebne — gdy nic nie działa, a szuka się sposobu, by to uruchomić.
Wskaźnik na pasku stanu po lewej to miejsce, w którym można dowiedzieć się, co się dzieje. Pokazuje running, starting lub na czerwono not running, a jego podpowiedź mówi dlaczego: żaden folder w tym oknie nie jest rozpoznawany przez Aggrega albo taki folder jest, ale serwer nie jest do niego podłączony. Kliknięcie go oferuje Start lub Restart — w zależności od sytuacji — i wykonuje to.

Ten wskaźnik istnieje, ponieważ polecenie, którego nie można uruchomić, niczego nie wyjaśnia: indeks poleceń je pomija, nie mówiąc dlaczego, a żadna powierzchnia edytora nie pokazuje podpowiedzi na wyłączonej kontrolce. Wskaźnik jest miejscem, w którym zapisana jest przyczyna, i zarazem miejscem, w którym można na nią zareagować.
Nieudane uruchomienie mówi, co jest nie tak ze ścieżką kompilatora. Gdy aggrega.server.binaryPath nie wskazuje niczego, powiadomienie brzmi Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Nie udało się uruchomić serwera językowego Aggrega: nie znaleziono kompilatora w ⟨path⟩.); gdy wskazuje plik, którego nie można uruchomić, brzmi … ⟨path⟩ is not an executable file. (… ⟨path⟩ nie jest plikiem wykonywalnym.). ⟨path⟩ to plik, który rozszerzenie próbowało uruchomić: ustawienie zaczynające się od ~/ lub ${userHome} jest pokazywane po rozwinięciu względem folderu domowego, tak jak było wyszukiwane. Oba dalej mówią, aby ustawić aggrega.server.binaryPath na plik binarny aggrega, i zawierają Open binary path setting, które otwiera ekran ustawień na tym jednym ustawieniu, oraz Show output. Gdy ścieżka nie wskazuje niczego, powiadomienie zawiera też Download the compiler i Choose another file przed tymi dwoma, ponieważ wtedy nie ma kompilatora do zastąpienia: pierwsze pobiera kompilator w sposób opisany w sekcji Pobieranie kompilatora, a drugie prosi o posiadany plik kompilatora i kieruje na niego ustawienie. Plik, który istnieje, ale nie można go uruchomić, został tam umieszczony przez użytkownika, więc to powiadomienie nie oferuje pobrania. Każde inne niepowodzenie uruchomienia podaje otrzymaną przyczynę po tym samym początku, a następnie wymienia uruchomiony kompilator i ustawienie, które go wskazuje. Kanał wyjściowy Aggrega zawiera ten sam opis.
Validate mówi, że serwer nie działa, i oferuje drogę powrotu. Naciśnięte, gdy żaden serwer językowy nie działa, odpowiada Aggrega: the language server is not running. (Aggrega: serwer językowy nie działa.) — a jeśli ostatnie uruchomienie się nie powiodło, dalej podaje przyczynę słowami, w jakich zgłoszono to niepowodzenie — wraz z Show output, Open binary path setting i własnym Start wskaźnika na pasku stanu.
Panele list mówią, że serwer nie działa, zamiast zgłaszać niepowodzenie. Gdy nie działa żaden serwer językowy, panele Registries i Catalog wyświetlają w miejscu swojej listy The Aggrega language server is not running. (Serwer językowy Aggrega nie działa.) z podpowiedzią samego wskaźnika, a naciśnięcie tego wiersza uruchamia serwer. Lista panelu Plugins pochodzi z uruchomienia kompilatora jako polecenia, a nie z serwera językowego, więc gdy tego polecenia nie udało się uruchomić, jego wiersz mówi słowami powiadomienia, co jest nie tak ze ścieżką, a naciśnięcie go otwiera ustawienie.
Aggrega: Open status bar menu jest pomijane w indeksie poleceń, gdy żaden serwer językowy nie odpowiada: wszystko, co oferuje, to działania na działającym serwerze językowym, a edytor nie wyświetla polecenia, które nie może tam zostać uruchomione. Wraca w chwili, gdy jakiś serwer zaczyna odpowiadać.
Polecenie, które działa bez serwera, pozostaje w indeksie poleceń, nawet jeśli dotyczy serwera. Aggrega: Toggle the artifact-rendering stage while inspecting zapisuje preferencję, a serwer odczytuje tę preferencję przy uruchomieniu — więc zatrzymany serwer to najbardziej przydatny moment, by ją ustawić, a nie powód, by ją ukrywać.
Cykl życia
Rozszerzenie zarządza pełnym cyklem życia procesu serwera językowego. Gdy zatrzymuje serwer językowy — przy zamknięciu edytora, przeniesieniu serwera językowego do innego obszaru roboczego Aggrega lub gdy nie pozostaje pojedynczy obszar roboczy, do którego mógłby się podłączyć — najpierw prosi serwer językowy o kooperacyjne zakończenie, co pozwala dokończyć trwającą pracę. Jeśli po upływie tego okresu karencji serwer językowy wciąż pracuje, jest proszony jeszcze raz — tym razem o porzucenie tej pracy zamiast jej dokończenia. Jeśli nadal się nie zakończył, rozszerzenie sięga po zakończenie na poziomie systemu operacyjnego. Ponowne uruchomienie — polecenie ponownego uruchomienia, zmiana aggrega.server.binaryPath lub zmiana konfiguracji wprowadzona przez samo rozszerzenie — nie prosi: kończy proces na poziomie systemu operacyjnego i uruchamia nowy. Każdy z tych kroków jest zgłaszany do kanału wyjściowego Aggrega, więc przy powolnym zamykaniu widać, który krok zajmuje czas i czy serwer językowy w ogóle odpowiedział. Semantyka jest identyczna na hostach POSIX i Windows.
Serwer językowy, który zatrzymuje się bez prośby, jest uruchamiany ponownie ograniczoną liczbę razy. Gdy działający serwer się kończy, rozszerzenie uruchamia nowy; jeśli i ten się zakończy — podczas uruchamiania, zanim odpowie na początkowe żądanie rozszerzenia, lub już w trakcie działania — jest z kolei uruchamiany ponownie, maksymalnie aggrega.server.respawnAttempts razy w ciągu aggrega.server.respawnWindowSeconds sekund. Zakończenie po ostatnim z nich pozostawia serwer zatrzymany i wyświetla Aggrega language server has stopped responding. (Serwer językowy Aggrega przestał odpowiadać.), podając polecenie, które go ponownie uruchamia, i od tej pory nic nie uruchamia go ponownie samo z siebie — więc serwer, który pada przy każdym uruchomieniu, jest uruchamiany ponownie tyle razy i nie więcej. Kanał wyjściowy Aggrega opisuje słowami każdy krok: że serwer nieoczekiwanie się zatrzymał i jak się zakończył, każde ponowne uruchomienie i ile ich dopuszcza ustawienie, ponowne uruchomienie, które się nie powiodło, i dlaczego, oraz że serwer nie jest już uruchamiany ponownie. Zatrzymanie lub ponowne uruchomienie, o które poproszono — polecenie ponownego uruchomienia, zmiana aggrega.server.binaryPath lub zmiana konfiguracji wprowadzona przez samo rozszerzenie — nie jest liczone, a ponowne uruchomienie zaczyna liczenie od zera. Pierwsze uruchomienie oraz ponowne uruchomienie, o które poproszono, nie są powtarzane w razie niepowodzenia: każde kończy się powiadomieniem, że nie udało się uruchomić serwera językowego, wraz z przyczyną.
Każdy serwer językowy zaczyna panel Problems od tego, co sam zgłasza. Gdy serwer się uruchamia — pierwszy, ponownie uruchomiony niezależnie od sposobu, w jaki o to poproszono, uruchomiony ponownie po nieoczekiwanym zatrzymaniu poprzedniego, przeniesiony do innego obszaru roboczego Aggrega oraz uruchomiony tam, gdzie żaden nie działał — panel Problems jest czyszczony ze wszystkiego, co zgłosił poprzedni serwer, a każdy otwarty plik YAML jest sprawdzany przez nowy serwer, gdy tylko ten zacznie odpowiadać. Serwer nie może wycofać tego, co zgłosił, a uruchomiony po nim nie wie, co to było, więc pozostawione zgłoszenie byłoby takim, za którym nie stoi żaden działający serwer — po przeniesieniu dotyczyłoby obszaru roboczego, który opuszczono. Podczas sprawdzania otwartych plików zgłoszenia na chwilę znikają i wracają. Zgłoszenie, które oblicza tylko inne żądanie, nie wraca, dopóki to żądanie nie zostanie uruchomione ponownie: zgłoszenia kompilacji wracają, gdy rysowany jest graf lub uruchamiana jest kompilacja albo kompilacja podglądowa, ostrzeżenie o rozbieżności pliku blokady — gdy rysowany jest graf (oba naraz, jeśli otwarty jest panel grafu dla tej encji Release, ponieważ jest on rysowany ponownie, gdy serwer wraca), a zgłoszenia dotyczące konwencji publikacji — gdy uruchamia się Lint. Serwer, który się zatrzymuje i nie zostaje zastąpiony — po wyczerpaniu ponownych uruchomień lub gdy nie pozostał obszar roboczy Aggrega, do którego mógłby się podłączyć — pozostawia panel Problems bez zmian.
Serwer językowy odczytuje konfigurację przy uruchomieniu i zachowuje ją do zatrzymania. Wiersz poleceń odczytuje ją od nowa przy każdym uruchomieniu, więc edycja .aggrega-config.yaml lub ~/.config/aggrega/config.yaml od razu zmienia działanie terminala i niczego nie zmienia w już działającym serwerze językowym. Dlatego rozszerzenie obserwuje pliki konfiguracji, które według działającego serwera zostały przez niego odczytane — ścieżki plików, które Show config wymienia wśród plików, które miały udział w konfiguracji — a gdy jeden z nich zmieni się na dysku, zostanie usunięty lub pojawi się ponownie i przez to przestanie odpowiadać temu, co odczytał serwer, wyświetla jedno ostrzeżenie, które wskazuje plik i mówi, że serwer językowy odczytuje konfigurację przy uruchomieniu, z przyciskiem Restart server, który uruchamia Aggrega: Start or restart the language server. Kilka zapisów z jednego zapisania pliku wywołuje jedno ostrzeżenie. Ostrzeżenie nie jest wyświetlane ponownie dla tego pliku, dopóki jest na ekranie, ani po jego odrzuceniu, dopóki plik znów się nie zmieni, a ponowne uruchomienie zaczyna obserwację od nowa od tego, co odczytał ponownie uruchomiony serwer. Plik konfiguracji, który nie istniał w chwili uruchomienia serwera, nie został odczytany, więc nie jest obserwowany, a jego utworzenie niczego nie wywołuje; odczyta go następne uruchomienie. To, które pliki są obserwowane, jest zapisywane w kanale wyjściowym Aggrega przy każdym uruchomieniu serwera.
Zmiana konfiguracji wprowadzana przez samo rozszerzenie jest stosowana przez ponowne uruchomienie serwera językowego, bez pytania. Po dodaniu lub usunięciu rejestru, zainicjowaniu rejestru ze strony powitalnej, dodaniu lub usunięciu wtyczki, utworzeniu konfiguracji obszaru roboczego ze strony powitalnej oraz po Aggrega: Set authoring_release in .aggrega-config.yaml… tam, gdzie musi ono utworzyć plik, następuje ponowne uruchomienie, pokazywane w trakcie jako powiadomienie wskazujące plik, który serwer ma zaraz odczytać, i żadne z nich nie wywołuje ostrzeżenia: o tę zmianę poproszono. Tam, gdzie utworzenie konfiguracji obszaru roboczego samo uruchamia serwer językowy — żaden nie działał albo działał dla innego folderu — to uruchomienie odczytuje nowy plik i nie następuje drugie ponowne uruchomienie. Gdy serwer językowy uruchomiony po zmianie ją odczyta, własny komunikat kończący operację zostaje uzupełniony o jedno zdanie mówiące, że zmiana obowiązuje, zamiast drugiego powiadomienia; jeśli ponowne uruchomienie się nie powiodło lub nie działał żaden serwer językowy, który mógłby odczytać zmianę, zdanie jest pomijane, ponieważ zmiana jest wtedy w pliku, ale jeszcze nie obowiązuje. Ustawienie authoring_release kończy się otwarciem pliku, a nie zdaniem, więc niczego nie dodaje.