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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

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

use clap::{CommandFactory, Parser};
use clap_complete::env::CompleteEnv;
use clap_verbosity_flag::log::LevelFilter;
use indicatif::{MultiProgress, ProgressDrawTarget};
use indicatif_log_bridge::LogWrapper;
use log::info;
use std::error::Error;
use std::io::{self, Write};
use std::time::Instant;

use crate::cli;
use crate::ui;

use crate::MultiProgressContainer;
use crate::format::HumanDuration;
use cli::{ColorMode, Commands, Options, ShowCommands};
use ui::MultiProgressWriter;

pub(crate) fn main_detail() -> Result<(), Box<dyn Error>> {
    let instant = Instant::now();

    // Autocomplete
    CompleteEnv::with_factory(Options::command).complete();

    // Normal execution
    let options = Options::parse();

    let log_style;
    match options.global.color {
        ColorMode::Never => {
            log_style = "never";
            console::set_colors_enabled(false);
        }
        ColorMode::Always => {
            log_style = "always";
            console::set_colors_enabled(true);
        }
        ColorMode::Auto => {
            log_style = "auto";
        }
    }

    let log_level = match options.verbose.log_level_filter() {
        LevelFilter::Off => "off",
        LevelFilter::Error => "error",
        LevelFilter::Warn => "warn",

        LevelFilter::Info => "info",
        LevelFilter::Debug => "debug",
        LevelFilter::Trace => "trace",
    };

    let multi_progress = if options.global.no_progress {
        MultiProgress::with_draw_target(ProgressDrawTarget::hidden())
    } else {
        MultiProgress::new()
    };

    let mut output = MultiProgressWriter::new(io::stdout(), multi_progress.clone());

    let env = env_logger::Env::default()
        .filter_or("ROW_LOG", log_level)
        .write_style_or("ROW_LOG_STYLE", log_style);

    let logger = env_logger::Builder::from_env(env)
        .format_timestamp(None)
        .build();

    LogWrapper::new(multi_progress.clone(), logger).try_init()?;

    let mut multi_progress_container = MultiProgressContainer::new(multi_progress.clone());

    match options.command {
        Some(Commands::Init(args)) => {
            cli::init::init(&options.global, &args, &mut output)?;
        }
        Some(Commands::Show(show)) => match show {
            ShowCommands::Status(args) => cli::status::status(
                &options.global,
                args,
                &mut multi_progress_container,
                &mut output,
            )?,
            ShowCommands::Directories(args) => cli::directories::directories(
                &options.global,
                args,
                &mut multi_progress_container,
                &mut output,
            )?,
            ShowCommands::Cluster(args) => {
                cli::cluster::cluster(&options.global, &args, &mut output)?;
            }
            ShowCommands::Launchers(args) => {
                cli::launchers::launchers(&options.global, &args, &mut output)?;
            }
            ShowCommands::Jobs(args) => {
                cli::jobs::show(
                    &options.global,
                    args,
                    &mut multi_progress_container,
                    &mut output,
                )?;
            }
        },
        Some(Commands::Scan(args)) => {
            cli::scan::scan(&options.global, args, &mut multi_progress_container)?;
        }
        Some(Commands::Submit(args)) => cli::submit::submit(
            &options.global,
            args,
            &mut multi_progress_container,
            &mut output,
        )?,
        Some(Commands::Clean(args)) => {
            cli::clean::clean(&options.global, &args, &mut multi_progress_container)?;
        }
        None => (),
    }

    // Drop output here - otherwise it is dropped after multi_progress and the progress bars
    // are always cleared on exit.
    output.flush()?;
    drop(output);

    info!("Completed in {}.", HumanDuration(instant.elapsed()));

    if options.global.clear_progress {
        multi_progress.clear().unwrap();
    }

    Ok(())
}