version

package

v0.2.0-rc.0 Latest Latest Go to latest Published: Jun 10, 2026 License: Apache-2.0 Imports: 10 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/stablekernel/cascade

Links

Open Source Insights

Documentation ¶

Overview ¶

Package version provides semantic versioning utilities for release management.

Index ¶

func NewCommand() *cobra.Command
func StripRC(version string) (string, error)
type BumpType
- func DetermineBumpType(commits []changelog.ConventionalCommit) BumpType
type Calculator
- func NewCalculator(prefix string) *Calculator
- func (c *Calculator) CalculateNext(currentDevVersion, nextEnvVersion string, ...) (*Version, error)
type Version
- func GetLatestRelease(tags []string) (*Version, error)
- func Parse(s string) (*Version, error)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func NewCommand ¶

func NewCommand() *cobra.Command

NewCommand creates the next-version command

func StripRC ¶

func StripRC(version string) (string, error)

StripRC removes the pre-release suffix for publishing

Types ¶

type BumpType ¶

type BumpType int

BumpType represents the type of version bump

const (
	BumpNone BumpType = iota
	BumpPatch
	BumpMinor
	BumpMajor
)

func DetermineBumpType ¶

func DetermineBumpType(commits []changelog.ConventionalCommit) BumpType

DetermineBumpType analyzes commits and returns the highest bump type needed

type Calculator ¶

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

Calculator handles version calculation for the release workflow

func NewCalculator ¶

func NewCalculator(prefix string) *Calculator

NewCalculator creates a new version calculator

func (*Calculator) CalculateNext ¶

func (c *Calculator) CalculateNext(currentDevVersion, nextEnvVersion string, commits []changelog.ConventionalCommit) (*Version, error)

CalculateNext determines the next version for the lowest environment Parameters:

currentDevVersion: current version in dev (may be empty or same as nextEnvVersion after promotion)
nextEnvVersion: version in the next environment (e.g., test)
commits: conventional commits between nextEnv's SHA and HEAD

Returns the calculated version with appropriate RC suffix

type Version ¶

type Version struct {
	Major      int
	Minor      int
	Patch      int
	PreRelease int    // -1 means no pre-release suffix, >= 0 is the RC number
	Prefix     string // e.g., "v" or custom prefix
}

Version represents a semantic version with optional pre-release suffix

func GetLatestRelease ¶

func GetLatestRelease(tags []string) (*Version, error)

GetLatestRelease returns the latest published (non-prerelease) version from a list of tags

func Parse ¶

func Parse(s string) (*Version, error)

Parse parses a version string into a Version struct

func (*Version) Base ¶

func (v *Version) Base() string

Base returns the version without pre-release suffix

func (*Version) BaseVersion ¶

func (v *Version) BaseVersion() *Version

BaseVersion returns a copy without pre-release suffix

func (*Version) Bump ¶

func (v *Version) Bump(bump BumpType) *Version

Bump returns a new version with the specified bump applied

func (*Version) Equal ¶

func (v *Version) Equal(other *Version) bool

Equal returns true if two versions have the same major.minor.patch (ignoring RC)

func (*Version) String ¶

func (v *Version) String() string

String returns the version as a string

func (*Version) WithRC ¶

func (v *Version) WithRC(rc int) *Version

WithRC returns a copy with the specified RC number

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL