#semver #versioning #nu #nushell-plugin #plugin

app nu_plugin_semver

A nushell plugin for dealing with SemVer versions

2 unstable releases

0.2.0 Feb 8, 2024
0.1.0 Jan 11, 2024

#19 in #nushell-plugin

Download history 10/week @ 2024-01-09 6/week @ 2024-02-06 4/week @ 2024-02-13 22/week @ 2024-02-20 26/week @ 2024-02-27 2/week @ 2024-03-12

53 downloads per month

MIT and maybe CC-PDDC

26KB
530 lines

Nushell plugin to deal with SemVer versions

This is a plugin for the nu shell to manipulate strings representing versions that conform to the SemVer specification.

Installation

You can compile from source by checking out this repository and running cargo install --path ., or installing the latest version with cargo install nu_plugin_semver.

In both cases you then need to register the plugin by running register /path/to/nu_plugin_semver from within nu. Typically, the plugin can be found in $HOME/.cargo/bin/.

Examples

# Deconstruct version into record for manipulation, then back to string again."1.2.3-alpha.1+build" | semver to-record
╭───────┬─────────╮
│ major │ 1       │
│ minor │ 2       │
│ patch │ 3       │
│ pre   │ alpha.1 │
│ build │ build   │
╰───────┴─────────╯

❯ "1.2.3-alpha.1+build" | semver to-record | update build "foo" | semver from-record
1.2.3-alpha.1+foo

# Or use the `bump` command:"1.2.3-alpha.1+build" | semver bump beta
1.2.3-beta.1+build

❯ "1.2.3-alpha.1+build" | semver bump major
2.0.0

# Sort versions using SemVer semantics:["3.2.1", "2.3.4", "3.2.2", "2.3.4-beta.1", "2.3.4-alpha.1", "2.3.4-alpha.2"] | semver sort
╭───┬───────────────╮
│ 02.3.4-alpha.1 │
│ 12.3.4-alpha.2 │
│ 22.3.4-beta.1  │
│ 32.3.4         │
│ 43.2.1         │
│ 53.2.2         │
╰───┴───────────────╯

# Match a SemVer version against a version requirement.
>  "3.2.1" | semver match-req "3"
true

>  "3.2.1" | semver match-req ">=2"
true

>  "3.2.1" | semver match-req ">=2,<3"
false

Dependencies

~13–49MB
~715K SLoC