X-Git-Url: https://git.lukelau.me/?a=blobdiff_plain;f=src%2FLanguage%2FHaskell%2FLSP%2FTest%2FParsing.hs;h=acd458c77a76df9e65dfb4e8ec1952681ff89969;hb=8802accf03b0bd9f063e5563ed769b23c6750fd8;hp=c29e0f3a2a44b69d875b823cea21d42a183c9fd5;hpb=93bbb70d531238c46a28eb356a68c3648b88082f;p=lsp-test.git diff --git a/src/Language/Haskell/LSP/Test/Parsing.hs b/src/Language/Haskell/LSP/Test/Parsing.hs index c29e0f3..acd458c 100644 --- a/src/Language/Haskell/LSP/Test/Parsing.hs +++ b/src/Language/Haskell/LSP/Test/Parsing.hs @@ -1,39 +1,219 @@ +{-# LANGUAGE MultiParamTypeClasses #-} +{-# LANGUAGE EmptyCase #-} +{-# LANGUAGE TypeOperators #-} +{-# LANGUAGE ScopedTypeVariables #-} +{-# LANGUAGE PolyKinds #-} +{-# LANGUAGE KindSignatures #-} +{-# LANGUAGE DataKinds #-} +{-# LANGUAGE GADTs #-} +{-# LANGUAGE LambdaCase #-} +{-# LANGUAGE RankNTypes #-} {-# LANGUAGE OverloadedStrings #-} -module Language.Haskell.LSP.Test.Parsing where - -import qualified Data.ByteString.Lazy.Char8 as B -import System.IO - -getAllMessages :: Handle -> IO [B.ByteString] -getAllMessages h = do - done <- hIsEOF h - if done - then return [] - else do - msg <- getNextMessage h - - (msg :) <$> getAllMessages h - --- | Fetches the next message bytes based on --- the Content-Length header -getNextMessage :: Handle -> IO B.ByteString -getNextMessage h = do - headers <- getHeaders h - case read . init <$> lookup "Content-Length" headers of - Nothing -> error "Couldn't read Content-Length header" - Just size -> B.hGet h size - -addHeader :: B.ByteString -> B.ByteString -addHeader content = B.concat - [ "Content-Length: " - , B.pack $ show $ B.length content - , "\r\n" - , "\r\n" - , content - ] - -getHeaders :: Handle -> IO [(String, String)] -getHeaders h = do - l <- hGetLine h - let (name, val) = span (/= ':') l - if null val then return [] else ((name, drop 2 val) :) <$> getHeaders h + +module Language.Haskell.LSP.Test.Parsing + ( -- $receiving + satisfy + , satisfyMaybe + , message + , responseForId + , customRequest + , customNotification + , anyRequest + , anyResponse + , anyNotification + , anyMessage + , loggingNotification + , publishDiagnosticsNotification + ) where + +import Control.Applicative +import Control.Concurrent +import Control.Lens +import Control.Monad.IO.Class +import Control.Monad +import Data.Conduit.Parser hiding (named) +import qualified Data.Conduit.Parser (named) +import Data.GADT.Compare +import qualified Data.Text as T +import Data.Typeable +import Language.Haskell.LSP.Types +import Language.Haskell.LSP.Test.Session + +-- $receiving +-- To receive a message, specify the method of the message to expect: +-- +-- @ +-- msg1 <- message SWorkspaceApplyEdit +-- msg2 <- message STextDocumentHover +-- @ +-- +-- 'Language.Haskell.LSP.Test.Session' is actually just a parser +-- that operates on messages under the hood. This means that you +-- can create and combine parsers to match speicifc sequences of +-- messages that you expect. +-- +-- For example, if you wanted to match either a definition or +-- references request: +-- +-- > defOrImpl = message STextDocumentDefinition +-- > <|> message STextDocumentReferences +-- +-- If you wanted to match any number of telemetry +-- notifications immediately followed by a response: +-- +-- @ +-- logThenDiags = +-- skipManyTill (message STelemetryEvent) +-- anyResponse +-- @ + +-- | Consumes and returns the next message, if it satisfies the specified predicate. +-- +-- @since 0.5.2.0 +satisfy :: (FromServerMessage -> Bool) -> Session FromServerMessage +satisfy pred = satisfyMaybe (\msg -> if pred msg then Just msg else Nothing) + +-- | Consumes and returns the result of the specified predicate if it returns `Just`. +-- +-- @since 0.6.1.0 +satisfyMaybe :: (FromServerMessage -> Maybe a) -> Session a +satisfyMaybe pred = satisfyMaybeM (pure . pred) + +satisfyMaybeM :: (FromServerMessage -> Session (Maybe a)) -> Session a +satisfyMaybeM pred = do + + skipTimeout <- overridingTimeout <$> get + timeoutId <- getCurTimeoutId + unless skipTimeout $ do + chan <- asks messageChan + timeout <- asks (messageTimeout . config) + void $ liftIO $ forkIO $ do + threadDelay (timeout * 1000000) + writeChan chan (TimeoutMessage timeoutId) + + x <- Session await + + unless skipTimeout (bumpTimeoutId timeoutId) + + modify $ \s -> s { lastReceivedMessage = Just x } + + res <- pred x + + case res of + Just a -> do + logMsg LogServer x + return a + Nothing -> empty + +named :: T.Text -> Session a -> Session a +named s (Session x) = Session (Data.Conduit.Parser.named s x) + +mEq :: SServerMethod m1 -> SServerMethod m2 -> Maybe (m1 :~~: m2) +mEq m1 m2 = case (splitServerMethod m1, splitServerMethod m2) of + (IsServerNot, IsServerNot) -> do + Refl <- geq m1 m2 + pure HRefl + (IsServerReq, IsServerReq) -> do + Refl <- geq m1 m2 + pure HRefl + _ -> Nothing + +mEqClient :: SClientMethod m1 -> SClientMethod m2 -> Maybe (m1 :~~: m2) +mEqClient m1 m2 = case (splitClientMethod m1, splitClientMethod m2) of + (IsClientNot, IsClientNot) -> do + Refl <- geq m1 m2 + pure HRefl + (IsClientReq, IsClientReq) -> do + Refl <- geq m1 m2 + pure HRefl + _ -> Nothing + +-- | Matches non-custom messages +message :: SServerMethod m -> Session (ServerMessage m) +message m1 = named (T.pack $ show m1) $ satisfyMaybe $ \case + FromServerMess m2 msg -> do + HRefl <- mEq m1 m2 + pure msg + _ -> Nothing + +customRequest :: T.Text -> Session (ServerMessage (CustomMethod :: Method FromServer Request)) +customRequest m = named m $ satisfyMaybe $ \case + FromServerMess m1 msg -> case splitServerMethod m1 of + IsServerEither -> case msg of + ReqMess _ | m1 == SCustomMethod m -> Just msg + _ -> Nothing + _ -> Nothing + _ -> Nothing + +customNotification :: T.Text -> Session (ServerMessage (CustomMethod :: Method FromServer Notification)) +customNotification m = named m $ satisfyMaybe $ \case + FromServerMess m1 msg -> case splitServerMethod m1 of + IsServerEither -> case msg of + NotMess _ | m1 == SCustomMethod m -> Just msg + _ -> Nothing + _ -> Nothing + _ -> Nothing + +-- | Matches if the message is a notification. +anyNotification :: Session FromServerMessage +anyNotification = named "Any notification" $ satisfy $ \case + FromServerMess m msg -> case splitServerMethod m of + IsServerNot -> True + IsServerEither -> case msg of + NotMess _ -> True + _ -> False + _ -> False + FromServerRsp _ _ -> False + +-- | Matches if the message is a request. +anyRequest :: Session FromServerMessage +anyRequest = named "Any request" $ satisfy $ \case + FromServerMess m _ -> case splitServerMethod m of + IsServerReq -> True + _ -> False + FromServerRsp _ _ -> False + +-- | Matches if the message is a response. +anyResponse :: Session FromServerMessage +anyResponse = named "Any response" $ satisfy $ \case + FromServerMess _ _ -> False + FromServerRsp _ _ -> True + +-- | Matches a response for a specific id. +responseForId :: SMethod (m :: Method FromClient Request) -> LspId m -> Session (ResponseMessage m) +responseForId m lid = named (T.pack $ "Response for id: " ++ show lid) $ do + satisfyMaybe $ \msg -> do + case msg of + FromServerMess _ _ -> Nothing + FromServerRsp m' rspMsg@(ResponseMessage _ lid' _) -> + case mEqClient m m' of + Just HRefl -> do + guard (lid' == Just lid) + pure rspMsg + Nothing + | SCustomMethod tm <- m + , SCustomMethod tm' <- m' + , tm == tm' + , lid' == Just lid -> pure rspMsg + _ -> empty + +-- | Matches any type of message. +anyMessage :: Session FromServerMessage +anyMessage = satisfy (const True) + +-- | Matches if the message is a log message notification or a show message notification/request. +loggingNotification :: Session FromServerMessage +loggingNotification = named "Logging notification" $ satisfy shouldSkip + where + shouldSkip (FromServerMess SWindowLogMessage _) = True + shouldSkip (FromServerMess SWindowShowMessage _) = True + shouldSkip (FromServerMess SWindowShowMessageRequest _) = True + shouldSkip _ = False + +-- | Matches a 'Language.Haskell.LSP.Test.PublishDiagnosticsNotification' +-- (textDocument/publishDiagnostics) notification. +publishDiagnosticsNotification :: Session PublishDiagnosticsNotification +publishDiagnosticsNotification = named "Publish diagnostics notification" $ + satisfyMaybe $ \msg -> case msg of + FromServerMess STextDocumentPublishDiagnostics diags -> Just diags + _ -> Nothing