SemVer for PicoLisp
27 Feb 2017You can get it on GitHub.
This library can validate and compare Major.Minor.Patch versions (ex: "1.0.0").
It ignores pre-release, build, metadata, and special extensions (ex: .alpha.1).
Requirements
- PicoLisp 32-bit or 64-bit v16.12+
Usage
- Include
semver.lin your application:(load "semver.l") - Use one of the 5 public functions listed below
| Function | Description | Returns | Example |
|---|---|---|---|
semver-format |
Formats a version string into a list of integers | List of integers | (1 4 2) |
semver-cmp |
Compares two lists of integers | List containing NIL, 0 or T | (NIL 0 T) |
semver-compare |
Compares two version strings | NIL, 0, or T | NIL |
semver-compare-slow |
Compares two version strings using the spaceship <=> |
NIL, 0, or T | T |
semver-sort |
Sorts a list of version strings | List of integers or strings | ((1 3 0) (1 4 0) (1 6 0)) or ("1.3.0" "1.4.0" "1.6.0") |
Version comparison is always from left to right.
A brief explanation of the result obtained from semver-compare:
if left < right then return NIL # left is older
if left = right then return 0 # left and right are the same
if left > right then return T # left is newer
Examples
1. Compare two version strings
(load "semver.l")
(semver-compare "1.4.0" "1.5.0")
-> NIL
(semver-compare "1.5.0" "1.5.0")
-> 0
(semver-compare "1.6.0" "1.5.0")
-> T
2. Format a version string into a list of integers
(load "semver.l")
(semver-format "1.4.0")
-> (1 4 0)
3. Compare two lists of integers
- The
(car)corresponds to themajor - The
(cadr)corresponds to theminor - The
(caddr)corresponds to thepatch
(load "semver.l")
(semver-cmp (2 3 2) (1 4 2))
-> (T NIL 0)
(semver-cmp (1 5 0) (1 4 2))
-> (0 T NIL)
(semver-cmp (2 3 2) (1 4 2))
-> (T NIL 0)
4. Sort a list of version strings
(load "semver.l")
(semver-sort '("1.4.0" "1.6.0" "1.3.0"))
-> ((1 3 0) (1 4 0) (1 6 0))
(semver-sort '("1.4.0" "1.6.0" "1.3.0") T)
-> ("1.3.0" "1.4.0" "1.6.0")