Description

nodeset is a Rust library and command-line tool (ns) that deals with nodesets. It is heavily inspired by clustershell and aims at supporting the same nodeset representation.

A nodeset is a set of names which are generally indexed over one or more integer dimensions such as node1 or r1sw2-port0. Large nodesets can be represented in a compact way using a bracket notation such as node[1-1000]. When brackets are used in multiple dimensions, it implies a cartesian product. For example: r[1-2]sw[1-2]-port[1-2] represents 8 ports: r1sw1-port1,r1sw1-port2,r1sw2-port1,...,r2sw2-port2.

ns allows to fold or expand nodesets, as well as to perform algebraic operations on them (union, intersection, difference, ...)

Command line examples

• Listing nodes:

$ ns list r[2-4/2]sw1-port[23-24]
r2esw1-port23 r2sw1-port24 r4sw1-port23 r4sw1-port24

• Folding nodes:

$ ns fold r2esw1-port23 r2sw1-port24 r4sw1-port23 r4sw1-port24
r[2,4]esw1-port[23-24]

• Counting nodes:

$ ns count r[2-4/2]esw1-port[23-24]
4

• Algebraic operations using operators:

$ ns fold 'node[0-10] - (node[0-5] node[7-10])'
node6

$ ns fold 'node[1-2] ^ node[2-3]'
node[1,3]

Configuration files and groups

ns understands and uses clustershell's configuration files in which node groups can be defined. Please refer to clustershell's documentation for a full description of the configuration files syntax.

Library usage example

To compute and display the intersection of two nodesets

    use nodeset::NodeSet;

    let ns1: NodeSet = "node[01-15]".parse().unwrap();
    let ns2: NodeSet = "node[10-30/2]".parse().unwrap();
    let inter = ns1.intersection(&ns2);
    assert_eq!(inter.to_string(), "node[10,12,14]");

Why use this crate

This project is not as mature as clustershell's nodeset and has fewer features. However, compared to clustershell's nodeset tool written in Python, ns starts much faster as it doesn't rely on an interpreter. It can save a lot of time when performing multiple operations on nodesets in a shell script. It is also faster at parsing and performing operations on large nodesets. The library crate can also be used to handle nodesets natively in Rust while sharing group definitions with clustershell.

Similar rust projects

• nodeagg
• hostlist
• hostlist-parser