row 1.0.0

Row is a command line tool that helps you manage workflows on HPC resources.
Documentation 
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

// Copyright (c) 2024-2025 The Regents of the University of Michigan.
// Part of row, released under the BSD 3-Clause License.

use clap::Args;
use log::{debug, info};
use std::error::Error;
use std::io::Write;

use crate::cli::GlobalOptions;
use crate::cluster;

#[derive(Args, Debug)]
pub struct Arguments {
    /// Show all clusters.
    #[arg(long, display_order = 0)]
    all: bool,

    /// Show only the cluster name(s).
    #[arg(long, display_order = 0)]
    short: bool,
}

/// Show the cluster.
///
/// Print the cluster to stdout in toml format.
///
pub fn cluster<W: Write>(
    options: &GlobalOptions,
    args: &Arguments,
    output: &mut W,
) -> Result<(), Box<dyn Error>> {
    debug!("Showing clusters.");

    let clusters = cluster::Configuration::open()?;

    if args.all {
        if args.short {
            for cluster in clusters.cluster {
                writeln!(output, "{}", cluster.name)?;
            }
        } else {
            info!("All cluster configurations:");
            write!(output, "{}", &toml::to_string_pretty(&clusters)?)?;
        }
    } else {
        let cluster = clusters.identify(options.cluster.as_deref())?;
        info!("Cluster configurations for '{}':", cluster.name);

        if args.short {
            writeln!(output, "{}", cluster.name)?;
        } else {
            write!(output, "{}", &toml::to_string_pretty(&cluster)?)?;
        }
    }

    Ok(())
}