inferno 0.11.19

Rust port of the FlameGraph performance profiling tool suite
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

use std::io;
use std::path::PathBuf;

use clap::{ArgAction, ArgGroup, Parser};
use env_logger::Env;
use inferno::collapse::ghcprof::{Folder, Options, Source};
use inferno::collapse::Collapse;

#[derive(Debug, Parser)]
#[clap(
    name = "inferno-collapse-ghcprof",
    about,
    after_help = "\
[1] This processes the .prof output of GHC (Glasgow Haskell Compiler)
    "
)]
#[command(group(
    ArgGroup::new("source")
        .required(false)
        .args(["time", "bytes", "ticks"]),
))]
struct Opt {
    // ************* //
    // *** FLAGS *** //
    // ************* //
    /// Source stack cost centre from the %time column (individual total % of runtime)
    /// (This is the default if no cost centre specified)
    #[clap(long = "time")]
    time: bool,
    /// Source stack cost centre from the bytes column (bytes allocated)
    #[clap(long = "bytes")]
    bytes: bool,
    /// Source stack cost centre from the ticks column (runtime ticks)
    #[clap(long = "ticks")]
    ticks: bool,

    /// Silence all log output
    #[clap(short = 'q', long = "quiet")]
    quiet: bool,

    /// Verbose logging mode (-v, -vv, -vvv)
    #[clap(short = 'v', long = "verbose", action = ArgAction::Count)]
    verbose: u8,

    // ************ //
    // *** ARGS *** //
    // ************ //
    /// ghc .prof output file, or STDIN if not specified
    #[clap(value_name = "PATH")]
    infile: Option<PathBuf>,
}

impl Opt {
    fn into_parts(self) -> (Option<PathBuf>, Options) {
        let mut options = Options::default();
        options.source = if self.ticks {
            Source::Ticks
        } else if self.bytes {
            Source::Bytes
        } else {
            Source::PercentTime
        };
        (self.infile, options)
    }
}

fn main() -> io::Result<()> {
    let opt = Opt::parse();

    // Initialize logger
    if !opt.quiet {
        env_logger::Builder::from_env(Env::default().default_filter_or(match opt.verbose {
            0 => "warn",
            1 => "info",
            2 => "debug",
            _ => "trace",
        }))
        .format_timestamp(None)
        .init();
    }

    let (infile, options) = opt.into_parts();
    Folder::from(options).collapse_file_to_stdout(infile.as_ref())
}