{-# LANGUAGE BangPatterns #-} {-# LANGUAGE FlexibleContexts #-} {-# LANGUAGE GADTs #-} {-# LANGUAGE LambdaCase #-} {-# LANGUAGE NamedFieldPuns #-} {-# LANGUAGE OverloadedLabels #-} {-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE RankNTypes #-} {-# LANGUAGE RecordWildCards #-} {-# LANGUAGE RecursiveDo #-} {-# LANGUAGE ScopedTypeVariables #-} {-# LANGUAGE StandaloneDeriving #-} {-# LANGUAGE TypeInType #-} {-# OPTIONS_GHC -Wno-unticked-promoted-constructors #-} -- there's just so much! {-# OPTIONS_GHC -Wno-name-shadowing #-} -- So we can keep using the old prettyprinter modules (which have a better -- compatibility range) for now. {-# OPTIONS_GHC -Wno-deprecations #-} module Language.LSP.Server.Processing where import Colog.Core (LogAction (..), Severity (..), WithSeverity (..), cmap, (<&)) import Control.Concurrent.STM import qualified Control.Exception as E import Control.Lens hiding (Empty) import Control.Monad import Control.Monad.Except () import Control.Monad.IO.Class import Control.Monad.Reader import Control.Monad.State import Control.Monad.Trans.Except import Control.Monad.Writer.Strict import Data.Aeson hiding (Error, Null, Options) import Data.Aeson.Lens () import Data.Aeson.Types hiding (Error, Null, Options) import qualified Data.ByteString.Lazy as BSL import Data.Foldable (traverse_) import qualified Data.Functor.Product as P import Data.IxMap import Data.List import Data.List.NonEmpty (NonEmpty (..)) import qualified Data.Map.Strict as Map import Data.Maybe import Data.Monoid import Data.Row import Data.String (fromString) import qualified Data.Text as T import qualified Data.Text.Lazy.Encoding as TL import Data.Text.Prettyprint.Doc import qualified Language.LSP.Protocol.Lens as L import Language.LSP.Protocol.Message import Language.LSP.Protocol.Types import Language.LSP.Protocol.Utils.SMethodMap (SMethodMap) import qualified Language.LSP.Protocol.Utils.SMethodMap as SMethodMap import Language.LSP.Server.Core import Language.LSP.VFS as VFS import System.Exit data LspProcessingLog = VfsLog VfsLog | LspCore LspCoreLog | MessageProcessingError BSL.ByteString String | forall m . MissingHandler Bool (SClientMethod m) | ProgressCancel ProgressToken | Exiting deriving instance Show LspProcessingLog instance Pretty LspProcessingLog where pretty (VfsLog l) = pretty l pretty (LspCore l) = pretty l pretty (MessageProcessingError bs err) = vsep [ "LSP: incoming message parse error:" , pretty err , "when processing" , pretty (TL.decodeUtf8 bs) ] pretty (MissingHandler _ m) = "LSP: no handler for:" <+> pretty m pretty (ProgressCancel tid) = "LSP: cancelling action for token:" <+> pretty tid pretty Exiting = "LSP: Got exit, exiting" processMessage :: (m ~ LspM config) => LogAction m (WithSeverity LspProcessingLog) -> BSL.ByteString -> m () processMessage logger jsonStr = do pendingResponsesVar <- LspT $ asks $ resPendingResponses . resState join $ liftIO $ atomically $ fmap handleErrors $ runExceptT $ do val <- except $ eitherDecode jsonStr pending <- lift $ readTVar pendingResponsesVar msg <- except $ parseEither (parser pending) val lift $ case msg of FromClientMess m mess -> pure $ handle logger m mess FromClientRsp (P.Pair (ServerResponseCallback f) (Const !newMap)) res -> do writeTVar pendingResponsesVar newMap pure $ liftIO $ f (res ^. L.result) where parser :: ResponseMap -> Value -> Parser (FromClientMessage' (P.Product ServerResponseCallback (Const ResponseMap))) parser rm = parseClientMessage $ \i -> let (mhandler, newMap) = pickFromIxMap i rm in (\(P.Pair m handler) -> (m,P.Pair handler (Const newMap))) <$> mhandler handleErrors = either (\e -> logger <& MessageProcessingError jsonStr e `WithSeverity` Error) id -- | Call this to initialize the session initializeRequestHandler :: LogAction IO (WithSeverity LspProcessingLog) -> ServerDefinition config -> VFS -> (FromServerMessage -> IO ()) -> TMessage Method_Initialize -> IO (Maybe (LanguageContextEnv config)) initializeRequestHandler logger ServerDefinition{..} vfs sendFunc req = do let sendResp = sendFunc . FromServerRsp SMethod_Initialize handleErr (Left err) = do sendResp $ makeResponseError (req ^. L.id) err pure Nothing handleErr (Right a) = pure $ Just a flip E.catch (initializeErrorHandler $ sendResp . makeResponseError (req ^. L.id)) $ handleErr <=< runExceptT $ mdo let p = req ^. L.params rootDir = getFirst $ foldMap First [ p ^? L.rootUri . _L >>= uriToFilePath , p ^? L.rootPath . _Just . _L <&> T.unpack ] clientCaps = (p ^. L.capabilities) let initialWfs = case p ^. L.workspaceFolders of Just (InL xs) -> xs _ -> [] -- See Note [LSP configuration] configObject = lookForConfigSection configSection <$> (p ^. L.initializationOptions) initialConfig <- case configObject of Just o -> case parseConfig defaultConfig o of Right newConfig -> pure newConfig Left err -> do -- Warn not error here, since initializationOptions is pretty unspecified liftIO $ logger <& (LspCore $ ConfigurationParseError o err) `WithSeverity` Warning pure defaultConfig Nothing -> pure defaultConfig stateVars <- liftIO $ do resVFS <- newTVarIO (VFSData vfs mempty) resDiagnostics <- newTVarIO mempty resConfig <- newTVarIO initialConfig resWorkspaceFolders <- newTVarIO initialWfs resProgressData <- do progressNextId <- newTVarIO 0 progressCancel <- newTVarIO mempty pure ProgressData{..} resPendingResponses <- newTVarIO emptyIxMap resRegistrationsNot <- newTVarIO mempty resRegistrationsReq <- newTVarIO mempty resLspId <- newTVarIO 0 pure LanguageContextState{..} -- Call the 'duringInitialization' callback to let the server kick stuff up let env = LanguageContextEnv handlers configSection parseConfig configChanger sendFunc stateVars (p ^. L.capabilities) rootDir configChanger config = forward interpreter (onConfigChange config) handlers = transmuteHandlers interpreter (staticHandlers clientCaps) interpreter = interpretHandler initializationResult initializationResult <- ExceptT $ doInitialize env req let serverCaps = inferServerCapabilities clientCaps options handlers liftIO $ sendResp $ makeResponseMessage (req ^. L.id) (InitializeResult serverCaps (optServerInfo options)) pure env where makeResponseMessage rid result = TResponseMessage "2.0" (Just rid) (Right result) makeResponseError origId err = TResponseMessage "2.0" (Just origId) (Left err) initializeErrorHandler :: (ResponseError -> IO ()) -> E.SomeException -> IO (Maybe a) initializeErrorHandler sendResp e = do sendResp $ ResponseError (InR ErrorCodes_InternalError) msg Nothing pure Nothing where msg = T.pack $ unwords ["Error on initialize:", show e] -- | Infers the capabilities based on registered handlers, and sets the appropriate options. -- A provider should be set to Nothing if the server does not support it, unless it is a -- static option. inferServerCapabilities :: ClientCapabilities -> Options -> Handlers m -> ServerCapabilities inferServerCapabilities clientCaps o h = ServerCapabilities { _textDocumentSync = sync , _hoverProvider = supportedBool SMethod_TextDocumentHover , _completionProvider = completionProvider , _declarationProvider = supportedBool SMethod_TextDocumentDeclaration , _signatureHelpProvider = signatureHelpProvider , _definitionProvider = supportedBool SMethod_TextDocumentDefinition , _typeDefinitionProvider = supportedBool SMethod_TextDocumentTypeDefinition , _implementationProvider = supportedBool SMethod_TextDocumentImplementation , _referencesProvider = supportedBool SMethod_TextDocumentReferences , _documentHighlightProvider = supportedBool SMethod_TextDocumentDocumentHighlight , _documentSymbolProvider = supportedBool SMethod_TextDocumentDocumentSymbol , _codeActionProvider = codeActionProvider , _codeLensProvider = supported' SMethod_TextDocumentCodeLens $ CodeLensOptions (Just False) (supported SMethod_CodeLensResolve) , _documentFormattingProvider = supportedBool SMethod_TextDocumentFormatting , _documentRangeFormattingProvider = supportedBool SMethod_TextDocumentRangeFormatting , _documentOnTypeFormattingProvider = documentOnTypeFormattingProvider , _renameProvider = renameProvider , _documentLinkProvider = supported' SMethod_TextDocumentDocumentLink $ DocumentLinkOptions (Just False) (supported SMethod_DocumentLinkResolve) , _colorProvider = supportedBool SMethod_TextDocumentDocumentColor , _foldingRangeProvider = supportedBool SMethod_TextDocumentFoldingRange , _executeCommandProvider = executeCommandProvider , _selectionRangeProvider = supportedBool SMethod_TextDocumentSelectionRange , _callHierarchyProvider = supportedBool SMethod_TextDocumentPrepareCallHierarchy , _semanticTokensProvider = semanticTokensProvider , _workspaceSymbolProvider = supportedBool SMethod_WorkspaceSymbol , _workspace = Just workspace -- TODO: Add something for experimental , _experimental = Nothing :: Maybe Value -- TODO , _positionEncoding = Nothing , _notebookDocumentSync = Nothing , _linkedEditingRangeProvider = Nothing , _monikerProvider = Nothing , _typeHierarchyProvider = Nothing , _inlineValueProvider = Nothing , _inlayHintProvider = Nothing , _diagnosticProvider = Nothing } where -- | For when we just return a simple @true@/@false@ to indicate if we -- support the capability supportedBool = Just . InL . supported_b supported' m b | supported_b m = Just b | otherwise = Nothing supported :: forall m. SClientMethod m -> Maybe Bool supported = Just . supported_b supported_b :: forall m. SClientMethod m -> Bool supported_b m = case splitClientMethod m of IsClientNot -> SMethodMap.member m $ notHandlers h IsClientReq -> SMethodMap.member m $ reqHandlers h IsClientEither -> error "capabilities depend on custom method" singleton :: a -> [a] singleton x = [x] completionProvider | supported_b SMethod_TextDocumentCompletion = Just $ CompletionOptions { _triggerCharacters=map T.singleton <$> optCompletionTriggerCharacters o , _allCommitCharacters=map T.singleton <$> optCompletionAllCommitCharacters o , _resolveProvider=supported SMethod_CompletionItemResolve , _completionItem=Nothing , _workDoneProgress=Nothing } | otherwise = Nothing clientSupportsCodeActionKinds = isJust $ clientCaps ^? L.textDocument . _Just . L.codeAction . _Just . L.codeActionLiteralSupport . _Just codeActionProvider | supported_b SMethod_TextDocumentCodeAction = Just $ InR $ CodeActionOptions { _workDoneProgress = Nothing , _codeActionKinds = codeActionKinds (optCodeActionKinds o) , _resolveProvider = supported SMethod_CodeActionResolve } | otherwise = Just (InL False) codeActionKinds (Just ks) | clientSupportsCodeActionKinds = Just ks codeActionKinds _ = Nothing signatureHelpProvider | supported_b SMethod_TextDocumentSignatureHelp = Just $ SignatureHelpOptions Nothing (map T.singleton <$> optSignatureHelpTriggerCharacters o) (map T.singleton <$> optSignatureHelpRetriggerCharacters o) | otherwise = Nothing documentOnTypeFormattingProvider | supported_b SMethod_TextDocumentOnTypeFormatting , Just (first :| rest) <- optDocumentOnTypeFormattingTriggerCharacters o = Just $ DocumentOnTypeFormattingOptions (T.pack [first]) (Just (map (T.pack . singleton) rest)) | supported_b SMethod_TextDocumentOnTypeFormatting , Nothing <- optDocumentOnTypeFormattingTriggerCharacters o = error "documentOnTypeFormattingTriggerCharacters needs to be set if a documentOnTypeFormattingHandler is set" | otherwise = Nothing executeCommandProvider | supported_b SMethod_WorkspaceExecuteCommand , Just cmds <- optExecuteCommandCommands o = Just (ExecuteCommandOptions Nothing cmds) | supported_b SMethod_WorkspaceExecuteCommand , Nothing <- optExecuteCommandCommands o = error "executeCommandCommands needs to be set if a executeCommandHandler is set" | otherwise = Nothing clientSupportsPrepareRename = fromMaybe False $ clientCaps ^? L.textDocument . _Just . L.rename . _Just . L.prepareSupport . _Just renameProvider | clientSupportsPrepareRename , supported_b SMethod_TextDocumentRename , supported_b SMethod_TextDocumentPrepareRename = Just $ InR . RenameOptions Nothing . Just $ True | supported_b SMethod_TextDocumentRename = Just (InL True) | otherwise = Just (InL False) -- Always provide the default legend -- TODO: allow user-provided legend via 'Options', or at least user-provided types semanticTokensProvider = Just $ InL $ SemanticTokensOptions Nothing defaultSemanticTokensLegend semanticTokenRangeProvider semanticTokenFullProvider semanticTokenRangeProvider | supported_b SMethod_TextDocumentSemanticTokensRange = Just $ InL True | otherwise = Nothing semanticTokenFullProvider | supported_b SMethod_TextDocumentSemanticTokensFull = Just $ InR $ #delta .== supported SMethod_TextDocumentSemanticTokensFullDelta | otherwise = Nothing sync = case optTextDocumentSync o of Just x -> Just (InL x) Nothing -> Nothing workspace = #workspaceFolders .== workspaceFolder .+ #fileOperations .== Nothing workspaceFolder = supported' SMethod_WorkspaceDidChangeWorkspaceFolders $ -- sign up to receive notifications WorkspaceFoldersServerCapabilities (Just True) (Just (InR True)) -- | Invokes the registered dynamic or static handlers for the given message and -- method, as well as doing some bookkeeping. handle :: (m ~ LspM config) => LogAction m (WithSeverity LspProcessingLog) -> SClientMethod meth -> TClientMessage meth -> m () handle logger m msg = case m of SMethod_WorkspaceDidChangeWorkspaceFolders -> handle' logger (Just updateWorkspaceFolders) m msg SMethod_WorkspaceDidChangeConfiguration -> handle' logger (Just $ handleDidChangeConfiguration logger) m msg -- See Note [LSP configuration] SMethod_Initialized -> handle' logger (Just $ \_ -> requestConfigUpdate (cmap (fmap LspCore) logger)) m msg SMethod_TextDocumentDidOpen -> handle' logger (Just $ vfsFunc logger openVFS) m msg SMethod_TextDocumentDidChange -> handle' logger (Just $ vfsFunc logger changeFromClientVFS) m msg SMethod_TextDocumentDidClose -> handle' logger (Just $ vfsFunc logger closeVFS) m msg SMethod_WindowWorkDoneProgressCancel -> handle' logger (Just $ progressCancelHandler logger) m msg _ -> handle' logger Nothing m msg handle' :: forall m t (meth :: Method ClientToServer t) config . (m ~ LspM config) => LogAction m (WithSeverity LspProcessingLog) -> Maybe (TClientMessage meth -> m ()) -- ^ An action to be run before invoking the handler, used for -- bookkeeping stuff like the vfs etc. -> SClientMethod meth -> TClientMessage meth -> m () handle' logger mAction m msg = do maybe (return ()) (\f -> f msg) mAction dynReqHandlers <- getsState resRegistrationsReq dynNotHandlers <- getsState resRegistrationsNot env <- getLspEnv let Handlers{reqHandlers, notHandlers} = resHandlers env let mkRspCb :: TRequestMessage (m1 :: Method ClientToServer Request) -> Either ResponseError (MessageResult m1) -> IO () mkRspCb req (Left err) = runLspT env $ sendToClient $ FromServerRsp (req ^. L.method) $ TResponseMessage "2.0" (Just (req ^. L.id)) (Left err) mkRspCb req (Right rsp) = runLspT env $ sendToClient $ FromServerRsp (req ^. L.method) $ TResponseMessage "2.0" (Just (req ^. L.id)) (Right rsp) case splitClientMethod m of IsClientNot -> case pickHandler dynNotHandlers notHandlers of Just h -> liftIO $ h msg Nothing | SMethod_Exit <- m -> exitNotificationHandler logger msg | otherwise -> do reportMissingHandler IsClientReq -> case pickHandler dynReqHandlers reqHandlers of Just h -> liftIO $ h msg (mkRspCb msg) Nothing | SMethod_Shutdown <- m -> liftIO $ shutdownRequestHandler msg (mkRspCb msg) | otherwise -> do let errorMsg = T.pack $ unwords ["lsp:no handler for: ", show m] err = ResponseError (InR ErrorCodes_MethodNotFound) errorMsg Nothing sendToClient $ FromServerRsp (msg ^. L.method) $ TResponseMessage "2.0" (Just (msg ^. L.id)) (Left err) IsClientEither -> case msg of NotMess noti -> case pickHandler dynNotHandlers notHandlers of Just h -> liftIO $ h noti Nothing -> reportMissingHandler ReqMess req -> case pickHandler dynReqHandlers reqHandlers of Just h -> liftIO $ h req (mkRspCb req) Nothing -> do let errorMsg = T.pack $ unwords ["lsp:no handler for: ", show m] err = ResponseError (InR ErrorCodes_MethodNotFound) errorMsg Nothing sendToClient $ FromServerRsp (req ^. L.method) $ TResponseMessage "2.0" (Just (req ^. L.id)) (Left err) where -- | Checks to see if there's a dynamic handler, and uses it in favour of the -- static handler, if it exists. pickHandler :: RegistrationMap t -> SMethodMap (ClientMessageHandler IO t) -> Maybe (Handler IO meth) pickHandler dynHandlerMap staticHandler = case (SMethodMap.lookup m dynHandlerMap, SMethodMap.lookup m staticHandler) of (Just (P.Pair _ (ClientMessageHandler h)), _) -> Just h (Nothing, Just (ClientMessageHandler h)) -> Just h (Nothing, Nothing) -> Nothing -- '$/' notifications should/could be ignored by server. -- Don't log errors in that case. -- See https://microsoft.github.io/language-server-protocol/specifications/specification-current/#-notifications-and-requests. reportMissingHandler :: m () reportMissingHandler = let optional = isOptionalMethod (SomeMethod m) in logger <& MissingHandler optional m `WithSeverity` if optional then Warning else Error progressCancelHandler :: (m ~ LspM config) => LogAction m (WithSeverity LspProcessingLog) -> TMessage Method_WindowWorkDoneProgressCancel -> m () progressCancelHandler logger (TNotificationMessage _ _ (WorkDoneProgressCancelParams tid)) = do pdata <- getsState (progressCancel . resProgressData) case Map.lookup tid pdata of Nothing -> return () Just cancelAction -> do logger <& ProgressCancel tid `WithSeverity` Debug liftIO cancelAction exitNotificationHandler :: (MonadIO m) => LogAction m (WithSeverity LspProcessingLog) -> Handler m Method_Exit exitNotificationHandler logger _ = do logger <& Exiting `WithSeverity` Info liftIO exitSuccess -- | Default Shutdown handler shutdownRequestHandler :: Handler IO Method_Shutdown shutdownRequestHandler _req k = do k $ Right Null -- | Try to find the configuration section in an object that might represent "all" the settings. -- The heuristic we use is to look for a property with the right name, and use that if we find -- it. Otherwise we fall back to the whole object. -- See Note [LSP configuration] lookForConfigSection :: T.Text -> Value -> Value lookForConfigSection section (Object o) | Just s' <- o ^. at (fromString $ T.unpack section) = s' lookForConfigSection _ o = o -- | Handle a workspace/didChangeConfiguration request. handleDidChangeConfiguration :: (m ~ LspM config) => LogAction m (WithSeverity LspProcessingLog) -> TMessage Method_WorkspaceDidChangeConfiguration -> m () handleDidChangeConfiguration logger req = do section <- LspT $ asks resConfigSection -- See Note [LSP configuration] -- There are a few cases: -- 1. Client supports `workspace/configuration` and sends nothing in `workspace/didChangeConfiguration` -- Then we will fail the first attempt and succeed the second one. -- 2. Client does not support `workspace/configuration` and sends updated config in `workspace/didChangeConfiguration`. -- Then we will succeed the first attempt and fail (or in fact do nothing in) the second one. -- 3. Client supports `workspace/configuration` and sends updated config in `workspace/didChangeConfiguration`. -- Then both will succeed, which is a bit redundant but not a big deal. tryChangeConfig (cmap (fmap LspCore) logger) (lookForConfigSection section $ req ^. L.params . L.settings) requestConfigUpdate (cmap (fmap LspCore) logger) vfsFunc :: forall m n a config . (m ~ LspM config, n ~ WriterT [WithSeverity VfsLog] (State VFS)) => LogAction m (WithSeverity LspProcessingLog) -> (LogAction n (WithSeverity VfsLog) -> a -> n ()) -> a -> m () vfsFunc logger modifyVfs req = do -- This is an intricate dance. We want to run the VFS functions essentially in STM, that's -- what 'stateState' does. But we also want them to log. We accomplish this by exfiltrating -- the logs through the return value of 'stateState' and then re-logging them. -- We therefore have to use the stupid approach of accumulating the logs in Writer inside -- the VFS functions. They don't log much so for now we just use [Log], but we could use -- DList here if we're worried about performance. logs <- stateState resVFS $ \(VFSData vfs rm) -> let (ls, vfs') = flip runState vfs $ execWriterT $ modifyVfs innerLogger req in (ls, VFSData vfs' rm) traverse_ (\l -> logger <& fmap VfsLog l) logs where innerLogger :: LogAction n (WithSeverity VfsLog) innerLogger = LogAction $ \m -> tell [m] -- | Updates the list of workspace folders updateWorkspaceFolders :: TMessage Method_WorkspaceDidChangeWorkspaceFolders -> LspM config () updateWorkspaceFolders (TNotificationMessage _ _ params) = do let toRemove = params ^. L.event . L.removed toAdd = params ^. L.event . L.added newWfs oldWfs = foldr delete oldWfs toRemove <> toAdd modifyState resWorkspaceFolders newWfs -- ---------------------------------------------------------------------