Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abusch/nu_plugin_semver
A nushell plugin to work with semver versions
https://github.com/abusch/nu_plugin_semver
Last synced: 17 days ago
JSON representation
A nushell plugin to work with semver versions
- Host: GitHub
- URL: https://github.com/abusch/nu_plugin_semver
- Owner: abusch
- License: mit
- Created: 2024-01-06T06:52:52.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-10-17T07:03:26.000Z (about 1 month ago)
- Last Synced: 2024-10-19T09:40:43.245Z (29 days ago)
- Language: Rust
- Size: 312 KB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nu - nu_plugin_semver
README
# Nushell plugin to deal with SemVer versions
This is a plugin for the [`nu`](https://nushell.sh) shell to manipulate strings representing versions that conform to the [SemVer](https://semver.org) 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 `plugin add /path/to/nu_plugin_semver` from within `nu`. Typically, the plugin can be found in `$HOME/.cargo/bin/`.
## Examples
```nu
# Parse a semver string into a semver value
> let v = "1.2.3-alpha.1+build" | into semver
# You can access individual fields of a version:
> $v.minor
2
# You can bump a version to different levels:
> $v | semver bump patch
1.2.3+build
> $v | semver bump major
2.0.0
# Semver values can be turned back into strings using
> $v | to text
# Semver values can be matched against a version requirement:
> let v = "3.2.1" | into semver
> $v | semver match-req "3"
true
> $v | semver match-req ">=2"
true
> $v | semver match-req ">=2,<3"
false
# Semver values can be sorted, according to 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"] | into semver | sort
╭───┬───────────────╮
│ 0 │ 2.3.4-alpha.1 │
│ 1 │ 2.3.4-alpha.2 │
│ 2 │ 2.3.4-beta.1 │
│ 3 │ 2.3.4 │
│ 4 │ 3.2.1 │
│ 5 │ 3.2.2 │
╰───┴───────────────╯
```