Introduzione

I Language Server Protocol (LSP) sono uno strumento attraverso il quale all'interno degli editor di testo vengono messe a disposizioni varie funzionalità per la scrittura del codice sorgente. Sia che si tratti di linguaggi di programmazione o di markup, si avranno a disposizione funzionalità di:

auto completamento;
formattazione del testo;
riferimenti alla documentazione ufficiale del linguaggio;
segnalazione di errori;
e altro.

Contrariamente ad altri editor di testo Helix non implementa un sistema di plugin per l'aggiunta di funzionalità supplementari come gli LSP. Questo ha lo svantaggio di non avere una procedura standard di installazione, ma sarà necessario installare manualmente i pacchetti dal gestore pacchetti di sistema o del linguaggio stesso.
In questa guida vengono mostrati gli strumenti che Helix mette a disposizione per monitorare la presenza degli LSP supportati e alcuni esempi di installazione.

Monitoraggio LSP

Viene qui trattato il principale strumento per individuare i pacchetti da installare che però, a seconda dei casi, potrebbe non dare risposte esaustive. In tal caso consultare le pagine Language Server Configurations e Debugger Configurations.

Helix mette a disposizione il comando hx --health che come output restituisce un lungo elenco in cui per ogni singolo linguaggio viene mostrato quali LSP, debugger e funzionalità siano supportate.
In particolare è possibile direzionare il comando su uno specifico linguaggio nella forma:

hx --health NOME_LINGUAGGIO

Ad esempio per valutare lo stato relativo al linguaggio python il comando diviene:

hx --health python

L'output sarà:

Configured language servers:
  ✘ pylsp: 'pylsp' not found in $PATH
Configured debug adapter: None
Configured formatter: None
Highlight queries: ✓
Textobject queries: ✓
Indent queries: ✓

dove il significato dei simboli è così riassumibile:

Simbolo	Significato
`✓`	pieno supporto
`None`	totale mancaza
`✘`	supportato ma necessita installazione

Nell'esempio di cui sopra, una volta installato il pacchetto relativo a pylsp, eseguendo nuovamente il comando si otterrà:

Configured language servers:
  ✓ pylsp: /usr/bin/pylsp
Configured debug adapter: None
Configured formatter: None
Highlight queries: ✓
Textobject queries: ✓
Indent queries: ✓

dove la riga che mostrava il simbolo ✘ e il messaggio di errore, adesso riporta la spunta e il percorso al file eseguibile.

Talvolta può tuttavia capitare che nonostante i pacchetti siano correttamente installati, Helix non riesca a localizzare l'eseguibile continuando a riportare l'errore not found in $PATH. In tal caso sarà necessario aggiungere manualmente un link simbolico vedere esempio.

C/C++

Installare il pacchetto clangd:

sudo apt install clangd

Per aggiungere funzionalità di debugging vedere il paragrafo dedicato.

Go

La procedura si riferisce a un'installazione del linguaggio Go effettuata con i pacchetti presenti nei repository di Ubuntu.

Installare LSP e debugger tramite pacchetti .deb:
```
sudo apt install gopls delve
```
Installare il linter tramite pacchetto .snap:
```
sudo snap install golangci-lint --classic
```
Eseguendo il comando hx --health go si noterà che il percorso al file eseguibile di golangci non viene trovato. Sarà necessario aggiungere manualmente un link simbolico. Spostarsi nella directory /snap/bin:
```
cd /snap/bin
```

Digitare il comando:

sudo ln -s golangci-lint golangci-lint-langserver

Markdown

Installare il pacchetto marksman:
```
sudo snap install marksman
```
Il comando hx --health markdown segnalerà che non viene trovato il percorso a markdown-oxide. Spostarsi quindi nella directory /snap/bin:
```
cd /snap/bin
```
Creare il link simbolico:
```
sudo ln -s marksman markdown-oxide 
```

Python

Le funzionalità LSP sono state testate in una sessione in ambiente virtuale.
È sufficiente installare pylsp:

sudo apt install python3-pylsp

Da notare che non è l'unico software disponibile, a seconda delle esigenze possono essere installate eventuali alternative.

Rust

La procedura fa riferimento a una installazione di Rust tramite script del sito ufficiale.

Installare rust-analyzer attraverso rustup:
```
rustup component add rust-analyzer
```

Per aggiungere funzionalità di debugging vedere il paragrafo dedicato.

Debug

lldb è il debugger utilizzato per un gruppo di noti linguaggi compilati (C, C++, Rust, Zig..).

Viene qui installata la versione più recente, la 18:
```
sudo apt install lldb-18
```
Se si esegue ad esempio il comando hx --health rust, si noterà che il percorso al file eseguibile di lldb non viene trovato. Sarà necessario aggiungere manualmente un link simbolico. Spostarsi nella directory ospitante il file eseguibile:
```
cd $(dirname $(which lldb-18))
```
Creare link simbolico a lldb-dap:
```
sudo ln -s lldb-dap-18 lldb-dap
```

Ulteriori risorse

CategoryProgrammazione CategoryProduttivita