icydb-cli 0.149.0

Developer CLI tools for IcyDB
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

mod format;
mod parse;

pub(crate) use format::{
    render_executor_residual_suffix, render_perf_suffix, render_pure_covering_suffix,
    render_shell_render_suffix,
};
#[cfg(test)]
pub(crate) use parse::normalize_grouped_next_cursor_json;
pub(crate) use parse::{find_result_payload, parse_perf_result};

///
/// ShellPerfAttribution
///
/// ShellPerfAttribution carries the hard-cut dev-shell perf footer payload.
/// The shell keeps this formatting-only shape local so the canister payload can
/// evolve independently from the rendered footer string.
///

pub(crate) struct ShellPerfAttribution {
    pub(crate) total: u64,
    pub(crate) planner: u64,
    pub(crate) store: u64,
    pub(crate) executor: u64,
    pub(crate) pure_covering_decode: u64,
    pub(crate) pure_covering_row_assembly: u64,
    pub(crate) decode: u64,
    pub(crate) compiler: u64,
}

impl ShellPerfAttribution {
    // Sum the current top-level SQL query perf contract exactly as emitted by
    // query_with_perf: compiler, planner, store, executor, then public decode.
    pub(crate) const fn attributed_total(&self) -> u64 {
        self.compiler
            .saturating_add(self.planner)
            .saturating_add(self.store)
            .saturating_add(self.executor)
            .saturating_add(self.decode)
    }

    // Preserve one visible fallback bucket for legacy or future payloads whose
    // total exceeds the current top-level query perf contract.
    pub(crate) const fn residual_total(&self) -> u64 {
        self.total.saturating_sub(self.attributed_total())
    }

    pub(crate) const fn pure_covering_executor_residual(&self) -> u64 {
        self.executor
            .saturating_sub(self.pure_covering_decode)
            .saturating_sub(self.pure_covering_row_assembly)
    }
}

///
/// ShellLocalRenderAttribution
///
/// ShellLocalRenderAttribution records the CLI-only render time spent turning
/// decoded SQL result payloads into the local table/footer text shown in the
/// shell. This stays separate from the canister-side `c/p/s/e/d` instruction
/// contract because it measures native shell formatting work rather than query
/// engine execution.
///

pub(crate) struct ShellLocalRenderAttribution {
    pub(crate) render_micros: u128,
}