X-Git-Url: http://git.lukelau.me/?p=opengl.git;a=blobdiff_plain;f=README.md;h=7cce8e55f1c8ca6c22b240b4549b5de6d0589662;hp=dd715067b74e46686c53ab3e4a7415ccf9009fac;hb=refs%2Fheads%2Ftravis-windows;hpb=c6e68648c1e3b586e1ee8b0dcda1485ff5ae28ba diff --git a/README.md b/README.md index dd71506..7cce8e5 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,43 @@ -# 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. +# lsp-test [![Build Status](https://travis-ci.com/bubba/lsp-test.svg?branch=master)](https://travis-ci.com/bubba/lsp-test) [![Hackage](https://img.shields.io/hackage/v/lsp-test.svg)](https://hackage.haskell.org/package/lsp-test-0.1.0.0) +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" "test/data/renamePass" +``` + +### Parsing with combinators +```haskell +skipManyTill loggingNotification publishDiagnosticsNotification +count 4 (message :: Session ApplyWorkspaceEditRequest) +anyRequest <|> anyResponse +``` + +Try out the example tests in the `example` directory with `cabal new-test`. +For more examples check the [Wiki](https://github.com/bubba/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)