A go-language package for parsing, comparing, sorting and constraint-checking k0s version numbers. The API is modeled after hashicorp/go-version.
K0s versioning follows semver v2.0 with the exception that there is a special metadata field for the k0s build version like v1.23.4+k0s.1 which affects precedence while sorting or comparing version numbers.
The library should work fine for performing the same operations on non-k0s version numbers as long as there are maximum of 3 numeric segments (1.2.3), but this is not a priority. There are no dependencies.
import (
"fmt"
"github.com/k0sproject/version"
)
func main() {
a := version.MustParse("1.23.3+k0s.1")
b := version.MustParse("1.23.3+k0s.2")
fmt.Printf("a is greater than b: %t\n", a.GreaterThan(b))
fmt.Printf("a is less than b: %t\n", a.LessThan(b))
fmt.Printf("a is equal to b: %t\n", a.Equal(b))
}Outputs:
a is greater than b: false
a is less than b: true
a is equal to b: false
import (
"fmt"
"github.com/k0sproject/version"
)
func main() {
v := version.MustParse("1.23.3+k0s.1")
c := version.MustConstraint("> 1.23")
fmt.Printf("constraint %s satisfied by %s: %t\n", c, v, c.Check(v))
}Outputs:
constraint > 1.2.3 satisfied by v1.23.3+k0s.1: true
import (
"fmt"
"sort"
"github.com/k0sproject/version"
)
func main() {
versions := []*version.Version{
version.MustParse("v1.23.3+k0s.2"),
version.MustParse("1.23.2+k0s.3"),
version.MustParse("1.23.3+k0s.1"),
}
fmt.Println("Before:")
for _, v range versions {
fmt.Println(v)
}
sort.Sort(versions)
fmt.Println("After:")
for _, v range versions {
fmt.Println(v)
}
}Outputs:
Before:
v1.23.3+k0s.2
v1.23.2+k0s.3
v1.23.3+k0s.1
After:
v1.23.2+k0s.3
v1.23.3+k0s.1
v1.23.3+k0s.2
import (
"fmt"
"github.com/k0sproject/version"
)
func main() {
latest, err := version.Latest()
if err != nil {
panic(err)
}
fmt.Printf("Latest k0s version is: %s\n", latest)
}A command-line interface to the package. Can be used to sort lists of versions or to obtain the latest version number.
Usage: k0s_sort [options] [filename ...]
-l only print the latest version
-o print the latest version from online
-s omit prerelease versions
-v print k0s_sort version![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent