// Copyright 2019 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 debug exports debug information for gopls. package debug import ( "context" "fmt" "io" "runtime/debug" "strings" ) type PrintMode int const ( PlainText = PrintMode(iota) Markdown HTML ) // Version is a manually-updated mechanism for tracking versions. var Version = "master" // ServerVersion is the format used by gopls to report its version to the // client. This format is structured so that the client can parse it easily. type ServerVersion struct { Module Deps []*Module `json:"deps,omitempty"` } type Module struct { ModuleVersion Replace *ModuleVersion `json:"replace,omitempty"` } type ModuleVersion struct { Path string `json:"path,omitempty"` Version string `json:"version,omitempty"` Sum string `json:"sum,omitempty"` } // VersionInfo returns the build info for the gopls process. If it was not // built in module mode, we return a GOPATH-specific message with the // hardcoded version. func VersionInfo() *ServerVersion { if info, ok := debug.ReadBuildInfo(); ok { return getVersion(info) } path := "gopls, built in GOPATH mode" return &ServerVersion{ Module: Module{ ModuleVersion: ModuleVersion{ Path: path, Version: Version, }, }, } } func getVersion(info *debug.BuildInfo) *ServerVersion { serverVersion := ServerVersion{ Module: Module{ ModuleVersion: ModuleVersion{ Path: info.Main.Path, Version: info.Main.Version, Sum: info.Main.Sum, }, }, } for _, d := range info.Deps { m := &Module{ ModuleVersion: ModuleVersion{ Path: d.Path, Version: d.Version, Sum: d.Sum, }, } if d.Replace != nil { m.Replace = &ModuleVersion{ Path: d.Replace.Path, Version: d.Replace.Version, } } serverVersion.Deps = append(serverVersion.Deps, m) } return &serverVersion } // PrintServerInfo writes HTML debug info to w for the Instance. func (i *Instance) PrintServerInfo(ctx context.Context, w io.Writer) { section(w, HTML, "Server Instance", func() { fmt.Fprintf(w, "Start time: %v\n", i.StartTime) fmt.Fprintf(w, "LogFile: %s\n", i.Logfile) fmt.Fprintf(w, "Working directory: %s\n", i.Workdir) fmt.Fprintf(w, "Address: %s\n", i.ServerAddress) fmt.Fprintf(w, "Debug address: %s\n", i.DebugAddress) }) PrintVersionInfo(ctx, w, true, HTML) } // PrintVersionInfo writes version information to w, using the output format // specified by mode. verbose controls whether additional information is // written, including section headers. func PrintVersionInfo(ctx context.Context, w io.Writer, verbose bool, mode PrintMode) { info := VersionInfo() if !verbose { printBuildInfo(w, info, false, mode) return } section(w, mode, "Build info", func() { printBuildInfo(w, info, true, mode) }) } func section(w io.Writer, mode PrintMode, title string, body func()) { switch mode { case PlainText: fmt.Fprintln(w, title) fmt.Fprintln(w, strings.Repeat("-", len(title))) body() case Markdown: fmt.Fprintf(w, "#### %s\n\n```\n", title) body() fmt.Fprintf(w, "```\n") case HTML: fmt.Fprintf(w, "

%s

\n
\n", title)
		body()
		fmt.Fprint(w, "
\n") } } func printBuildInfo(w io.Writer, info *ServerVersion, verbose bool, mode PrintMode) { fmt.Fprintf(w, "%v %v\n", info.Path, Version) printModuleInfo(w, &info.Module, mode) if !verbose { return } for _, dep := range info.Deps { printModuleInfo(w, dep, mode) } } func printModuleInfo(w io.Writer, m *Module, mode PrintMode) { fmt.Fprintf(w, " %s@%s", m.Path, m.Version) if m.Sum != "" { fmt.Fprintf(w, " %s", m.Sum) } if m.Replace != nil { fmt.Fprintf(w, " => %v", m.Replace.Path) } fmt.Fprintf(w, "\n") }