https://github.com/abusch/nu_plugin_semver

A nushell plugin to work with semver versions
https://github.com/abusch/nu_plugin_semver

Last synced: about 2 months 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 (12 months ago)
• Default Branch: main
• Last Pushed: 2024-10-17T07:03:26.000Z (2 months ago)
• Last Synced: 2024-10-19T09:40:43.245Z (2 months 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         │

╰───┴───────────────╯

```