semver #

Description

semver is a library for processing versions, that use the semver format.

Examples

import semver

fn main() {
    ver1 := semver.from('1.2.4') or {
        println('Invalid version')
        return
    }
    ver2 := semver.from('2.3.4') or {
        println('Invalid version')
        return
    }
    println(ver1 > ver2)
    println(ver2 > ver1)
    println(ver1.satisfies('>=1.1.0 <2.0.0'))
    println(ver2.satisfies('>=1.1.0 <2.0.0'))
    println(ver2.satisfies('>=1.1.0 <2.0.0 || >2.2.0'))
}

false
true
true
false
true

For more details see semver.v file.

fn build(major int, minor int, patch int) Version

build returns a Version structure with given major, minor and patch versions.

fn coerce(input string) !Version

• Utilities.coerce converts the input version to a Version struct. coerce will strip any contents after the parsed version string:

fn from(input string) !Version

• Constructor.from returns a Version structure parsed from input string.

fn is_valid(input string) bool

is_valid returns true if the input string can be converted to a (semantic) Version struct.

fn (err EmptyInputError) msg() string

fn (err InvalidVersionFormatError) msg() string

enum Increment {
	major
	minor
	patch
}

Increment represents the different types of version increments.

struct Version {
pub:
	major      int
	minor      int
	patch      int
	prerelease string
	metadata   string
}

• Structures.Version represents a semantic version in semver format.

fn (ver Version) increment(typ Increment) Version

• Transformation.increment returns a Version structure with incremented values.

fn (ver Version) satisfies(input string) bool

• Comparison.satisfies returns true if the input expression can be validated to true when run against this Version.

assert semver.build(1,0,0).satisfies('<=2.0.0') == true

assert semver.build(1,0,0).satisfies('>=2.0.0') == false

fn (v1 Version) == (v2 Version) bool

== checks if v1 is equal to v2

fn (v1 Version) < (v2 Version) bool

< checks if v1 is less than v2.

fn (ver Version) str() string

str returns the string representation of the Version.