mirror of
https://github.com/golang/go
synced 2024-11-18 23:24:39 -07:00
097c1f2eed
Change-Id: I2480725dc20f67bb0427c71dab83a0cbe72832a1 Reviewed-on: https://go-review.googlesource.com/c/tools/+/217178 Reviewed-by: Alberto Donizetti <alb.donizetti@gmail.com>
34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# Generate server_gen.go
|
|
|
|
`helper` generates boilerplate code for server.go by processing the
|
|
generated code in `protocol/tsserver.go`.
|
|
|
|
First, build `helper` in this directory (`go build .`).
|
|
|
|
In directory `lsp`, executing `go generate server.go` generates the stylized file
|
|
`server_gen.go` that contains stubs for type `Server`.
|
|
|
|
It decides what stubs are needed and their signatures
|
|
by looking at the `Server` interface (`-t` flag). These all look somewhat like
|
|
`Resolve(context.Context, *CompletionItem) (*CompletionItem, error)`.
|
|
|
|
It then parses the `lsp` directory (`-u` flag) to see if there is a corresponding
|
|
implementation function (which in this case would be named `resolve`). If so
|
|
it discovers the parameter names needed, and generates (in `server_gen.go`) code
|
|
like
|
|
|
|
``` go
|
|
func (s *Server) resolve(ctx context.Context, params *protocol.CompletionItem) (*protocol.CompletionItem, error) {
|
|
return s.resolve(ctx, params)
|
|
}
|
|
```
|
|
|
|
If `resolve` is not defined (and it is not), then the body of the generated function is
|
|
|
|
```go
|
|
return nil, notImplemented("resolve")
|
|
```
|
|
|
|
So to add a capability currently not implemented, just define it somewhere in `lsp`.
|
|
In this case, just define `func (s *Server) resolve(...)` and re-generate `server_gen.go`.
|