update

type JSONReporter ¶ added in v0.11.0

type JSONReporter struct{ W io.Writer }

JSONReporter writes each step as a JSONL event {"type":"update.step","step":...,"detail":...} to W, and no progress bar.

func (r *JSONReporter) Download(string, int64) (io.Writer, func())

func (r *JSONReporter) Step(step, detail string)

type ProgressBar ¶ added in v0.11.0

type ProgressBar struct {
	W     io.Writer
	Total int64
	// contains filtered or unexported fields
}

ProgressBar draws download progress to W. With Total > 0 it redraws one line, "\r [####....] 42% 1.2 MiB / 2.9 MiB", as bytes arrive; with Total <= 0 it appends one '#' per ChunkSize bytes. Finish ends the line.

func (p *ProgressBar) Finish()

func (p *ProgressBar) Write(b []byte) (int, error)

type Reporter ¶ added in v0.11.0

type Reporter interface {
	Step(step, detail string)
	Download(name string, total int64) (io.Writer, func())
}

Reporter receives Run's progress. Step is called once per step with a human-readable detail; Download is called before the binary download and returns a writer fed every byte as it arrives (nil for none) and a finish func called once the body is read or fails.

type StepError ¶ added in v0.11.0

type StepError struct {
	Step string
	Err  error
}

StepError is an error from one step of Run.

func (e *StepError) Error() string

func (e *StepError) Unwrap() error

type TextReporter ¶ added in v0.11.0

type TextReporter struct {
	W   io.Writer
	Bar bool
}

TextReporter prints one "update: <step>: <detail>" line per step to W. With Bar set (W is a terminal), the download draws a '#' progress bar; otherwise the download prints only plain lines, with no carriage returns.

func (r *TextReporter) Download(name string, total int64) (io.Writer, func())

func (r *TextReporter) Step(step, detail string)

type Updater ¶

type Updater struct {
	APIURL  string // latest-release endpoint
	Current string // running version, e.g. v0.1.0 or dev
	ExePath string // binary to replace
	Client  *http.Client
	GOOS    string
	GOARCH  string
	Report  Reporter // progress; nil reports nothing
}

func New(current string) (*Updater, error)

func (u *Updater) Run(ctx context.Context) (string, error)