nu_plugin_semver 0.11.11

A nushell plugin for dealing with SemVer versions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

use std::ops::Deref;

use crate::{SemverPlugin, version::VersionValue};
use nu_plugin::{EvaluatedCall, SimplePluginCommand};
use nu_protocol::{Example, LabeledError, Signature, Type, Value};
pub struct SemverSort;

impl SimplePluginCommand for SemverSort {
    type Plugin = SemverPlugin;

    fn name(&self) -> &str {
        "semver sort"
    }

    fn description(&self) -> &str {
        "Sort a list of versions using SemVer ordering."
    }

    fn extra_description(&self) -> &str {
        "Note: every item in the list needs to be a well-formed SemVer version."
    }

    fn signature(&self) -> Signature {
        Signature::build(self.name())
            .switch(
                "reverse",
                "Sort the versions in descending order",
                Some('r'),
            )
            .input_output_type(
                Type::List(Box::new(Type::String)),
                Type::List(Box::new(Type::String)),
            )
    }

    fn examples(&'_ self) -> Vec<Example<'_>> {
        vec![Example {
            example: r#"["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"#,
            description: "sort versions by SemVer semantics.",
            result: Some(Value::test_list(vec![
                Value::test_string("2.3.4-alpha.1"),
                Value::test_string("2.3.4-alpha.2"),
                Value::test_string("2.3.4-beta.1"),
                Value::test_string("2.3.4"),
                Value::test_string("3.2.1"),
                Value::test_string("3.2.2"),
            ])),
        }]
    }

    fn run(
        &self,
        _plugin: &Self::Plugin,
        _engine: &nu_plugin::EngineInterface,
        call: &EvaluatedCall,
        input: &Value,
    ) -> Result<Value, LabeledError> {
        let reverse = call.has_flag("reverse")?;
        let span = call.head;
        let values = input.as_list()?;
        let mut versions = values
            .iter()
            .map(VersionValue::try_from)
            .collect::<Result<Vec<_>, _>>()?;
        versions.sort_by(|a, b| a.deref().cmp(b.deref()));
        if reverse {
            versions.reverse();
        }
        Ok(Value::list(
            versions.into_iter().map(|v| v.into_value()).collect(),
            span,
        ))
    }
}