version

README

version

Dealing with versions.

Usage

see example

Documentation

Overview

Example

var v1 = "v1.1.0"
var v2 = "1.0.4"
var invalid = ".1.0"

vers1, err := version.Parse(v1)

if err != nil {
	fmt.Printf("could not parse version %q", v1)
}

vers2, err := version.Parse(v2)

if err != nil {
	fmt.Printf("could not parse version %q", v1)
}

if vers2.Less(*vers1) {
	fmt.Printf("version %s < version %s\n", vers2, vers1)
}

vers2.Minor = 1

if vers1.Less(*vers2) {
	fmt.Printf("version %s < version %s\n", vers1, vers2)
}

last := version.Versions{vers1, vers2}.Sort().Last()

fmt.Printf("last version is %s\n", last)

_, err = version.Parse(invalid)

if err != nil {
	fmt.Printf("could not parse version %q", invalid)
}

Output:

version 1.0.4 < version 1.1.0
version 1.1.0 < version 1.1.4
last version is 1.1.4
could not parse version ".1.0"

Index

• type Version
  • func BuildVersion() (v *Version)
  • func Parse(v string) (*Version, error)
  • func V(major int, nums ...int) (v Version)
  • func (me Version) Equals(o Version) bool
  • func (me Version) EqualsMajor(o Version) bool
  • func (me Version) EqualsMinor(o Version) bool
  • func (me Version) EqualsPatch(o Version) bool
  • func (me Version) Less(o Version) bool
  • func (me *Version) String() string
• type Versions
  • func (me Versions) First() *Version
  • func (me Versions) Last() *Version
  • func (me Versions) Len() int
  • func (me Versions) Less(a, b int) bool
  • func (me Versions) Sort() Versions
  • func (me Versions) Swap(a, b int)

Examples

• Package

Types

type Version

type Version struct {
	Major uint16
	Minor uint16
	Patch uint16
	Rest  string
}

Version represents a version (e.g. a release version)

func BuildVersion

func BuildVersion() (v *Version)

func Parse

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

Parse parses the version out of the given string. Valid strings are "v0.0.1" or "1.0" or "12" etc.

func V

func V(major int, nums ...int) (v Version)

V is a helper function to create Versions without a Rest with little effort. The first and obligatory is the major number. No more than two following numbers can be passed, otherwise the function panics. The following numbers are minor and patch. If just one following number is given, it is considered the minor number and patch will be 0. If just the major number is given, minor and patch will be 0

func (Version) Equals

func (me Version) Equals(o Version) bool

Equals is true when the version exactly equals the given version

func (Version) EqualsMajor

func (me Version) EqualsMajor(o Version) bool

EqualsMajor is true when the version equals the given version on the Major

func (Version) EqualsMinor

func (me Version) EqualsMinor(o Version) bool

EqualsMinor is true when the version equals the given version on the Major and Minor

func (Version) EqualsPatch

func (me Version) EqualsPatch(o Version) bool

EqualsPatch is true when the version equals the given version on the Major and Minor and Patch

func (Version) Less

func (me Version) Less(o Version) bool

Less returns true, if the Version is smaller than the given one.

func (*Version) String

func (me *Version) String() string

String returns the string representation of the version (without a preceeding v

type Versions

type Versions []*Version

Versions is a sortable slice of *Version

func (Versions) First

func (me Versions) First() *Version

First returns the first *Version of the slice.

func (Versions) Last

func (me Versions) Last() *Version

Last returns the last *Version of the slice.

func (Versions) Len

func (me Versions) Len() int

Len returns the number of *Version inside the slice

func (Versions) Less

func (me Versions) Less(a, b int) bool

Less returns true, if the version of index a is less than the version of index b

func (Versions) Sort

func (me Versions) Sort() Versions

Sort sorts the slice and returns it

func (Versions) Swap

func (me Versions) Swap(a, b int)

Swap swaps the *Version of the index a with that of the index b