lsp

Documentation

Overview

Package lsp provides a pluggable language server protocol implementation, as well as utilities to make building language servers easier.

Index

• func UTF16Len(s []byte) int
• type File
  • func (f *File) ApplyChange(change types.TextDocumentContentChangeEvent) error
  • func (f File) Bytes() []byte
  • func (f *File) GetOffset(p types.Position) (int, error)
  • func (f *File) GetPosition(offset int) (types.Position, error)
  • func (f *File) Reset(s []byte)
• type Handler
• type NopHandler
  • func (NopHandler) Capabilities() types.ServerCapabilities
  • func (NopHandler) HandleChange(types.DidChangeTextDocumentParams) error
  • func (NopHandler) HandleClose(types.DidCloseTextDocumentParams) error
  • func (NopHandler) HandleDefinition(types.DefinitionParams) ([]types.Location, error)
  • func (NopHandler) HandleOpen(types.DidOpenTextDocumentParams) error
  • func (NopHandler) HandleReferences(types.ReferenceParams) ([]types.Location, error)
• type Server
  • func (s *Server) Run() error

Functions

func UTF16Len

func UTF16Len(s []byte) int

UTF16Len returns the number of UTF-16 code units required to encode the given UTF-8 byte slice.

Types

type File

type File struct {
	// contains filtered or unexported fields
}

File is a representation of a text file that can be modified by LSP text document change events. It keeps track of line breaks to allow for efficient conversion between byte offsets and LSP positions.

func (*File) ApplyChange

func (f *File) ApplyChange(change types.TextDocumentContentChangeEvent) error

ApplyChange applies the given change to the file content.

func (File) Bytes

func (f File) Bytes() []byte

Bytes returns the raw bytes of the file.

func (*File) GetOffset

func (f *File) GetOffset(p types.Position) (int, error)

GetOffset returns the byte offset for the given LSP protocol position.

func (*File) GetPosition

func (f *File) GetPosition(offset int) (types.Position, error)

GetPosition returns the LSP protocol position for the given byte offset.

func (*File) Reset

func (f *File) Reset(s []byte)

Reset initializes the file with the given content.

type Handler

type Handler interface {
	Capabilities() types.ServerCapabilities
	HandleOpen(params types.DidOpenTextDocumentParams) error
	HandleClose(params types.DidCloseTextDocumentParams) error
	HandleChange(params types.DidChangeTextDocumentParams) error
	HandleDefinition(params types.DefinitionParams) ([]types.Location, error)
	HandleReferences(params types.ReferenceParams) ([]types.Location, error)
}

Handler is an interface for handling LSP requests.

type NopHandler

type NopHandler struct{}

NopHandler can be embedded in a struct to provide no-op implementations of ununsed Handler methods.

func (NopHandler) Capabilities

func (NopHandler) Capabilities() types.ServerCapabilities

Capabilities implements Handler.

func (NopHandler) HandleChange

func (NopHandler) HandleChange(types.DidChangeTextDocumentParams) error

HandleChange implements Handler.

func (NopHandler) HandleClose

func (NopHandler) HandleClose(types.DidCloseTextDocumentParams) error

HandleClose implements Handler.

func (NopHandler) HandleDefinition

func (NopHandler) HandleDefinition(types.DefinitionParams) ([]types.Location, error)

HandleDefinition implements Handler.

func (NopHandler) HandleOpen

func (NopHandler) HandleOpen(types.DidOpenTextDocumentParams) error

HandleOpen implements Handler.

func (NopHandler) HandleReferences

func (NopHandler) HandleReferences(types.ReferenceParams) ([]types.Location, error)

HandleReferences implements Handler.

type Server

type Server struct {
	Reader     io.Reader
	Writer     io.Writer
	Handler    Handler
	ServerInfo types.ServerInfo
}

Server is an LSP server. It handles the I/O and delegates handling of requests to a Handler.

func (*Server) Run

func (s *Server) Run() error

Run is a blocking function that reads from the server's Reader, processes requests, and writes responses to the server's Writer. It returns an error if the server stops unexpectedly.