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
58
59
60
61
62
63

// 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;
use crate::launcher;

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

    /// Show only launcher names.
    #[arg(long, display_order = 0, conflicts_with = "all")]
    short: bool,
}

/** Show the launchers.

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

    let launchers = launcher::Configuration::open()?;

    if args.all {
        info!("All launcher configurations:");
        write!(
            output,
            "{}",
            &toml::to_string_pretty(launchers.full_config())?
        )?;
    } else {
        let clusters = cluster::Configuration::open()?;
        let cluster = clusters.identify(options.cluster.as_deref())?;

        if args.short {
            for launcher_name in launchers.by_cluster(&cluster.name).keys() {
                writeln!(output, "{launcher_name}")?;
            }
        } else {
            info!("Launcher configurations for cluster '{}':", cluster.name);
            write!(
                output,
                "{}",
                &toml::to_string_pretty(&launchers.by_cluster(&cluster.name))?
            )?;
        }
    }

    Ok(())
}