buildinfo

Documentation

Overview

Package buildinfo hosts build info variables populated via ldflags.

For testing, you can override the build version using envar SQ_BUILD_VERSION (panics if not a valid semver).

Index

• Constants
• Variables
• func IsDefaultVersion() bool
• type BuildInfo
  • func Get() BuildInfo
  • func (bi BuildInfo) LogValue() slog.Value
  • func (bi BuildInfo) String() string

Constants

const DefaultVersion = "v0.0.0-dev"

DefaultVersion is the default value for Version if not set via ldflags.

const EnvOverrideVersion = `SQ_BUILD_VERSION`

EnvOverrideVersion is used for testing build version, e.g. for config upgrades.

Variables

var (
	// Version is the build version. If not set at build time via
	// ldflags, Version takes the value of DefaultVersion.
	Version = DefaultVersion

	// Commit is the commit hash.
	Commit string

	// Timestamp is the timestamp of when the cli was built.
	Timestamp string
)

Functions

func IsDefaultVersion

func IsDefaultVersion() bool

IsDefaultVersion returns true if Version is empty or DefaultVersion.

Types

type BuildInfo

type BuildInfo struct {
	Version   string    `json:"version" yaml:"version"`
	Commit    string    `json:"commit,omitempty" yaml:"commit,omitempty"`
	Timestamp time.Time `json:"timestamp,omitempty" yaml:"timestamp,omitempty"`
}

BuildInfo encapsulates Version, Commit and Timestamp.

func Get

func Get() BuildInfo

Get returns BuildInfo. If buildinfo.Timestamp cannot be parsed, the returned BuildInfo.Timestamp will be the zero value.

func (BuildInfo) LogValue

func (bi BuildInfo) LogValue() slog.Value

LogValue implements slog.LogValuer.

func (BuildInfo) String

func (bi BuildInfo) String() string

String returns a string representation of BuildInfo.