mirror of
https://github.com/golang/go
synced 2024-11-19 11:24:51 -07:00
bd435c612c
Add a new toplevel `inspect` verb to the gopls command, to expose the internal state of a running gopls server. For now, this verb exposes a single subcommand `sessions`, which lists some information about current server sessions on a gopls daemon. This can be used even if the debug server is not running, which will become the default in a later CL. Updates golang/go#34111 Change-Id: Ib7d654a659fa47280584f9a7301b952cbccc565a Reviewed-on: https://go-review.googlesource.com/c/tools/+/222669 Run-TryBot: Robert Findley <rfindley@google.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Heschi Kreinick <heschi@google.com>
107 lines
2.6 KiB
Go
107 lines
2.6 KiB
Go
// Copyright 2020 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package cmd
|
|
|
|
import (
|
|
"context"
|
|
"flag"
|
|
"fmt"
|
|
|
|
"golang.org/x/tools/internal/lsp/lsprpc"
|
|
"golang.org/x/tools/internal/tool"
|
|
)
|
|
|
|
type inspect struct {
|
|
app *Application
|
|
}
|
|
|
|
func (i *inspect) subCommands() []tool.Application {
|
|
return []tool.Application{
|
|
&listSessions{app: i.app},
|
|
}
|
|
}
|
|
|
|
func (i *inspect) Name() string { return "inspect" }
|
|
func (i *inspect) Usage() string { return "<subcommand> [args...]" }
|
|
func (i *inspect) ShortHelp() string {
|
|
return "inspect server state (daemon mode only)"
|
|
}
|
|
func (i *inspect) DetailedHelp(f *flag.FlagSet) {
|
|
fmt.Fprint(f.Output(), "\nsubcommands:\n")
|
|
for _, c := range i.subCommands() {
|
|
fmt.Fprintf(f.Output(), " %s: %s\n", c.Name(), c.ShortHelp())
|
|
}
|
|
f.PrintDefaults()
|
|
}
|
|
|
|
func (i *inspect) Run(ctx context.Context, args ...string) error {
|
|
if len(args) == 0 {
|
|
return tool.CommandLineErrorf("must provide subcommand to %q", i.Name())
|
|
}
|
|
command, args := args[0], args[1:]
|
|
for _, c := range i.subCommands() {
|
|
if c.Name() == command {
|
|
return tool.Run(ctx, c, args)
|
|
}
|
|
}
|
|
return tool.CommandLineErrorf("unknown command %v", command)
|
|
}
|
|
|
|
// listSessions is an inspect subcommand to list current sessions.
|
|
type listSessions struct {
|
|
app *Application
|
|
}
|
|
|
|
func (c *listSessions) Name() string { return "sessions" }
|
|
func (c *listSessions) Usage() string { return "" }
|
|
func (c *listSessions) ShortHelp() string {
|
|
return "print information about current gopls sessions"
|
|
}
|
|
|
|
const listSessionsExamples = `
|
|
Examples:
|
|
|
|
1) list sessions for the default daemon:
|
|
|
|
$ gopls -remote=auto inspect sessions
|
|
or just
|
|
$ gopls inspect sessions
|
|
|
|
2) list sessions for a specific daemon:
|
|
|
|
$ gopls -remote=localhost:8082 inspect sessions
|
|
`
|
|
|
|
func (c *listSessions) DetailedHelp(f *flag.FlagSet) {
|
|
fmt.Fprint(f.Output(), listSessionsExamples)
|
|
f.PrintDefaults()
|
|
}
|
|
|
|
func (c *listSessions) Run(ctx context.Context, args ...string) error {
|
|
remote := c.app.Remote
|
|
if remote == "" {
|
|
remote = "auto"
|
|
}
|
|
network, address := parseAddr(remote)
|
|
state, err := lsprpc.QueryServerState(ctx, network, address)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
fmt.Printf("Server logfile: %s\n", state.Logfile)
|
|
fmt.Printf("Server debug address: %v\n", state.DebugAddr)
|
|
for _, c := range state.Clients {
|
|
if c.ClientID == state.CurrentClientID {
|
|
// This is the client for the listsessions command itself.
|
|
continue
|
|
}
|
|
fmt.Println()
|
|
fmt.Printf("Client %s:\n", c.ClientID)
|
|
fmt.Printf("\tsession: %s:\n", c.SessionID)
|
|
fmt.Printf("\tlogfile: %s:\n", c.Logfile)
|
|
fmt.Printf("\tdebug address: %s:\n", c.DebugAddr)
|
|
}
|
|
return nil
|
|
}
|