progress

Documentation

Index

• func Run(ctx context.Context, pf progressFunc) (string, error)
• func WithContextWriter(ctx context.Context, writer Writer) context.Context
• type Event
• type EventStatus
• type Writer
  • func ContextWriter(ctx context.Context) Writer
  • func NewWriter(out console.File) (Writer, error)

Functions

func Run

func Run(ctx context.Context, pf progressFunc) (string, error)

Run will run a writer and the progress function in parallel

func WithContextWriter

func WithContextWriter(ctx context.Context, writer Writer) context.Context

WithContextWriter adds the writer to the context

Types

type Event

type Event struct {
	ID         string
	Text       string
	Status     EventStatus
	StatusText string
	Done       bool
	// contains filtered or unexported fields
}

Event represents a progress event.

type EventStatus

type EventStatus int

EventStatus indicates the status of an action

const (
	// Working means that the current task is working
	Working EventStatus = iota
	// Done means that the current task is done
	Done
	// Error means that the current task has errored
	Error
)

type Writer

type Writer interface {
	Start(context.Context) error
	Stop()
	Event(Event)
}

Writer can write multiple progress events

func ContextWriter

func ContextWriter(ctx context.Context) Writer

ContextWriter returns the writer from the context

func NewWriter

func NewWriter(out console.File) (Writer, error)

NewWriter returns a new multi-progress writer