upgrade

type Boundaries struct {
	State  MajorFloor   `json:"state"`
	Majors []MajorFloor `json:"majors"`
}

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

type MajorFloor struct {
	Major int    `json:"major"`
	Floor string `json:"floor"`
}

type Options struct {
	Source   Source
	Target   string   // path of the installed binary
	Current  string   // running version, "v0.1.0" or "0.1.0"
	Version  string   // pinned release; empty = the newest the Source has
	Platform Platform // zero = this OS and architecture
	Yes      bool     // go past Upgrade notes
	Out      io.Writer
	// Service is the systemd unit the restart hint names; "" = "sphericon".
	Service string

	// Container names the command to use instead when running inside a container or on
	// Kubernetes ("docker" or "helm"), "" on a bare host; nil = detect from the environment.
	Container func() string
	// Run executes a binary, writing its stdout to stdout; nil = os/exec with the
	// process environment and stderr passed through.
	Run func(ctx context.Context, bin string, args []string, stdout io.Writer) error
	// PostSwap runs after the swap; nil = print the restart command. A later `--restart`
	// replaces it with one that restarts the systemd service.
	PostSwap func(ctx context.Context, r Result) error
	// contains filtered or unexported fields
}

type Platform struct{ OS, Arch string }

type Release struct {
	Version       string // without the leading "v"
	ArchiveName   string
	ArchivePath   string
	ChecksumsPath string
	// Cleanup removes what the source staged; nil when nothing was (a directory source).
	Cleanup func()
}

type Result struct {
	Changed bool   // false when the Instance already runs the release
	Version string // installed release, without the leading "v"
	Binary  string // the installed path
	Old     string // the previous binary, kept next to it
}

type Source interface {
	// Versions lists the releases it can supply for the platform (without the leading "v").
	Versions(ctx context.Context, p Platform) ([]string, error)
	// Fetch stages one release (version without the leading "v") for the platform.
	Fetch(ctx context.Context, version string, p Platform) (Release, error)
}

type Systemd struct {
	Service string // unit name, "sphericon"
	Out     io.Writer
}