Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ariel-rodriguez/sh-semversion-2

POSIX tool for semversion
https://github.com/ariel-rodriguez/sh-semversion-2

bourne-shell compare compare-versions npm-version npx npx-version posix semversion sh versioning

Last synced: 2 months ago
JSON representation

POSIX tool for semversion

Host: GitHub
URL: https://github.com/ariel-rodriguez/sh-semversion-2
Owner: Ariel-Rodriguez
License: mit
Created: 2020-11-23T13:59:09.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2023-02-08T00:01:59.000Z (almost 2 years ago)
Last Synced: 2024-09-19T01:13:53.112Z (4 months ago)
Topics: bourne-shell, compare, compare-versions, npm-version, npx, npx-version, posix, semversion, sh, versioning
Language: Shell
Homepage:
Size: 39.1 KB
Stars: 50
Watchers: 3
Forks: 8
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # sh-semversion-2

[![checks](https://github.com/Ariel-Rodriguez/sh-semversion-2/actions/workflows/github-ci.yml/badge.svg?branch=main)](https://github.com/Ariel-Rodriguez/sh-semversion-2/actions/workflows/github-ci.yml)

SH script to compare versions using semversion 2.0 spec.

- highly-cross-compatible shell compliant with the POSIX standard.

- Semversion 2.0 compliant: https://semver.org/

#

| Method   | Command                                                                                                |

| :------- | :----------------------------------------------------------------------------------------------------- |

| **npx**  | `npx --no-install git+https://github.com/Ariel-Rodriguez/sh-semversion-2.git 1.0.0 2.0.0`              |

| **curl** | `curl https://raw.githubusercontent.com/Ariel-Rodriguez/sh-semversion-2/main/semver2.sh -o semver2.sh` |

| **wget** | `wget https://raw.githubusercontent.com/Ariel-Rodriguez/sh-semversion-2/main/semver2.sh`               |

###

Param 1

Param 2

1.0.0

0.1.0

1

1.0.0-alpha

1.0.0+metadata.build.1

-1

1.0.0+metadata.build.1

1.0.0+metadata.build.2

0

- When A greater than B: returns 1

- When A equals than B: returns 0

- When A lower than B:returns -1

# Usage

```sh

npx sh-semversion-2 1.0.0-rc.0.a+metadata v1.0.0-rc.0+metadata

# output 1

```

```sh

./semver2.sh 1.0.0-rc.0.a+metadata v1.0.0-rc.0+metadata

# output  1

```

## Tests

```sh

./test.sh print-only-failures

# abort on first failure match

./test.sh print-only-failures early-exit=true

```

```sh

# semver2.0 happy path tests ordered by precedence

# spec 11.4

tests=(

  1.0.0-0--1

  1.0.0-0-0

  1.0.0-0-0.alpha

  1.0.0-0-1

  1.0.0-alpha

  1.0.0-alpha.1

  1.0.0-alpha.beta

  1.0.0-beta

  1.0.0-beta.2

  1.0.0-beta.11

  1.0.0-rc.1

  1.0.0+metadata.0.0.0

  2.0.0-ALPHA

  2.0.0-alpha

)

```

```sh

OK 1.0.0-alpha = 1.0.0-alpha

OK 1.0.0-alpha < 1.0.0-alpha.1

OK 1.0.0-alpha < 1.0.0-alpha.beta

OK 1.0.0-alpha < 1.0.0-beta

OK 1.0.0-alpha < 1.0.0-beta.2

OK 1.0.0-alpha < 1.0.0-beta.11

OK 1.0.0-alpha < 1.0.0-rc.1

OK 1.0.0-alpha < 1.0.0+metadata.0.0.0

OK 1.0.0-alpha < 2.0.0-ALPHA

OK 1.0.0-alpha < 2.0.0-alpha

OK 1.0.0-alpha.1 > 1.0.0-alpha

OK 1.0.0-alpha.1 = 1.0.0-alpha.1

OK 1.0.0-alpha.1 < 1.0.0-alpha.beta

OK 1.0.0-alpha.1 < 1.0.0-beta

OK 1.0.0-alpha.1 < 1.0.0-beta.2

OK 1.0.0-alpha.1 < 1.0.0-beta.11

OK 1.0.0-alpha.1 < 1.0.0-rc.1

OK 1.0.0-alpha.1 < 1.0.0+metadata.0.0.0

OK 1.0.0-alpha.1 < 2.0.0-ALPHA

OK 1.0.0-alpha.1 < 2.0.0-alpha

OK 1.0.0-alpha.beta > 1.0.0-alpha

OK 1.0.0-alpha.beta > 1.0.0-alpha.1

OK 1.0.0-alpha.beta = 1.0.0-alpha.beta

OK 1.0.0-alpha.beta < 1.0.0-beta

OK 1.0.0-alpha.beta < 1.0.0-beta.2

OK 1.0.0-alpha.beta < 1.0.0-beta.11

OK 1.0.0-alpha.beta < 1.0.0-rc.1

OK 1.0.0-alpha.beta < 1.0.0+metadata.0.0.0

OK 1.0.0-alpha.beta < 2.0.0-ALPHA

OK 1.0.0-alpha.beta < 2.0.0-alpha

OK 1.0.0-beta > 1.0.0-alpha

OK 1.0.0-beta > 1.0.0-alpha.1

OK 1.0.0-beta > 1.0.0-alpha.beta

OK 1.0.0-beta = 1.0.0-beta

OK 1.0.0-beta < 1.0.0-beta.2

OK 1.0.0-beta < 1.0.0-beta.11

OK 1.0.0-beta < 1.0.0-rc.1

OK 1.0.0-beta < 1.0.0+metadata.0.0.0

OK 1.0.0-beta < 2.0.0-ALPHA

OK 1.0.0-beta < 2.0.0-alpha

OK 1.0.0-beta.2 > 1.0.0-alpha

OK 1.0.0-beta.2 > 1.0.0-alpha.1

OK 1.0.0-beta.2 > 1.0.0-alpha.beta

OK 1.0.0-beta.2 > 1.0.0-beta

OK 1.0.0-beta.2 = 1.0.0-beta.2

OK 1.0.0-beta.2 < 1.0.0-beta.11

OK 1.0.0-beta.2 < 1.0.0-rc.1

OK 1.0.0-beta.2 < 1.0.0+metadata.0.0.0

OK 1.0.0-beta.2 < 2.0.0-ALPHA

OK 1.0.0-beta.2 < 2.0.0-alpha

OK 1.0.0-beta.11 > 1.0.0-alpha

OK 1.0.0-beta.11 > 1.0.0-alpha.1

OK 1.0.0-beta.11 > 1.0.0-alpha.beta

OK 1.0.0-beta.11 > 1.0.0-beta

OK 1.0.0-beta.11 > 1.0.0-beta.2

OK 1.0.0-beta.11 = 1.0.0-beta.11

OK 1.0.0-beta.11 < 1.0.0-rc.1

OK 1.0.0-beta.11 < 1.0.0+metadata.0.0.0

OK 1.0.0-beta.11 < 2.0.0-ALPHA

OK 1.0.0-beta.11 < 2.0.0-alpha

OK 1.0.0-rc.1 > 1.0.0-alpha

OK 1.0.0-rc.1 > 1.0.0-alpha.1

OK 1.0.0-rc.1 > 1.0.0-alpha.beta

OK 1.0.0-rc.1 > 1.0.0-beta

OK 1.0.0-rc.1 > 1.0.0-beta.2

OK 1.0.0-rc.1 > 1.0.0-beta.11

OK 1.0.0-rc.1 = 1.0.0-rc.1

OK 1.0.0-rc.1 < 1.0.0+metadata.0.0.0

OK 1.0.0-rc.1 < 2.0.0-ALPHA

OK 1.0.0-rc.1 < 2.0.0-alpha

OK 1.0.0+metadata.0.0.0 > 1.0.0-alpha

OK 1.0.0+metadata.0.0.0 > 1.0.0-alpha.1

OK 1.0.0+metadata.0.0.0 > 1.0.0-alpha.beta

OK 1.0.0+metadata.0.0.0 > 1.0.0-beta

OK 1.0.0+metadata.0.0.0 > 1.0.0-beta.2

OK 1.0.0+metadata.0.0.0 > 1.0.0-beta.11

OK 1.0.0+metadata.0.0.0 > 1.0.0-rc.1

OK 1.0.0+metadata.0.0.0 = 1.0.0+metadata.0.0.0

OK 1.0.0+metadata.0.0.0 < 2.0.0-ALPHA

OK 1.0.0+metadata.0.0.0 < 2.0.0-alpha

OK 2.0.0-ALPHA > 1.0.0-alpha

OK 2.0.0-ALPHA > 1.0.0-alpha.1

OK 2.0.0-ALPHA > 1.0.0-alpha.beta

OK 2.0.0-ALPHA > 1.0.0-beta

OK 2.0.0-ALPHA > 1.0.0-beta.2

OK 2.0.0-ALPHA > 1.0.0-beta.11

OK 2.0.0-ALPHA > 1.0.0-rc.1

OK 2.0.0-ALPHA > 1.0.0+metadata.0.0.0

OK 2.0.0-ALPHA = 2.0.0-ALPHA

OK 2.0.0-ALPHA < 2.0.0-alpha

OK 2.0.0-alpha > 1.0.0-alpha

OK 2.0.0-alpha > 1.0.0-alpha.1

OK 2.0.0-alpha > 1.0.0-alpha.beta

OK 2.0.0-alpha > 1.0.0-beta

OK 2.0.0-alpha > 1.0.0-beta.2

OK 2.0.0-alpha > 1.0.0-beta.11

OK 2.0.0-alpha > 1.0.0-rc.1

OK 2.0.0-alpha > 1.0.0+metadata.0.0.0

OK 2.0.0-alpha > 2.0.0-ALPHA

OK 2.0.0-alpha = 2.0.0-alpha

```

# development

## How to debug

- Enable [DEBUG] messages

```sh

./semver2.sh v0.0.1 v0.0.1-rc debug

DEBUG: Detected: 0 0 1 identifiers:

DEBUG: Detected: 0 0 1 identifiers: rc

DEBUG: MAJOR are equal

DEBUG: MINOR are equal

DEBUG: PATCH are equal

DEBUG: Because releases without pre-release identifiers have higher precedence

1

```

- Enable verbose

```sh

./semver2.sh v0.0.1 v0.0.1-rc debug verbose

+ printf %s v0.0.1

+ cut -d+ -f 1

+ version_a=v0.0.1

+ removeLeadingV v0.0.1

+ printf %s0.0.1

+ version_a=0.0.1

+ printf %s v0.0.1-rc

+ cut -d+ -f 1

+ version_b=v0.0.1-rc

+ removeLeadingV v0.0.1-rc

+ printf %s0.0.1-rc

+ version_b=0.0.1-rc

+ printf %s 0.0.1

+ cut -d. -f 1

+ a_major=0

+ printf %s 0.0.1

+ cut -d. -f 2

+ a_minor=0

+ printf %s 0.0.1

+ + cut -d- -f 1

cut -d. -f 3

+ a_patch=1

+ a_pre=

+ includesString 0.0.1 -

+ string=0.0.1

+ substring=-

+ [ 0.0.1 != 0.0.1 ]

+ printf 0

+ return 0

+ [ 0 = 1 ]

+ printf %s 0.0.1-rc

+ cut -d. -f 1

+ b_major=0

+ printf %s 0.0.1-rc

+ cut -d. -f 2

+ b_minor=0

+ printf %s 0.0.1-rc

+ cut -d. -f 3

+ cut -d- -f 1

+ b_patch=1

+ b_pre=

+ includesString 0.0.1-rc -

+ string=0.0.1-rc

+ substring=-

+ [ rc != 0.0.1-rc ]

+ printf 1

+ return 1

+ [ 1 = 1 ]

+ printf %s 0.0.1-rc

+ cut -d- -f 2

+ b_pre=rc

+ unit_types=MAJOR MINOR PATCH

+ a_normalized=0 0 1

+ b_normalized=0 0 1

+ debug Detected: 0 0 1 identifiers:

+ [ debug = debug ]

+ printf DEBUG: %sDetected: 0 0 1 identifiers:  \n

+ debug Detected: 0 0 1 identifiers: rc

+ [ debug = debug ]

+ printf DEBUG: %sDetected: 0 0 1 identifiers: rc \n

+ cursor=1

+ [ 1 -lt 4 ]

+ printf %s 0 0 1

+ cut -d  -f 1

+ a=0

+ printf %s 0 0 1

+ cut -d  -f 1

+ b=0

+ [ 0 != 0 ]

+ printf %s MAJOR MINOR PATCH

+ cut -d  -f 1

+ debug MAJOR are equal

+ [ debug = debug ]

+ printf DEBUG: %sMAJOR are equal \n

+ cursor=2

+ [ 2 -lt 4 ]

+ printf %s 0 0 1

+ cut -d  -f 2

+ a=0

+ printf %s 0 0 1

+ cut -d  -f 2

+ b=0

+ [ 0 != 0 ]

+ printf %s MAJOR MINOR PATCH

+ cut -d  -f 2

+ debug MINOR are equal

+ [ debug = debug ]

+ printf DEBUG: %sMINOR are equal \n

+ cursor=3

+ [ 3 -lt 4 ]

+ printf %s 0 0 1

+ cut -d  -f 3

+ a=1

+ printf %s 0 0 1

+ cut -d  -f 3

+ b=1

+ [ 1 != 1 ]

+ printf %s MAJOR MINOR PATCH

+ cut -d  -f 3

+ debug PATCH are equal

+ [ debug = debug ]

+ printf DEBUG: %sPATCH are equal \n

+ cursor=4

+ [ 4 -lt 4 ]

+ [ -z  ]

+ [ -z rc ]

+ [ -z  ]

+ debug Because releases without pre-release identifiers have higher precedence

+ [ debug = debug ]

+ printf DEBUG: %sBecause releases without pre-release identifiers have higher precedence \n

+ outcome 1

+ result=1

+ printf %s1\n

+ return

DEBUG: Detected: 0 0 1 identifiers:

DEBUG: Detected: 0 0 1 identifiers: rc

DEBUG: MAJOR are equal

DEBUG: MINOR are equal

DEBUG: PATCH are equal

DEBUG: Because releases without pre-release identifiers have higher precedence

1

```