xct2cli 0.1.0

Library and CLI for transforming Xcode Instruments .trace bundles (hotspots, callgraphs, annotated disassembly, PMI counters, heap allocations). Apple Silicon.
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

//! Heat palette + color-mode resolution. Helpers return an empty
//! `Style` when `colored = false`, so call sites can use them
//! unconditionally.

use std::io::IsTerminal;

use owo_colors::Style;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum ColorMode {
    #[default]
    Auto,
    Always,
    Never,
}

impl ColorMode {
    /// Honors `NO_COLOR` and stdout's `IsTerminal`.
    pub fn resolve(self) -> bool {
        match self {
            Self::Always => true,
            Self::Never => false,
            Self::Auto => {
                if std::env::var_os("NO_COLOR").is_some() {
                    return false;
                }
                std::io::stdout().is_terminal()
            }
        }
    }
}

#[derive(Debug, Clone, Copy)]
pub struct Palette {
    pub colored: bool,
}

impl Palette {
    pub fn new(colored: bool) -> Self {
        Self { colored }
    }

    /// Heat ramp for `intensity` in `[0.0, 1.0]`. Higher is hotter.
    pub fn heat(self, intensity: f64) -> Style {
        if !self.colored {
            return Style::new();
        }
        if intensity >= 0.6 {
            Style::new().red().bold()
        } else if intensity >= 0.3 {
            Style::new().bright_red()
        } else if intensity >= 0.1 {
            Style::new().yellow()
        } else if intensity > 0.0 {
            Style::new()
        } else {
            Style::new().bright_black()
        }
    }

    pub fn dim(self) -> Style {
        if !self.colored {
            return Style::new();
        }
        Style::new().bright_black()
    }

    pub fn bold(self) -> Style {
        if !self.colored {
            return Style::new();
        }
        Style::new().bold()
    }

    pub fn function(self) -> Style {
        if !self.colored {
            return Style::new();
        }
        Style::new().cyan()
    }

    pub fn path(self) -> Style {
        if !self.colored {
            return Style::new();
        }
        Style::new().bright_black()
    }

    pub fn header(self) -> Style {
        if !self.colored {
            return Style::new();
        }
        Style::new().bold().underline()
    }

    /// Stable color per hot-line index so the same line gets the same
    /// color in the asm overlay and the source snippet. Skips red (heat
    /// owns it) and grey (dim/path owns it). Truecolor; owo-colors
    /// falls back to nearest 256-color when needed.
    pub fn line_marker(self, index: usize) -> Style {
        if !self.colored {
            return Style::new();
        }
        const PALETTE: &[(u8, u8, u8)] = &[
            (0x4d, 0xb8, 0xff),
            (0xff, 0x6b, 0x9d),
            (0xa3, 0xe6, 0x35),
            (0xff, 0xa6, 0x4d),
            (0xc2, 0x9b, 0xff),
            (0x6b, 0xff, 0xea),
            (0xff, 0xd7, 0x00),
            (0x4d, 0xe6, 0xa6),
            (0xe6, 0x5b, 0xb7),
            (0x6b, 0x5b, 0xe6),
        ];
        let (r, g, b) = PALETTE[index % PALETTE.len()];
        Style::new().truecolor(r, g, b).bold()
    }
}