Version Properties

Version Properties

Setup: See /installation for one-time SDK/CLI/MCP install.
Layers: SDK (Go) → CLI (shell) → MCP (AI tools) — pick your entry point.

When to Use

• Extracting numeric segments from a version string ([1, 2, 3])
• Getting the sub-version number embedded in a prerelease suffix (beta2 -> 2)
• Determining the semantic weight of a suffix for ordering (rc = 400)
• Getting the clean prefix without trailing delimiters ("curl-" -> "curl")
• Getting the group ID used by Group() for version grouping

Decision Tree

Need all components at once?
  → Use version_info (MCP) or version info (CLI)
Need numeric segments only?
  → Use Segments() / Segments64()
Need suffix semantic weight?
  → Use SuffixWeight() or GetSuffixWeight()
Need the group key for Group()?
  → Use BuildGroupID()
Need a clean prefix string?
  → Use Prefix.PurePrefix()

Task Patterns

Get all numeric segments

Goal: Extract the version number components as a slice.

Determine suffix type and weight

Goal: Classify the prerelease suffix and get its ordering weight.

Extract sub-version number from suffix

Goal: Get the numeric part of a prerelease suffix (e.g., beta2 -> 2).

Get the group ID for grouping

Goal: Obtain the key used by Group() to cluster versions.

Clean a prefix string

Goal: Strip trailing delimiter characters from a prefix.

Deep-copy a version

Goal: Create an independent copy safe for mutation.

API Reference

SDK — Segment Accessors

v.Major() int           // VersionNumbers[0] or 0
v.Minor() int           // VersionNumbers[1] or 0
v.Patch() int           // VersionNumbers[2] or 0
v.Segments() []int      // all VersionNumbers
v.Segments64() []int64  // as int64

SDK — Suffix Properties

v.SubVersion() int                    // numeric from suffix (e.g. "beta2" → 2, "-beta" → 0)
v.SuffixWeight() SuffixWeight         // semantic ordering weight on the Version
versions.GetSuffixWeight(s string) SuffixWeight  // package-level: weight of any suffix string

Suffix weight ordering:

SDK — Prefix, Group, Clone, Serialization

v.Prefix.PurePrefix() string   // prefix without trailing delimiters, e.g. "curl-" → "curl"
v.BuildGroupID() string        // group key, e.g. "v1.2.3-beta1" → "1.2.3"
v.Clone() *Version             // deep copy, independent of original
v.RawString() string           // original parsed string (human-readable, unlike String())

CLI Commands

versions segments <v>            # {"segments": [1, 2, 3]}
versions sub-version <v>         # {"sub_version": 2}
versions suffix-weight <v>       # {"suffix_weight": "rc", "weight_value": 400}
versions pure-prefix <v>         # {"prefix": "curl-", "pure_prefix": "curl"}
versions group-id <v>            # {"group_id": "1.2.3"}
versions clone <v>               # full version object as JSON

MCP Tools

Cross-References

• [[version-check]] — boolean checks on version type (IsBeta, IsStable, etc.)
• [[version-grouping]] — Group() uses BuildGroupID() for clustering
• [[version-comparison]] — CompareTo uses SuffixWeight for ordering
• [[version-mutation]] — modify version components after inspecting them

Important Notes

• Suffix weight order: dev(50) < snapshot(60) < nightly(70) < alpha(100) < beta(200) < milestone(300) < rc(400) < final/release/ga(500) < sp(600) < patch(700) < post(800)
• SubVersion() returns 0 if the suffix has no numeric part ("-beta" -> 0, "-beta2" -> 2).
• PurePrefix() strips trailing -, ., _ — use it to extract a clean package name.
• BuildGroupID() is the key for Group() — versions differing only by suffix share the same group.
• Clone() creates a fully independent deep copy — safe for concurrent modification.
• RawString() returns the original parsed string; String() returns a different (JSON) format.