ass-core 0.1.2

High-performance ASS subtitle format parser and analyzer
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

//! Performance analysis against absolute targets and baseline comparisons.
//!
//! Compares loaded benchmark timings against fixed performance targets and
//! classifies criterion change estimates into regressions, improvements, or
//! results that stay within the acceptable threshold.

#[cfg(not(feature = "std"))]
use alloc::format;
use std::collections::HashMap;

use crate::types::{BenchmarkResult, RegressionAnalysis};

/// Performance regression threshold percentage
const REGRESSION_THRESHOLD_PERCENT: f64 = 10.0;
/// Incremental parsing target in milliseconds
const INCREMENTAL_PARSING_TARGET_MS: f64 = 5.0;

/// Analyze performance against absolute targets
pub fn analyze_performance_targets(
    results: &HashMap<String, BenchmarkResult>,
    analysis: &mut RegressionAnalysis,
) {
    for (name, result) in results {
        let time_ms = result.time_ms();

        // Check incremental parsing targets
        if name.contains("incremental") {
            if time_ms > INCREMENTAL_PARSING_TARGET_MS {
                analysis.target_violations.push(format!(
                    "❌ {name}: {time_ms:.2}ms > {INCREMENTAL_PARSING_TARGET_MS}ms target"
                ));
            } else {
                analysis.within_threshold.push(format!(
                    "✅ {name}: {time_ms:.2}ms ≤ {INCREMENTAL_PARSING_TARGET_MS}ms target"
                ));
            }
        }
    }
}

/// Analyze performance regressions against baseline
pub fn analyze_regressions(comparisons: &HashMap<String, f64>, analysis: &mut RegressionAnalysis) {
    for (name, change_percent) in comparisons {
        let abs_change = change_percent.abs();

        if abs_change > REGRESSION_THRESHOLD_PERCENT {
            if *change_percent > 0.0 {
                // Performance got worse
                analysis.regressions.push(format!(
                    "📉 {name}: {change_percent:.1}% slower (>{REGRESSION_THRESHOLD_PERCENT}% threshold)"
                ));
            } else {
                // Performance improved significantly
                analysis
                    .improvements
                    .push(format!("📈 {name}: {abs_change:.1}% faster"));
            }
        } else {
            analysis.within_threshold.push(format!(
                "✅ {name}: {change_percent:.1}% change (within {REGRESSION_THRESHOLD_PERCENT}% threshold)"
            ));
        }
    }
}