Valence.Lsp (valence v1.0.0)

Copy Markdown View Source

Servidor LSP do Valence: JSON-RPC 2.0 sobre stdio com framing Content-Length.

O estado guarda os documentos abertos e um cache do índice do projeto. O índice é reconstruído quando o cliente avisa que um documento mudou; a raiz vem do initialize (rootUri/rootPath) ou do diretório atual.

O núcleo é handle/2, sem IO: recebe o estado e uma mensagem decodificada e devolve o novo estado mais a lista de mensagens a enviar. Assim o protocolo é testável sem abrir processos nem pipes; run/0 só faz o laço de leitura e escrita em stdio.

Posições: o Valence.Span é 1-based e o LSP é 0-based com caractere em unidades UTF-16. O tokenizer do Elixir conta coluna em code points (um acento é uma coluna, o emoji é uma coluna), então a conversão UTF-16 <-> code point mora aqui, nas duas direções.

Summary

Functions

Processa uma mensagem decodificada.

Estado inicial; a raiz padrão é o diretório atual.

Lê uma mensagem do dispositivo, com framing Content-Length.

Roda o servidor em stdio até o cliente fechar o pipe ou mandar exit.

Converte um URI file:// em caminho local, com percent-decode.

Escreve uma mensagem no dispositivo, com framing Content-Length.

Functions

handle(state, message)

@spec handle(Valence.Lsp.State.t(), term()) :: {Valence.Lsp.State.t(), [map()]}

Processa uma mensagem decodificada.

Devolve {novo_estado, respostas}. Mensagem que não é objeto, sem método ou com params fora do formato é ignorada em vez de derrubar o servidor.

new_state(root \\ nil)

@spec new_state(String.t() | nil) :: Valence.Lsp.State.t()

Estado inicial; a raiz padrão é o diretório atual.

read_message(device \\ :stdio)

@spec read_message(term()) :: {:ok, map()} | :eof | {:error, term()}

Lê uma mensagem do dispositivo, com framing Content-Length.

Devolve {:ok, mapa}, :eof no fim do stream ou {:error, motivo} quando o framing/JSON está quebrado. Não escreve nada e não levanta exceção.

run()

@spec run() :: :ok

Roda o servidor em stdio até o cliente fechar o pipe ou mandar exit.

uri_to_path(arg1)

@spec uri_to_path(String.t() | nil) :: String.t() | nil

Converte um URI file:// em caminho local, com percent-decode.

write_message(device \\ :stdio, message)

@spec write_message(term(), map()) :: :ok

Escreve uma mensagem no dispositivo, com framing Content-Length.