semantic

type AlpineVersion ¶ added in v0.4.5

type AlpineVersion struct {
	// contains filtered or unexported fields
}

AlpineVersion represents a version of an Alpine package.

Currently, the APK version specification is as follows: *number{.number}...{letter}{\_suffix{number}}...{~hash}{-r#}*

Each *number* component is a sequence of digits (0-9).

The *letter* portion can follow only after end of all the numeric version components. The *letter* is a single lower case letter (a-z). This can follow one or more *\_suffix{number}* components. The list of valid suffixes (and their sorting order) is: *alpha*, *beta*, *pre*, *rc*, <no suffix>, *cvs*, *svn*, *git*, *hg*, *p*

This can be follows with an optional *{~hash}* to indicate a commit hash from where it was built. This can be any length string of lower case hexadecimal digits (0-9a-f).

Finally, an optional package build component *-r{number}* can follow.

Also see https://github.com/alpinelinux/apk-tools/blob/master/doc/apk-package.5.scd#package-info-metadata

func ParseAlpineVersion(str string) (AlpineVersion, error)

func (v AlpineVersion) Compare(w Version) (int, error)

func (v AlpineVersion) CompareStr(str string) (int, error)

type CRANVersion ¶ added in v0.4.5

type CRANVersion struct {
	// contains filtered or unexported fields
}

CRANVersion is the representation of a version of a package that is held in the CRAN ecosystem (https://cran.r-project.org/).

A version is a sequence of at least two non-negative integers separated by either a period or a dash.

See https://astrostatistics.psu.edu/su07/R/html/base/html/package_version.html

func ParseCRANVersion(str string) (CRANVersion, error)

func (v CRANVersion) Compare(w Version) (int, error)

func (v CRANVersion) CompareStr(str string) (int, error)

type DebianVersion ¶ added in v0.4.5

type DebianVersion struct {
	// contains filtered or unexported fields
}

DebianVersion represents a version of a Debian package.

See https://man7.org/linux/man-pages/man7/deb-version.7.html

func ParseDebianVersion(str string) (DebianVersion, error)

func (v DebianVersion) Compare(w Version) (int, error)

func (v DebianVersion) CompareStr(str string) (int, error)

type HackageVersion ¶ added in v0.4.5

type HackageVersion struct {
	// contains filtered or unexported fields
}

HackageVersion is the representation of a version of a package that is held in the Hackage ecosystem.

See https://hackage-content.haskell.org/package/Cabal-syntax-3.16.1.0/docs/Distribution-Types-Version.html

func ParseHackageVersion(str string) (HackageVersion, error)

func (v HackageVersion) Compare(w Version) (int, error)

func (v HackageVersion) CompareStr(str string) (int, error)

type MavenVersion ¶ added in v0.4.5

type MavenVersion struct {
	// contains filtered or unexported fields
}

MavenVersion is the representation of a version of a package that is held in the Maven ecosystem.

See https://maven.apache.org/pom.html#version-order-specification

func ParseMavenVersion(str string) MavenVersion

func (mv MavenVersion) Compare(w Version) (int, error)

func (mv MavenVersion) CompareStr(str string) (int, error)

type NuGetVersion ¶ added in v0.4.5

type NuGetVersion struct {
	// contains filtered or unexported fields
}

NuGetVersion is the representation of a version of a package that is held in the NuGet ecosystem.

See https://learn.microsoft.com/en-us/nuget/concepts/package-versioning

func ParseNuGetVersion(str string) NuGetVersion

func (v NuGetVersion) Compare(w Version) (int, error)

func (v NuGetVersion) CompareStr(str string) (int, error)

type PackagistVersion ¶ added in v0.4.5

type PackagistVersion struct {
	// contains filtered or unexported fields
}

PackagistVersion is the representation of a version of a package that is held in the Packagist ecosystem.

func ParsePackagistVersion(str string) PackagistVersion

func (v PackagistVersion) Compare(w Version) (int, error)

func (v PackagistVersion) CompareStr(str string) (int, error)

type PubVersion ¶ added in v0.4.5

type PubVersion struct {
	// contains filtered or unexported fields
}

PubVersion is the representation of a version of a package that is held in the Pub ecosystem.

See https://pub.dev/packages/pub_semver

func ParsePubVersion(str string) PubVersion

func (v PubVersion) Compare(w Version) (int, error)

func (v PubVersion) CompareStr(str string) (int, error)

type PyPIVersion ¶ added in v0.4.5

type PyPIVersion struct {
	// contains filtered or unexported fields
}

PyPIVersion is the representation of a version of a package that is held in the PyPI ecosystem.

See https://peps.python.org/pep-0440/

func ParsePyPIVersion(str string) (PyPIVersion, error)

func (pv PyPIVersion) Compare(w Version) (int, error)

func (pv PyPIVersion) CompareStr(str string) (int, error)

type RedHatVersion ¶ added in v0.4.5

type RedHatVersion struct {
	// contains filtered or unexported fields
}

RedHatVersion is the representation of a version of a package that is held in the Red Hat ecosystem.

See https://docs.fedoraproject.org/en-US/packaging-guidelines/Versioning/

func ParseRedHatVersion(str string) RedHatVersion

func (v RedHatVersion) Compare(w Version) (int, error)

func (v RedHatVersion) CompareStr(str string) (int, error)

type RubyGemsVersion ¶ added in v0.4.5

type RubyGemsVersion struct {
	// contains filtered or unexported fields
}

RubyGemsVersion is the representation of a version of a package that is held in the RubyGems ecosystem.

func ParseRubyGemsVersion(str string) RubyGemsVersion

func (v RubyGemsVersion) Compare(w Version) (int, error)

func (v RubyGemsVersion) CompareStr(str string) (int, error)

type SemverVersion ¶ added in v0.4.5

type SemverVersion struct {
	// contains filtered or unexported fields
}

SemverVersion is the representation of a Semver 2.0.0 version.

See https://semver.org/spec/v2.0.0.html

func ParseSemverVersion(str string) SemverVersion

func (v SemverVersion) Compare(w Version) (int, error)

func (v SemverVersion) CompareStr(str string) (int, error)

type Version ¶

type Version interface {
	// Compare returns an integer representing the sort order of the given Version
	// relative to the subject Version.
	//
	// The result will be 0 if v == w, -1 if v < w, or +1 if v > w.
	//
	// ErrNotSameEcosystem is returned if the given Version is not of the same
	// ecosystem as the subject Version.
	Compare(v Version) (int, error)

	// CompareStr returns an integer representing the sort order of the given string
	// when parsed as the concrete Version relative to the subject Version.
	//
	// The result will be 0 if v == w, -1 if v < w, or +1 if v > w.
	//
	// An error is returned if the given string is not a valid Version, with "valid"
	// being dependent on the underlying ecosystem of the concrete Version.
	CompareStr(str string) (int, error)
}

Version provides an interface for sortable version strings.

func MustParse(str string, ecosystem string) Version

func Parse(str string, ecosystem string) (Version, error)