release

type BinaryProvider ¶

type BinaryProvider interface {
	Get(ctx context.Context, version string) (string, error)
}

BinaryProvider is a small abstraction around downloading a specific name for a given version. Implementations should return the path of the downloaded name on success.

type BinaryVersionChecker ¶ added in v1.16.3

type BinaryVersionChecker func(ctx context.Context, binary string) error

BinaryVersionChecker is a function that verifies the version of a downloaded binary matches the requested version. It takes a context and the path to the binary as input and returns an error if the version check fails (e.g., version mismatch or command execution error).

type BinaryVersionCheckerFactory ¶ added in v1.16.3

type BinaryVersionCheckerFactory func(requestedVersion string, os string, arch string) (BinaryVersionChecker, error)

BinaryVersionCheckerFactory is a factory function that creates a BinaryVersionChecker for a specific requested version and OS/architecture pair. This allows for customizable version checking logic that may vary based on the target platform or version.

func NewStaticCommandVersionCheckerFactory(args []string, outputParser func(stdout string) (string, error), comparator BinaryVersionComparator) BinaryVersionCheckerFactory

type BinaryVersionComparator ¶ added in v1.16.3

type BinaryVersionComparator func(requestedVersion string, actualVersion string) error

BinaryVersionComparator is a function that compares a requested version with the actual version extracted from a binary. It returns an error if the versions do not match according to the comparison logic (e.g., semver equality check).

func NewSemverEqualityComparator() BinaryVersionComparator

type GithubReleaseBinaryLocator ¶

type GithubReleaseBinaryLocator func(releaseDir string, name string, version string, os string, arch string) (string, error)

func NewDefaultBinaryLocator() GithubReleaseBinaryLocator

func NewOPStackBinaryLocator() GithubReleaseBinaryLocator

type GithubReleaseCachePather ¶

type GithubReleaseCachePather func() (string, error)

func NewHomeDirCachePather(namespace string) GithubReleaseCachePather

func NewStaticCachePather(cacheDir string) GithubReleaseCachePather

type GithubReleaseChecksummer ¶

type GithubReleaseChecksummer func(r io.Reader) error

GithubReleaseChecksummer reads the downloaded archive data and validates its checksum. It should return an error if the checksum does not match.

func NewDefaultChecksummer(expectedChecksum string) GithubReleaseChecksummer

type GithubReleaseChecksummerFactory ¶

type GithubReleaseChecksummerFactory func(os string, arch string) (GithubReleaseChecksummer, error)

GithubReleaseChecksummerFactory returns a GithubReleaseChecksummer for a specific OS/architecture pair. This allows providing precomputed checksums for different release artifacts.

func NewStaticChecksummerFactory(checksums map[string]string) GithubReleaseChecksummerFactory

type GithubReleaseDownloader ¶

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

func NewGithubReleaseDownloader(owner string, repo string, name string, opts ...GithubReleaseDownloaderOption) *GithubReleaseDownloader

func (d *GithubReleaseDownloader) Get(ctx context.Context, version string) (string, error)

type GithubReleaseDownloaderOption ¶

type GithubReleaseDownloaderOption func(*GithubReleaseDownloader)

func WithBinaryLocator(l GithubReleaseBinaryLocator) GithubReleaseDownloaderOption

func WithCachePather(c GithubReleaseCachePather) GithubReleaseDownloaderOption

func WithChecksummerFactory(c GithubReleaseChecksummerFactory) GithubReleaseDownloaderOption

func WithLogger(l *log.Logger) GithubReleaseDownloaderOption

func WithMaxDownloadSize(size int64) GithubReleaseDownloaderOption

func WithOSGetter(c GithubReleaseOSGetter) GithubReleaseDownloaderOption

func WithProgressor(p ioutil.Progressor) GithubReleaseDownloaderOption

func WithURLGetter(c GithubReleaseURLGetter) GithubReleaseDownloaderOption

func WithVersionCheckerFactory(f BinaryVersionCheckerFactory) GithubReleaseDownloaderOption

type GithubReleaseOSGetter ¶

type GithubReleaseOSGetter func() (string, string, error)

GithubReleaseOSGetter returns the OS and architecture string used to select the appropriate release artifact (e.g. "linux", "amd64"). The function may inspect the runtime or be overridden for testing.

func NewDefaultOSGetter() GithubReleaseOSGetter

type GithubReleaseURLGetter ¶

type GithubReleaseURLGetter func(owner string, repo string, name string, version string, os string, arch string) (string, error)

GithubReleaseURLGetter constructs the download URL for a given owner/repo and version for the provided os/arch pair.

func NewDefaultURLGetter() GithubReleaseURLGetter

func NewOPStackURLGetter() GithubReleaseURLGetter