X-Git-Url: http://git.lukelau.me/?a=blobdiff_plain;f=src%2FLanguage%2FHaskell%2FLSP%2FTest.hs;h=495714c02e6bd3c28d09b0fd97eff1a7b7e766a3;hb=f1238f8db54eafbf0e3352140818875ad4cfd997;hp=f8f839460e56aefda12b0ae446c7b20ada70e9e1;hpb=df782ad008b840c0860173821226542e2e70f2e9;p=opengl.git diff --git a/src/Language/Haskell/LSP/Test.hs b/src/Language/Haskell/LSP/Test.hs index f8f8394..495714c 100644 --- a/src/Language/Haskell/LSP/Test.hs +++ b/src/Language/Haskell/LSP/Test.hs @@ -3,158 +3,202 @@ {-# LANGUAGE ScopedTypeVariables #-} {-# LANGUAGE ExistentialQuantification #-} +-- | +-- Module : Language.Haskell.LSP.Test +-- Description : A functional testing framework for LSP servers. +-- Maintainer : luke_lau@icloud.com +-- Stability : experimental +-- +-- A framework for testing at the JSON level. + module Language.Haskell.LSP.Test ( -- * Sessions runSession + , runSessionWithHandler + -- | A session representing one instance of launching and connecting to a server. + -- + -- You can send and receive messages to the server within 'Session' via 'getMessage', + -- 'sendRequest' and 'sendNotification'. + -- + -- @ + -- runSession \"path\/to\/root\/dir\" $ do + -- docItem <- getDocItem "Desktop/simple.hs" "haskell" + -- sendNotification TextDocumentDidOpen (DidOpenTextDocumentParams docItem) + -- diagnostics <- getMessage :: Session PublishDiagnosticsNotification + -- @ , Session -- * Sending , sendRequest , sendNotification + , sendRequest' + , sendNotification' + , sendResponse' -- * Receving - , getMessage + , request + , response + , notification + , loggingNotification + -- * Parsing + , many + , skipMany -- * Utilities , getDocItem , getDocUri ) where +import Control.Monad import Control.Monad.Trans.Class import Control.Monad.IO.Class import Control.Monad.Trans.Reader -import Control.Monad.Trans.State import Control.Concurrent import qualified Data.Text as T import qualified Data.Text.IO as T import Data.Aeson import qualified Data.ByteString.Lazy.Char8 as B import Data.Default -import Data.Maybe import Data.Proxy import System.Process import Language.Haskell.LSP.Types hiding (error, id) -import Compat +import Language.Haskell.LSP.Messages +import Language.Haskell.LSP.Test.Compat import System.IO import System.Directory import System.FilePath +import Language.Haskell.LSP.Test.Decoding import Language.Haskell.LSP.Test.Parsing +import Text.Parsec -data SessionContext = SessionContext - { - messageSema :: MVar B.ByteString, - serverIn :: Handle, - serverOut :: Handle, - rootDir :: FilePath - } - -newtype SessionState = SessionState - { - curReqId :: LspId - } -type Session = StateT SessionState (ReaderT SessionContext IO) - -runSession :: FilePath -> Session a -> IO () +-- | Starts a new session. +runSession :: FilePath -- ^ The filepath to the root directory for the session. + -> Session a -- ^ The session to run. + -> IO () runSession rootDir session = do - - absRootDir <- canonicalizePath rootDir - - (Just serverIn, Just serverOut, Nothing, serverProc) <- createProcess - (proc "hie" ["--lsp", "-d", "-l", "/tmp/hie-test.log"]) - { std_in = CreatePipe, std_out = CreatePipe } - - hSetBuffering serverIn NoBuffering - hSetBuffering serverOut NoBuffering - pid <- getProcessID - messageSema <- newEmptyMVar + absRootDir <- canonicalizePath rootDir - let initializeParams :: InitializeParams - initializeParams = InitializeParams (Just pid) + let initializeParams = InitializeParams (Just pid) (Just $ T.pack absRootDir) (Just $ filePathToUri absRootDir) Nothing def (Just TraceOff) - context = SessionContext messageSema serverIn serverOut absRootDir - initState = SessionState (IdInt 9) - -- | The session wrapped around initialize and shutdown calls - fullSession = do + runSessionWithHandler listenServer rootDir $ do + + -- Wrap the session around initialize and shutdown calls sendRequest (Proxy :: Proxy InitializeRequest) Initialize initializeParams - (ResponseMessage _ _ (Just (InitializeResponseCapabilities _)) e) <- getMessage - liftIO $ maybe (return ()) (putStrLn . ("Error when initializing: " ++) . show ) e + -- (ResponseMessage _ _ (Just (InitializeResponseCapabilities _)) e) <- getMessage + -- liftIO $ maybe (return ()) (putStrLn . ("Error when initializing: " ++) . show ) e + (RspInitialize _ ) <- response sendNotification Initialized InitializedParams - -- Run the actual thing + -- Run the actual test session sendNotification Exit ExitParams - forkIO $ listenServer context - _ <- runReaderT (runStateT fullSession initState) context +runSessionWithHandler :: (Handle -> Session ()) + -> FilePath + -> Session a + -> IO a +runSessionWithHandler serverHandler rootDir session = do + absRootDir <- canonicalizePath rootDir + + (Just serverIn, Just serverOut, Nothing, serverProc) <- createProcess + (proc "hie" ["--lsp", "-d", "-l", "/tmp/hie-test.log"]) + { std_in = CreatePipe, std_out = CreatePipe } + + hSetBuffering serverIn NoBuffering + hSetBuffering serverOut NoBuffering + + reqMap <- newMVar newRequestMap + messageChan <- newChan + meaninglessChan <- newChan + + let context = SessionContext serverIn absRootDir messageChan reqMap + initState = SessionState (IdInt 9) + + forkIO $ void $ runReaderT (runParserT (serverHandler serverOut) initState "" meaninglessChan) context + result <- runReaderT (runParserT session initState "" messageChan) context terminateProcess serverProc - return () + case result of + Right x -> return x + Left err -> error $ show err -- | Listens to the server output, makes sure it matches the record and -- signals any semaphores -listenServer :: SessionContext -> IO () -listenServer context = do - msgBytes <- getNextMessage (serverOut context) +listenServer :: Handle -> Session () +listenServer serverOut = do + msgBytes <- liftIO $ getNextMessage serverOut - case decode msgBytes :: Maybe LogMessageNotification of - -- Just print log and show messages - Just (NotificationMessage _ WindowLogMessage (LogMessageParams _ msg)) -> T.putStrLn msg - _ -> case decode msgBytes :: Maybe ShowMessageNotification of - Just (NotificationMessage _ WindowShowMessage (ShowMessageParams _ msg)) -> T.putStrLn msg - -- Give everything else for getMessage to handle - _ -> putMVar (messageSema context) msgBytes + context <- lift ask + reqMap <- liftIO $ readMVar $ requestMap context - listenServer context + liftIO $ writeChan (messageChan context) $ decodeFromServerMsg reqMap msgBytes + + listenServer serverOut -- | Sends a request to the server. +-- +-- @ +-- sendRequest (Proxy :: Proxy DocumentSymbolRequest) +-- TextDocumentDocumentSymbol +-- (DocumentSymbolParams docId) +-- @ sendRequest :: forall params resp. (ToJSON params, ToJSON resp, FromJSON resp) - => Proxy (RequestMessage ClientMethod params resp) - -> ClientMethod - -> params - -> Session LspId + => Proxy (RequestMessage ClientMethod params resp) -- ^ A proxy to provide more type information about the request. + -> ClientMethod -- ^ The request method. + -> params -- ^ The request parameters. + -> Session LspId -- ^ The id of the request that was sent. sendRequest _ method params = do - h <- serverIn <$> lift ask + id <- curReqId <$> getState + modifyState $ \c -> c { curReqId = nextId id } - id <- curReqId <$> get - get >>= \c -> put c { curReqId = nextId id } + let req = RequestMessage "2.0" id method params :: RequestMessage ClientMethod params resp - let msg = RequestMessage "2.0" id method params :: RequestMessage ClientMethod params resp - - liftIO $ B.hPut h $ addHeader (encode msg) + sendRequest' req return id where nextId (IdInt i) = IdInt (i + 1) nextId (IdString s) = IdString $ T.pack $ show $ read (T.unpack s) + 1 +sendRequest' :: (ToJSON a, ToJSON b) => RequestMessage ClientMethod a b -> Session () +sendRequest' req = do + -- Update the request map + reqMap <- requestMap <$> lift ask + liftIO $ modifyMVar_ reqMap (return . flip updateRequestMap req) + + sendMessage req + -- | Sends a notification to the server. -sendNotification :: ToJSON a => ClientMethod -> a -> Session () -sendNotification method params = do +sendNotification :: ToJSON a + => ClientMethod -- ^ The notification method. + -> a -- ^ The notification parameters. + -> Session () +sendNotification method params = + let notif = NotificationMessage "2.0" method params + in sendNotification' notif + +sendNotification' :: (ToJSON a, ToJSON b) => NotificationMessage a b -> Session () +sendNotification' = sendMessage + +sendResponse' :: ToJSON a => ResponseMessage a -> Session () +sendResponse' = sendMessage + +sendMessage :: ToJSON a => a -> Session () +sendMessage msg = do h <- serverIn <$> lift ask - - let msg = NotificationMessage "2.0" method params liftIO $ B.hPut h $ addHeader (encode msg) --- | Reads in a message from the server. -getMessage :: FromJSON a => Session a -getMessage = do - sema <- messageSema <$> lift ask - bytes <- liftIO $ takeMVar sema - return $ fromMaybe (error $ "Wrong type! Got: " ++ show bytes) (decode bytes) - -- | Reads in a text document as the first version. -getDocItem :: FilePath - -- ^ The path to the text document to read in. - -> String - -- ^ The language ID, e.g "haskell" for .hs files. +getDocItem :: FilePath -- ^ The path to the text document to read in. + -> String -- ^ The language ID, e.g "haskell" for .hs files. -> Session TextDocumentItem getDocItem file languageId = do context <- lift ask