Language.Haskell.LSP.Core

Documentation

handleMessage :: Show c => InitializeCallback c -> TVar (LanguageContextData c) -> ByteString -> ByteString -> IO ()

data LanguageContextData a

state used by the LSP dispatcher to manage the message loop

Constructors

LanguageContextData

Fields

• resSeqDebugContextData :: !Int
• resHandlers :: !Handlers
• resOptions :: !Options
• resSendResponse :: !SendFunc
• resVFS :: !VFS
• resDiagnostics :: !DiagnosticStore
• resConfig :: !(Maybe a)
• resLspId :: !(TVar Int)
• resLspFuncs :: LspFuncs a
• resCaptureFile :: !(Maybe FilePath)
• resWorkspaceFolders :: ![WorkspaceFolder]

type Handler b = b -> IO ()

The Handler type captures a function that receives local read-only state a, a function to send a reply message once encoded as a ByteString, and a received message of type b

type InitializeCallback c = (DidChangeConfigurationNotification -> Either Text c, LspFuncs c -> IO (Maybe ResponseError))

The function in the LSP process that is called once the initialize message is received. Message processing will only continue once this returns, so it should create whatever processes are needed.

data LspFuncs c

Returned to the server on startup, providing ways to interact with the client.

Constructors

LspFuncs

Fields

• clientCapabilities :: !ClientCapabilities
• config :: !(IO (Maybe c))

  Derived from the DidChangeConfigurationNotification message via a server-provided function.

• sendFunc :: !SendFunc
• getVirtualFileFunc :: !(Uri -> IO (Maybe VirtualFile))
• publishDiagnosticsFunc :: !PublishDiagnosticsFunc
• flushDiagnosticsBySourceFunc :: !FlushDiagnosticsBySourceFunc
• getNextReqId :: !(IO LspId)
• rootPath :: !(Maybe FilePath)
• getWorkspaceFolders :: !(IO (Maybe [WorkspaceFolder]))

type SendFunc = FromServerMessage -> IO ()

A function to send a message to the client

data Handlers

Callbacks from the language server to the language handler

Constructors

Handlers

Fields

• hoverHandler :: !(Maybe (Handler HoverRequest))
• completionHandler :: !(Maybe (Handler CompletionRequest))
• completionResolveHandler :: !(Maybe (Handler CompletionItemResolveRequest))
• signatureHelpHandler :: !(Maybe (Handler SignatureHelpRequest))
• definitionHandler :: !(Maybe (Handler DefinitionRequest))
• typeDefinitionHandler :: !(Maybe (Handler TypeDefinitionRequest))
• implementationHandler :: !(Maybe (Handler ImplementationRequest))
• referencesHandler :: !(Maybe (Handler ReferencesRequest))
• documentHighlightHandler :: !(Maybe (Handler DocumentHighlightRequest))
• documentSymbolHandler :: !(Maybe (Handler DocumentSymbolRequest))
• workspaceSymbolHandler :: !(Maybe (Handler WorkspaceSymbolRequest))
• codeActionHandler :: !(Maybe (Handler CodeActionRequest))
• codeLensHandler :: !(Maybe (Handler CodeLensRequest))
• codeLensResolveHandler :: !(Maybe (Handler CodeLensResolveRequest))
• documentColorHandler :: !(Maybe (Handler DocumentColorRequest))
• colorPresentationHandler :: !(Maybe (Handler ColorPresentationRequest))
• documentFormattingHandler :: !(Maybe (Handler DocumentFormattingRequest))
• documentRangeFormattingHandler :: !(Maybe (Handler DocumentRangeFormattingRequest))
• documentTypeFormattingHandler :: !(Maybe (Handler DocumentOnTypeFormattingRequest))
• renameHandler :: !(Maybe (Handler RenameRequest))
• foldingRangeHandler :: !(Maybe (Handler FoldingRangeRequest))
• documentLinkHandler :: !(Maybe (Handler DocumentLinkRequest))
• documentLinkResolveHandler :: !(Maybe (Handler DocumentLinkResolveRequest))
• executeCommandHandler :: !(Maybe (Handler ExecuteCommandRequest))
• willSaveWaitUntilTextDocHandler :: !(Maybe (Handler WillSaveWaitUntilTextDocumentRequest))
• didChangeConfigurationParamsHandler :: !(Maybe (Handler DidChangeConfigurationNotification))
• didOpenTextDocumentNotificationHandler :: !(Maybe (Handler DidOpenTextDocumentNotification))
• didChangeTextDocumentNotificationHandler :: !(Maybe (Handler DidChangeTextDocumentNotification))
• didCloseTextDocumentNotificationHandler :: !(Maybe (Handler DidCloseTextDocumentNotification))
• didSaveTextDocumentNotificationHandler :: !(Maybe (Handler DidSaveTextDocumentNotification))
• didChangeWatchedFilesNotificationHandler :: !(Maybe (Handler DidChangeWatchedFilesNotification))
• didChangeWorkspaceFoldersNotificationHandler :: !(Maybe (Handler DidChangeWorkspaceFoldersNotification))
• initializedHandler :: !(Maybe (Handler InitializedNotification))
• willSaveTextDocumentNotificationHandler :: !(Maybe (Handler WillSaveTextDocumentNotification))
• cancelNotificationHandler :: !(Maybe (Handler CancelNotification))
• responseHandler :: !(Maybe (Handler BareResponseMessage))
• initializeRequestHandler :: !(Maybe (Handler InitializeRequest))
• exitNotificationHandler :: !(Maybe (Handler ExitNotification))

Instances

Default Handlers

Defined in Language.Haskell.LSP.Core

Methods

def :: Handlers

data Options

Language Server Protocol options supported by the given language server. These are automatically turned into capabilities reported to the client during initialization.

Constructors

Options

Fields

• textDocumentSync :: Maybe TextDocumentSyncOptions
• completionProvider :: Maybe CompletionOptions
• signatureHelpProvider :: Maybe SignatureHelpOptions
• typeDefinitionProvider :: Maybe GotoOptions
• implementationProvider :: Maybe GotoOptions
• codeLensProvider :: Maybe CodeLensOptions
• documentOnTypeFormattingProvider :: Maybe DocumentOnTypeFormattingOptions
• documentLinkProvider :: Maybe DocumentLinkOptions
• colorProvider :: Maybe ColorOptions
• foldingRangeProvider :: Maybe FoldingRangeOptions
• executeCommandProvider :: Maybe ExecuteCommandOptions

Instances

Default Options

Defined in Language.Haskell.LSP.Core

Methods

def :: Options

defaultLanguageContextData :: Handlers -> Options -> LspFuncs c -> TVar Int -> SendFunc -> Maybe FilePath -> LanguageContextData c

makeResponseMessage :: RequestMessage ClientMethod req resp -> resp -> ResponseMessage resp

makeResponseError :: LspIdRsp -> ResponseError -> ResponseMessage ()

setupLogger :: Maybe FilePath -> [String] -> Priority -> IO ()

===============================================================

utility

Logger

sendErrorResponseS :: SendFunc -> LspIdRsp -> ErrorCode -> Text -> IO ()

sendErrorLogS :: SendFunc -> Text -> IO ()

sendErrorShowS :: SendFunc -> Text -> IO ()

reverseSortEdit :: WorkspaceEdit -> WorkspaceEdit

The changes in a workspace edit should be applied from the end of the file toward the start. Sort them into this order.