cfspeedtest 2.0.2

Unofficial CLI for speed.cloudflare.com
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

use log;
use std::fmt::Write;

const PLOT_WIDTH: usize = 80;

fn generate_axis_labels(minima: f64, maxima: f64) -> String {
    let mut labels = String::new();
    write!(labels, "{minima:<10.2}").unwrap();
    write!(
        labels,
        "{:^width$.2}",
        (minima + maxima) / 2.0,
        width = PLOT_WIDTH - 20
    )
    .unwrap();
    write!(labels, "{maxima:>10.2}").unwrap();
    labels
}

pub(crate) fn render_plot(minima: f64, q1: f64, median: f64, q3: f64, maxima: f64) -> String {
    let value_range = maxima - minima;
    let quartile_0 = q1 - minima;
    let quartile_1 = median - q1;
    let quartile_2 = q3 - median;
    let quartile_3 = maxima - q3;

    let scale_factor = PLOT_WIDTH as f64 / value_range;

    let mut plot = String::with_capacity(PLOT_WIDTH);
    plot.push('|');
    plot.push_str("-".repeat((quartile_0 * scale_factor) as usize).as_str());
    plot.push_str("=".repeat((quartile_1 * scale_factor) as usize).as_str());
    plot.push(':');
    plot.push_str("=".repeat((quartile_2 * scale_factor) as usize).as_str());
    plot.push_str("-".repeat((quartile_3 * scale_factor) as usize).as_str());
    plot.push('|');

    let axis_labels = generate_axis_labels(minima, maxima);
    plot.push('\n');
    plot.push_str(&axis_labels);

    log::debug!("fn input: {minima}, {q1}, {median}, {q3}, {maxima}");
    log::debug!("quartiles: {quartile_0}, {quartile_1}, {quartile_2}, {quartile_3}");
    log::debug!("value range: {value_range}");
    log::debug!("len of the plot: {}", plot.len());

    plot
}

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

    #[test]
    fn test_generate_axis_labels() {
        let labels = generate_axis_labels(0.0, 100.0);
        assert!(labels.starts_with("0.00"));
        assert!(labels.ends_with("100.00"));
        assert!(labels.contains("50.00"));
        assert_eq!(labels.len(), PLOT_WIDTH);
    }

    #[test]
    fn test_generate_axis_labels_negative() {
        let labels = generate_axis_labels(-50.0, 50.0);
        assert!(labels.starts_with("-50.00"));
        assert!(labels.ends_with("50.00"));
        assert!(labels.contains("0.00"));
    }

    #[test]
    fn test_render_plot_basic() {
        let plot = render_plot(0.0, 25.0, 50.0, 75.0, 100.0);

        // Should contain boxplot characters
        assert!(plot.contains('|'));
        assert!(plot.contains('-'));
        assert!(plot.contains('='));
        assert!(plot.contains(':'));

        // Should contain axis labels
        assert!(plot.contains("0.00"));
        assert!(plot.contains("100.00"));
        assert!(plot.contains("50.00"));

        // Should have newline separating plot from labels
        assert!(plot.contains('\n'));
    }

    #[test]
    fn test_render_plot_same_values() {
        let plot = render_plot(50.0, 50.0, 50.0, 50.0, 50.0);

        // When all values are the same, should still render
        assert!(plot.contains('|'));
        assert!(plot.contains(':'));
        assert!(plot.contains("50.00"));
    }

    #[test]
    fn test_render_plot_structure() {
        let plot = render_plot(10.0, 30.0, 50.0, 70.0, 90.0);
        let lines: Vec<&str> = plot.split('\n').collect();

        // Should have exactly 2 lines: plot and axis labels
        assert_eq!(lines.len(), 2);

        // First line should be the boxplot
        assert!(lines[0].starts_with('|'));
        assert!(lines[0].ends_with('|'));

        // Second line should be the axis labels
        assert!(lines[1].contains("10.00"));
        assert!(lines[1].contains("90.00"));
    }

    #[test]
    fn test_render_plot_quartile_ordering() {
        let plot = render_plot(0.0, 20.0, 50.0, 80.0, 100.0);

        // Find the positions of key characters
        let colon_pos = plot.find(':').unwrap();
        let first_pipe = plot.find('|').unwrap();
        let last_pipe = plot.rfind('|').unwrap();

        // Colon (median) should be between the pipes
        assert!(colon_pos > first_pipe);
        assert!(colon_pos < last_pipe);
    }
}