feat: initial version package (#1)

README.md

@@ -1 +1,129 @@
 # go-version
+
+[![Go Report Card](https://goreportcard.com/badge/github.com/bitnami/go-version)](https://goreportcard.com/report/github.com/bitnami/go-version)
+[![CI](https://github.com/bitnami/gonit/actions/workflows/go.yml/badge.svg)](https://github.com/bitnami/gonit/actions/workflows/go.yml)
+
+go-version is a library for parsing Bitnami packages versions and version constraints, and verifying versions against a set of constraints.
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Usage](#usage)
+  - [Version parsing and comparison](#version-parsing-and-comparison)
+  - [Version constraints](#version-constraints)
+    - [Version revision](#version-revision)
+    - [Missing major/minor/patch versions](#missing-majorminorpatch-versions)
+- [License](#license)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+## Usage
+
+Versions used with `version` package must follow [Semantic Versioning](https://semver.org/) with a small adjustments: **pre-release versions are considered revisions** and, therefore, the bigger the revision number, the newer the version.
+
+### Version parsing and comparison
+
+When two versions are compared using functions such as Compare, LessThan, and others, it will follow the specification and always include revisions within the comparison.
+It will provide an answer that is valid with the comparison section of [the spec](https://semver.org/#spec-item-11).
+
+```go
+v1, _ := version.Parse("1.2.0")
+v2, _ := version.Parse("1.2.1")
+
+// Comparison example. There is also GreaterThan, Equal, and just
+// a simple Compare that returns an int allowing easy >=, <=, etc.
+if v1.LessThan(v2) {
+    fmt.Printf("%s is less than %s", v1, v2)
+}
+```
+
+### Version constraints
+
+Comma-separated version constraints are considered an `AND`. For example, `>= 1.2.3, < 2.0.0` means the version needs to be greater than or equal to `1.2` and less than `3.0.0`.
+In addition, they can be separated by `|| (OR)`. For example, `>= 1.2.3, < 2.0.0 || > 4.0.0` means the version needs to be greater than or equal to `1.2` and less than `3.0.0`, or greater than `4.0.0`.
+
+```go
+v, _ := version.Parse("2.1.0")
+c, _ := version.NewConstraints(">= 1.0, < 1.4 || > 2.0")
+
+if c.Check(v) {
+    fmt.Printf("%s satisfies constraints '%s'", v, c)
+}
+```
+
+Supported operators:
+
+- `=` : you accept that exact version
+- `!=` : not equal
+- `>` : you accept any version higher than the one you specify
+- `>=` : you accept any version equal to or higher than the one you specify
+- `<` : you accept any version lower to the one you specify
+- `<=` : you accept any version equal or lower to the one you specify
+- `^` : it will only do updates that do not change the leftmost non-zero number.
+  - e.g. `^1.2.3` := `>=1.2.3, <2.0.0`
+- `~` : allows patch-level changes if a minor version is specified on the comparator. Allows minor-level changes if not.
+  - e.g. `~1.2.3` := `>=1.2.3, <1.3.0`
+
+#### Version revision
+
+A revision may be denoted by appending a hyphen and a series of dot separated identifiers immediately following the patch version. Revision have a greater precedence than the associated normal version (e.g. `1.2.3-1 > 1.2.3`).
+
+```go
+v, _ := version.Parse("2.0.0")
+c, _ := version.NewConstraints(">2.0.0-2")
+
+c.Check(v) // false
+```
+
+Comparisons include revisions even with no revisions constraint:
+
+```go
+v, _ := version.Parse("2.0.0-1")
+c, _ := version.NewConstraints(">2.0.0")
+
+c.Check(v) // true
+```
+
+#### Missing major/minor/patch versions
+
+If some of major/minor/patch versions are not specified, it is treated as `*` by default. In short, `3.1.3` satisfies `= 3` because `= 3` is converted to `= 3.*.*`.
+
+```go
+v, _ := version.Parse("2.3.4")
+c, _ := version.NewConstraints("=2")
+
+c.Check(v) // true
+```
+
+Then, `2.2.3` doesn't satisfy `> 2` as `> 2` is treated as `> 2.*.*` = `>= 3.0.0`
+
+```go
+v, _ := version.Parse("2.2.3")
+c, _ := version.NewConstraints(">2")
+
+c.Check(v) // false
+```
+
+`3.3.9` satisifies `= 3.3`, and `5.1.2` doesn't satisfy `> 5.1` likewise.
+
+If you want to treat them as 0, you can pass `version.WithZeroPadding(true)` as an argument of `version.NewConstraints`
+
+```go
+v, _ := version.Parse("2.3.4")
+c, _ := version.NewConstraints("= 2", version.WithZeroPadding(true))
+
+c.Check(v) // false
+```
+
+## License
+
+Copyright &copy; 2023 VMware, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License.

go.mod

@@ -0,0 +1,15 @@
+module github.com/bitnami/go-version
+
+go 1.20
+
+require (
+	github.com/aquasecurity/go-version v0.0.0-20210121072130-637058cfe492
+	github.com/stretchr/testify v1.8.4
+)
+
+require (
+	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/pmezard/go-difflib v1.0.0 // indirect
+	golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)

go.sum

@@ -0,0 +1,24 @@
+github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
+github.com/aquasecurity/go-version v0.0.0-20210121072130-637058cfe492 h1:rcEG5HI490FF0a7zuvxOxen52ddygCfNVjP0XOCMl+M=
+github.com/aquasecurity/go-version v0.0.0-20210121072130-637058cfe492/go.mod h1:9Beu8XsUNNfzml7WBf3QmyPToP1wm1Gj/Vc5UJKqTzU=
+github.com/cpuguy83/go-md2man/v2 v2.0.0-20190314233015-f79a8a8ca69d/go.mod h1:maD7wRr/U5Z6m/iR4s+kqSMx2CaBsrgA7czyZG/E6dU=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/russross/blackfriday/v2 v2.0.1/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/shurcooL/sanitized_anchor_name v1.0.0/go.mod h1:1NzhyTcUVG4SuEtjjoZeVRXNmyL/1OwPU0+IJeTBvfc=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/urfave/cli/v2 v2.3.0/go.mod h1:LJmUH05zAU44vOAcrfzZQKsZbVcdbOG8rtL3/XcUArI=
+golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE=
+golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v2 v2.2.3/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=