tldr-cli 0.4.0

CLI binary for TLDR code analysis tool
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

//! `tldr daemon list` — print all live daemon entries from the v0.3.0
//! multi-daemon registry.
//!
//! Supersedes `daemon status`'s implicit single-daemon assumption: when
//! multiple daemons are running, users invoke `daemon list` to enumerate
//! them and `daemon status --project <path>` (or `daemon stop --project
//! <path> | --all`) to operate on a chosen one.

use clap::Args;
use serde::Serialize;

use crate::output::OutputFormat;

use super::daemon_registry::{live_entries, DaemonRegistryEntry};

/// Arguments for the `daemon list` command.
///
/// Output format is controlled by the global `--format` flag (default
/// `json`). No subcommand-local flags are required; the registry contents
/// fully describe the output.
#[derive(Debug, Clone, Args, Default)]
pub struct DaemonListArgs {}

/// JSON output shape: `{"daemons": [...entries...]}`.
#[derive(Debug, Serialize)]
struct DaemonListOutput<'a> {
    daemons: &'a [DaemonRegistryEntry],
}

impl DaemonListArgs {
    /// Run the daemon list command.
    pub fn run(&self, format: OutputFormat, quiet: bool) -> anyhow::Result<()> {
        let entries = live_entries();

        if quiet {
            return Ok(());
        }

        match format {
            OutputFormat::Json | OutputFormat::Compact => {
                let out = DaemonListOutput { daemons: &entries };
                println!("{}", serde_json::to_string_pretty(&out)?);
            }
            OutputFormat::Text | OutputFormat::Sarif | OutputFormat::Dot => {
                if entries.is_empty() {
                    println!("No daemons running");
                } else {
                    println!("PROJECT\tPID\tSOCKET\tSTARTED_AT");
                    for e in &entries {
                        println!(
                            "{}\t{}\t{}\t{}",
                            e.project.display(),
                            e.pid,
                            e.socket.display(),
                            e.started_at
                        );
                    }
                }
            }
        }
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn list_args_default_constructs() {
        let _args = DaemonListArgs::default();
    }
}