open-eeg-codec-standard 0.9.0

OpenECS — a universal, vendor-neutral Open EEG Codec Standard: grade any EEG codec (any language, via a file-based contract) against a hash-pinned corpus into one comparable verdict.
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

//! Integration test driving the real `openecs` binary end to end.

use std::path::PathBuf;
use std::process::Command;

/// Path to the compiled binary (cargo sets this for integration tests).
fn bin() -> &'static str {
    env!("CARGO_BIN_EXE_openecs")
}

fn smoke_manifest() -> PathBuf {
    PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("corpora/ecs-smoke.toml")
}

#[test]
fn help_lists_subcommands() {
    let out = Command::new(bin()).arg("--help").output().expect("run --help");
    assert!(out.status.success());
    let text = String::from_utf8_lossy(&out.stdout);
    for sub in ["grade", "bench", "verify-corpus", "emit-corpus-manifest"] {
        assert!(text.contains(sub), "--help should list `{sub}`");
    }
}

#[test]
fn legacy_form_still_works() {
    // `openecs gzip` (no subcommand) grades the synthetic fixture -> L -> exit 0.
    let out = Command::new(bin()).arg("gzip").output().expect("run legacy");
    assert!(out.status.success(), "legacy gzip should exit 0");
    let text = String::from_utf8_lossy(&out.stdout);
    assert!(text.contains("ECS-L"), "legacy output shows the grade");
}

#[test]
fn bench_ranks_codecs_and_writes_report() {
    let report = std::env::temp_dir().join(format!("lqs_bench_{}.html", std::process::id()));
    let out = Command::new(bin())
        .args(["bench", "--codec", "gzip", "--baselines", "store"])
        .arg("--corpus-manifest")
        .arg(smoke_manifest())
        .arg("--report")
        .arg(&report)
        .output()
        .expect("run bench");
    assert!(out.status.success(), "bench of gzip over smoke corpus exits 0");
    let text = String::from_utf8_lossy(&out.stdout);
    assert!(text.contains("rank"), "ranked table present");
    assert!(text.contains("gzip") && text.contains("store"), "both codecs listed");
    assert!(text.contains("mean R"), "CI column present");

    // The HTML report is a self-contained page with embedded SVG charts.
    let html = std::fs::read_to_string(&report).expect("report written");
    assert!(html.starts_with("<!doctype html>"));
    assert!(html.contains("<svg"), "report embeds SVG charts");
    let _ = std::fs::remove_file(&report);
}

#[test]
fn verify_corpus_passes_on_smoke() {
    let out = Command::new(bin())
        .arg("verify-corpus")
        .arg("--corpus-manifest")
        .arg(smoke_manifest())
        .output()
        .expect("run verify-corpus");
    assert!(out.status.success(), "smoke corpus verifies");
    assert!(String::from_utf8_lossy(&out.stdout).contains("all 3 files verified"));
}

#[test]
fn quantize_grades_near_lossless() {
    // `quantize` (÷8) over the smoke corpus has PRD ~3% — inside the
    // Near-Lossless tier (PRD ≤ 5, R ≥ 0.99), whose low CR floor (1.0)
    // rewards small distortion even without high compression. Passes -> exit 0.
    let out = Command::new(bin())
        .args(["grade", "--codec", "quantize"])
        .arg("--corpus-manifest")
        .arg(smoke_manifest())
        .output()
        .expect("run grade quantize");
    assert!(out.status.success(), "near-lossless codec passes -> exit 0");
    assert!(
        String::from_utf8_lossy(&out.stdout).contains("ECS-N"),
        "quantize grades the Near-Lossless tier"
    );
}