progress

package
v0.12.3-pre.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 21, 2023 License: BSD-3-Clause Imports: 10 Imported by: 0

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

func (*EventWriter) Write

func (ew *EventWriter) Write(p []byte) (n int, err error)

type Tracker

type Tracker struct {
	// contains filtered or unexported fields
}

func NewTracker

func NewTracker(client protocol.Client) *Tracker

func (*Tracker) Cancel

func (t *Tracker) Cancel(token protocol.ProgressToken) error

func (*Tracker) SetSupportsWorkDoneProgress

func (tracker *Tracker) SetSupportsWorkDoneProgress(b bool)

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...
}

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) End

func (wd *WorkDone) End(ctx context.Context, message string)

End reports a workdone completion back to the client.

func (*WorkDone) Report

func (wd *WorkDone) Report(ctx context.Context, message string, percentage float64)

Report reports an update on WorkDone report back to the client.

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

func (*WorkDoneWriter) Write

func (wdw *WorkDoneWriter) Write(p []byte) (n int, err error)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL