From: Luke Lau Date: Tue, 31 Jul 2018 12:21:39 +0000 (+0100) Subject: Update README.md X-Git-Tag: 0.1.0.0~15 X-Git-Url: http://git.lukelau.me/?p=lsp-test.git;a=commitdiff_plain;h=5ad934c026bf88521199d1e82aa12fe51626b92f Update README.md --- diff --git a/README.md b/README.md index dd71506..4a8762b 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,42 @@ # haskell-lsp-test [![Build Status](https://travis-ci.com/Bubba/haskell-lsp-test.svg?branch=master)](https://travis-ci.com/Bubba/haskell-lsp-test) -This is the functional testing framework for [haskell-ide-engine](https://github.com/haskell/haskell-ide-engine), and potentially any other Language Server Protocol server. +haskell-lsp-test is a functional testing framework for Language Server Protocol servers. ```haskell -runSession "session/root/dir" $ do - doc <- openDoc "foo.hs" "haskell" +import Language.Haskell.LSP.Test +runSession "hie" fullCaps "proj/dir" $ do + doc <- openDoc "Foo.hs" "haskell" + skipMany anyNotification + symbols <- getDocumentSymbols doc +``` - skipMany notification +## Examples - symbols <- getDocumentSymbols doc +### Unit tests with HSpec +```haskell +describe "diagnostics" $ + it "report errors" $ runSession "hie" fullCaps "test/data" $ do + openDoc "Error.hs" "haskell" + [diag] <- waitForDiagnosticsSource "ghcmod" + liftIO $ do + diag ^. severity `shouldBe` Just DsError + diag ^. source `shouldBe` Just "ghcmod" ``` +### Replaying captured session +```haskell +replaySession "hie --lsp" "test/data/renamePass" +``` + +### Parsing with combinators +```haskell +skipManyTill loggingNotification publishDiagnosticsNotification +count 4 (message :: Session ApplyWorkspaceEditRequest) +anyRequest <|> anyResponse +``` + +For more examples check the [Wiki](https://github.com/Bubba/haskell-lsp-test/wiki/Introduction) + ## Developing -To test make sure you have [haskell-ide-engine](https://github.com/haskell/haskell-ide-engine) installed. +To test make sure you have the following language servers installed: +- [haskell-ide-engine](https://github.com/haskell/haskell-ide-engine) +- [javascript-typescript-langserver](https://github.com/sourcegraph/javascript-typescript-langserver)