version

Documentation

Index

• Constants
• Variables
• func Check(binaryVersion *gvers.Version, featureConstraint MetadataConstraint) bool
• func EnableFeatureForTest(t *testing.T, feature Feature)
• func EnableFeatureOnVersionForTest(t *testing.T, version *gvers.Version, feature Feature)
• func GetReleaseVersion() (*gvers.Version, error)
• func SupportsFeature(version *gvers.Version, feature Feature) bool
• type Feature
• type Info
  • func FromVersionString(s string) *Info
  • func Get() *Info
  • func (c *Info) FullVersionNumber(rev bool) string
  • func (c *Info) Semver() *gvers.Version
  • func (c *Info) VersionNumber() string
• type MetadataConstraint
  • func (m MetadataConstraint) Check(version *gvers.Version) bool

Constants

const BoundaryPrefix = "Boundary v"

Variables

var (
	// GitCommit is the git commit that was compiled. This will be filled in by the compiler.
	GitCommit   string
	GitDescribe string

	// CgoEnabled is whether cgo is enabled or not; set at build time
	CgoEnabled bool

	// Version is the base version
	// Default values - set when building locally (at build time)
	Version = "0.13.1"

	// VersionPrerelease is also set at compile time, similarly to Version.
	VersionPrerelease string

	// VersionMetadata is also set at compile time.
	VersionMetadata string

	// BuildDate is the date of the build, which corresponds to the timestamp of
	// the most recent commit
	BuildDate string
)

var Binary *gvers.Version

Binary is the version of the running binary. This can be used for feature checks.

Functions

func Check

func Check(binaryVersion *gvers.Version, featureConstraint MetadataConstraint) bool

Check returns a bool indicating if a version satisfies the feature constraints

func EnableFeatureForTest

func EnableFeatureForTest(t *testing.T, feature Feature)

EnableFeatureForTest enables a feature for the current binary version

func EnableFeatureOnVersionForTest

func EnableFeatureOnVersionForTest(t *testing.T, version *gvers.Version, feature Feature)

EnableFeatureForTest modifies the feature map to enable a feature for a version. This is intended to be used for testing before release of a version Test cleanup will reset the feature map to the original feature constraint Note: running any tests in parallel while using this function WILL result in surprising behavior because this modifies the global feature map

func GetReleaseVersion

func GetReleaseVersion() (*gvers.Version, error)

GetReleaseVersion returns a go-version of this binary's Boundary version

func SupportsFeature

func SupportsFeature(version *gvers.Version, feature Feature) bool

SupportsFeature return a bool indicating whether or not this version supports the given feature

Types

type Feature

type Feature int

const (
	UnknownFeature Feature = iota
	MultiHopSessionFeature
	IncludeStatusInCli
	CredentialLibraryVaultSubtype
	UseTargetIdForHostId
	RequireVersionInWorkerInfo
	SshSessionRecording
	SupportIdInGrants
)

type Info

type Info struct {
	Revision          string `json:"revision,omitempty"`
	Version           string `json:"version,omitempty"`
	VersionPrerelease string `json:"version_prerelease,omitempty"`
	VersionMetadata   string `json:"version_metadata,omitempty"`
	BuildDate         string `json:"build_date,omitempty"`
	CgoEnabled        bool   `json:"cgo_enabled,omitempty"`
}

Info

func FromVersionString

func FromVersionString(s string) *Info

FromVersionString returns an *Info containing the version, or nil if the string was unable to be parsed.

func Get

func Get() *Info

func (*Info) FullVersionNumber

func (c *Info) FullVersionNumber(rev bool) string

func (*Info) Semver

func (c *Info) Semver() *gvers.Version

Semver returns a *gvers.Version if the Info is parseable as a semantic version. Otherwise it returns nil.

func (*Info) VersionNumber

func (c *Info) VersionNumber() string

type MetadataConstraint

type MetadataConstraint struct {
	Constraints gvers.Constraints
}

func (MetadataConstraint) Check

func (m MetadataConstraint) Check(version *gvers.Version) bool

Check returns a bool indicating if a version meets the constraints for a feature. Check returns false if version is nil.