Documentation ¶
Overview ¶
Package cmd handles the gopls command line. It contains a handler for each of the modes, along with all the flag handling and the command line output format.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ErrInvalidRenamePosition = errors.New("request is not valid at the given position")
ErrInvalidRenamePosition is returned when prepareRename is run at a position that is not a candidate for renaming.
Functions ¶
This section is empty.
Types ¶
type Application ¶
type Application struct { // Embed the basic profiling flags supported by the tool package tool.Profile // We include the server configuration directly for now, so the flags work // even without the verb. // TODO: Remove this when we stop allowing the serve verb by default. Serve Serve // Support for remote lsp server Remote string `` /* 344-byte string literal not displayed */ // Enable verbose logging Verbose bool `flag:"v" help:"verbose output"` // Control ocagent export of telemetry OCAgent string `flag:"ocagent" help:"the address of the ocagent, or off"` // PrepareOptions is called to update the options when a new view is built. // It is primarily to allow the behavior of gopls to be modified by hooks. PrepareOptions func(*source.Options) // contains filtered or unexported fields }
Application is the main application as passed to tool.Main It handles the main command line parsing and dispatch to the sub commands.
func New ¶
func New(name, wd string, env []string, options func(*source.Options)) *Application
New returns a new Application ready to run.
func (*Application) DetailedHelp ¶
func (app *Application) DetailedHelp(f *flag.FlagSet)
DetailedHelp implements tool.Application returning the main binary help. This includes the short help for all the sub commands.
func (*Application) Name ¶
func (app *Application) Name() string
Name implements tool.Application returning the binary name.
func (*Application) Run ¶
func (app *Application) Run(ctx context.Context, args ...string) error
Run takes the args after top level flag processing, and invokes the correct sub command as specified by the first argument. If no arguments are passed it will invoke the server sub command, as a temporary measure for compatibility.
func (*Application) ShortHelp ¶
func (app *Application) ShortHelp() string
ShortHelp implements tool.Application returning the main binary help.
func (*Application) Usage ¶
func (app *Application) Usage() string
Usage implements tool.Application returning empty extra argument usage.
type Definition ¶
type Definition struct { Span span.Span `json:"span"` // span of the definition Description string `json:"description"` // description of the denoted object }
A Definition is the result of a 'definition' query.
type Serve ¶
type Serve struct { Logfile string `flag:"logfile" help:"filename to log to. if value is \"auto\", then logging to a default output file is enabled"` Mode string `flag:"mode" help:"no effect"` Port int `flag:"port" help:"port on which to run gopls for debugging purposes"` Address string `` /* 181-byte string literal not displayed */ IdleTimeout time.Duration `` /* 127-byte string literal not displayed */ Trace bool `flag:"rpc.trace" help:"print the full rpc trace in lsp inspector format"` Debug string `flag:"debug" help:"serve debug information on the supplied address"` RemoteListenTimeout time.Duration `flag:"remote.listen.timeout" help:"when used with -remote=auto, the -listen.timeout value used to start the daemon"` RemoteDebug string `flag:"remote.debug" help:"when used with -remote=auto, the -debug value used to start the daemon"` RemoteLogfile string `flag:"remote.logfile" help:"when used with -remote=auto, the -logfile value used to start the daemon"` // contains filtered or unexported fields }
Serve is a struct that exposes the configurable parts of the LSP server as flags, in the right form for tool.Main to consume.