1
0
mirror of https://github.com/golang/go synced 2024-10-01 10:38:33 -06:00
go/internal/lsp/cmd/inspect.go
Rob Findley da4261a3d0 internal/lsp/cmd: use JSON output for the inspect subcommand
I've been using the inspect command to find data about the daemon and
its various sessions while debugging gopls. In practice, however, I
don't simply want to view the debug information: I want to script it.
This change removes the custom output formatting in favor of indented
JSON, so that we can do things like the following:

  tail -f $(gopls inspect sessions | gq -r .logfile)

Which tails the daemon logs for the current gopls binary version.

Change-Id: I8895644b1493862f027e6c4b06e32612a4f3927d
Reviewed-on: https://go-review.googlesource.com/c/tools/+/233357
Run-TryBot: Robert Findley <rfindley@google.com>
Reviewed-by: Heschi Kreinick <heschi@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
2020-05-11 18:25:40 +00:00

102 lines
2.3 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"
"encoding/json"
"flag"
"fmt"
"log"
"os"
"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
}
v, err := json.MarshalIndent(state, "", "\t")
if err != nil {
log.Fatal(err)
}
os.Stdout.Write(v)
return nil
}