buildinfo

Documentation

Overview

Package buildinfo resolves the version embedded in a Gloss binary.

Index

• Constants
• Variables
• func Display(version string) string
• func NormalizeStable(value string) (string, bool)
• func Resolve(injected string, info *debug.BuildInfo) string
• func ValidateReleaseTag(tag string) (string, error)
• func Version() string

Constants

const DevelopmentVersion = "dev"

Variables

var InjectedVersion string

InjectedVersion is set only by tagged release builds:

go build -ldflags "-X github.com/Architeg/gloss/internal/buildinfo.InjectedVersion=v1.2.3"

Functions

func Display

func Display(version string) string

Display adds the conventional v prefix to stable versions while leaving development labels unchanged.

func NormalizeStable

func NormalizeStable(value string) (string, bool)

NormalizeStable accepts a stable three-component semantic version with an optional leading v and returns the canonical version without that prefix.

func Resolve

func Resolve(injected string, info *debug.BuildInfo) string

Resolve applies the release-injection, module-build-info, development fallback order. It is exported so tests can use synthetic build metadata without mutating process-global state.

func ValidateReleaseTag

func ValidateReleaseTag(tag string) (string, error)

ValidateReleaseTag requires the exact stable release-tag form vX.Y.Z.

func Version

func Version() string

Version returns the canonical version for the running binary without a leading v. Untagged local builds return DevelopmentVersion.