version

Documentation

Overview

The version package implements version parsing. It also acts as guardian of the current client Juju version number.

Index

• Variables
• func CurrentArch() string
• func CurrentSeries() string
• type Binary
  • func MustParseBinary(s string) Binary
  • func ParseBinary(s string) (Binary, error)
  • func (v Binary) GetBSON() (interface{}, error)
  • func (v Binary) MarshalJSON() ([]byte, error)
  • func (vp *Binary) SetBSON(raw bson.Raw) error
  • func (v Binary) String() string
  • func (vp *Binary) UnmarshalJSON(data []byte) error
• type Number
  • func CurrentNumber() Number
  • func MustParse(s string) Number
  • func Parse(s string) (Number, error)
  • func (v Number) GetBSON() (interface{}, error)
  • func (v Number) IsDev() bool
  • func (v Number) Less(w Number) bool
  • func (v Number) MarshalJSON() ([]byte, error)
  • func (vp *Number) SetBSON(raw bson.Raw) error
  • func (v Number) String() string
  • func (vp *Number) UnmarshalJSON(data []byte) error

Variables

var Current = Binary{
	Number: CurrentNumber(),
	Series: CurrentSeries(),
	Arch:   CurrentArch(),
}

Current gives the current version of the system. If the file "FORCE-VERSION" is present in the same directory as the running binary, it will override this.

var Zero = Number{}

Zero is occasionally convenient and readable. Please don't change its value.

Functions

func CurrentArch

func CurrentArch() string

CurrentArch returns the architecture of the machine.

func CurrentSeries

func CurrentSeries() string

CurrentSeries returns the current Ubuntu release name.

Types

type Binary

type Binary struct {
	Number
	Series string
	Arch   string
}

Binary specifies a binary version of juju.

func MustParseBinary

func MustParseBinary(s string) Binary

MustParseBinary parses a binary version and panics if it does not parse correctly.

func ParseBinary

func ParseBinary(s string) (Binary, error)

ParseBinary parses a binary version of the form "1.2.3-series-arch".

func (Binary) GetBSON

func (v Binary) GetBSON() (interface{}, error)

GetBSON turns v into a bson.Getter so it can be saved directly on a MongoDB database with mgo.

func (Binary) MarshalJSON

func (v Binary) MarshalJSON() ([]byte, error)

func (*Binary) SetBSON

func (vp *Binary) SetBSON(raw bson.Raw) error

SetBSON turns v into a bson.Setter so it can be loaded directly from a MongoDB database with mgo.

func (Binary) String

func (v Binary) String() string

func (*Binary) UnmarshalJSON

func (vp *Binary) UnmarshalJSON(data []byte) error

type Number

type Number struct {
	Major int
	Minor int
	Patch int
	Build int
}

Number represents a juju version. When bugs are fixed the patch number is incremented; when new features are added the minor number is incremented and patch is reset; and when compatibility is broken the major version is incremented and minor and patch are reset. The build number is automatically assigned and has no well defined sequence. If the build number is greater than zero or the minor version is odd, it indicates that the release is still in development.

func CurrentNumber

func CurrentNumber() Number

CurrentNumber returns the version number.

func MustParse

func MustParse(s string) Number

MustParse parses a version and panics if it does not parse correctly.

func Parse

func Parse(s string) (Number, error)

Parse parses the version, which is of the form 1.2.3 giving the major, minor and release versions respectively.

func (Number) GetBSON

func (v Number) GetBSON() (interface{}, error)

GetBSON turns v into a bson.Getter so it can be saved directly on a MongoDB database with mgo.

func (Number) IsDev

func (v Number) IsDev() bool

IsDev returns whether the version represents a development version. A version with an odd-numbered minor component or a nonzero build component is considered to be a development version.

func (Number) Less

func (v Number) Less(w Number) bool

Less returns whether v is semantically earlier in the version sequence than w.

func (Number) MarshalJSON

func (v Number) MarshalJSON() ([]byte, error)

func (*Number) SetBSON

func (vp *Number) SetBSON(raw bson.Raw) error

SetBSON turns v into a bson.Setter so it can be loaded directly from a MongoDB database with mgo.

func (Number) String

func (v Number) String() string

func (*Number) UnmarshalJSON

func (vp *Number) UnmarshalJSON(data []byte) error