Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type EventWriter ¶
type EventWriter struct {
// contains filtered or unexported fields
}
EventWriter writes every incoming []byte to event.Print with the operation=generate tag to distinguish its logs from others.
func NewEventWriter ¶
func NewEventWriter(ctx context.Context, operation string) *EventWriter
type Tracker ¶
type Tracker struct {
// contains filtered or unexported fields
}
func NewTracker ¶
func (*Tracker) SetSupportsWorkDoneProgress ¶
SetSupportsWorkDoneProgress sets whether the client supports work done progress reporting. It must be set before using the tracker.
TODO(rfindley): fix this broken initialization pattern. Also: do we actually need the fall-back progress behavior using ShowMessage? Surely ShowMessage notifications are too noisy to be worthwhile.
func (*Tracker) Start ¶
func (t *Tracker) Start(ctx context.Context, title, message string, token protocol.ProgressToken, cancel func()) *WorkDone
Start notifies the client of work being done on the server. It uses either ShowMessage RPCs or $/progress messages, depending on the capabilities of the client. The returned WorkDone handle may be used to report incremental progress, and to report work completion. In particular, it is an error to call start and not call end(...) on the returned WorkDone handle.
If token is empty, a token will be randomly generated.
The progress item is considered cancellable if the given cancel func is non-nil. In this case, cancel is called when the work done
Example:
func Generate(ctx) (err error) {
ctx, cancel := context.WithCancel(ctx)
defer cancel()
work := s.progress.start(ctx, "generate", "running go generate", cancel)
defer func() {
if err != nil {
work.end(ctx, fmt.Sprintf("generate failed: %v", err))
} else {
work.end(ctx, "done")
}
}()
// Do the work...
}
func (*Tracker) SupportsWorkDoneProgress ¶ added in v0.13.0
SupportsWorkDoneProgress reports whether the tracker supports work done progress reporting.
type WorkDone ¶
type WorkDone struct {
// contains filtered or unexported fields
}
WorkDone represents a unit of work that is reported to the client via the progress API.
func (*WorkDone) Token ¶
func (wd *WorkDone) Token() protocol.ProgressToken
type WorkDoneWriter ¶
type WorkDoneWriter struct {
// contains filtered or unexported fields
}
WorkDoneWriter wraps a workDone handle to provide a Writer interface, so that workDone reporting can more easily be hooked into commands.
func NewWorkDoneWriter ¶
func NewWorkDoneWriter(ctx context.Context, wd *WorkDone) *WorkDoneWriter
Source Files