📚 go-language-server - Awesome Go Library for Editor Plugins
A wrapper to turn the VSCode go extension into a language server supporting the language-server-protocol.
Detailed Description of go-language-server
A Go Language Server based on the Go Extension for Visual Studio Code
Wraps the VSCode Go extension from Microsoft into a language server, such that its functionality can be reused with other LSP-aware clients.
In the first iteration we will mock VSCode APIs or simulate their behavior backed by an LSP. We will maintain this as a fork of the original repository such that we can easily pick up incoming improvements of that by just rebasing. Once we got more confidence, we'd probably refactor the VSCode specific parts away.
Mismatches and Challenges
- There is no such thing as the
activeTextEditor
in LSP. For services that have aTextDocumentItem
, we set it before calling the service impl, but for other services, e.g.executeCommand
we cannot make sure that they are performed on the correct document. - We have to use/mock/adapt a lot of global variables
Prerequisites
Make sure the go
command is available from your path and that the GOPATH
environment variable points to where your go packages are installed. Some go
packages are necessary:
go get -u -v github.com/nsf/gocode
go get -u -v github.com/uudashr/gopkgs/cmd/gopkgs
go get -u -v github.com/ramya-rao-a/go-outline
go get -u -v github.com/acroca/go-symbols
go get -u -v golang.org/x/tools/cmd/guru
go get -u -v golang.org/x/tools/cmd/gorename
go get -u -v github.com/fatih/gomodifytags
go get -u -v github.com/haya14busa/goplay/cmd/goplay
go get -u -v github.com/josharian/impl
go get -u -v github.com/tylerb/gotype-live
go get -u -v github.com/rogpeppe/godef
go get -u -v golang.org/x/tools/cmd/godoc
go get -u -v github.com/zmb3/gogetdoc
go get -u -v golang.org/x/tools/cmd/goimports
go get -u -v sourcegraph.com/sqs/goreturns
go get -u -v github.com/golang/lint/golint
go get -u -v github.com/cweill/gotests/...
go get -u -v github.com/alecthomas/gometalinter
go get -u -v honnef.co/go/tools/...
go get -u -v github.com/sourcegraph/go-langserver
go get -u -v github.com/derekparker/delve/cmd/dlv
go get -u -v github.com/davidrjenni/reftools/cmd/fillstruc
Note: this list comes from here.
Build and usage
- Run
npm install
to install the package dependencies. - Run
npm run compile
to compile the Typescript to Javascript. - Run the server with
node ./out/src-vscode-mock/cli.js --stdio
.