alix 0.5.0

A learning tool built for understanding, not just remembering.
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

//! Guards that the example decks committed in the repo still pass `alix deck check`.
//!
//! These decks are referenced from the README and the book and are meant to be
//! runnable, so a change that breaks them should fail CI rather than rot
//! silently. Pre-1.0 the deck format is unstable, and this is the tripwire for a
//! format/parse regression reaching a shipped example.
//!
//! Scope note: `alix deck check` validates syntax, duplicate answers, and that each
//! trace `% at:` locator *resolves* (the file exists and the line range is in
//! bounds). It does NOT verify the cited lines still show the code the checkpoint
//! describes, so this test cannot catch *semantic* drift of a live-source trace —
//! only format breakage and locators that fall out of the file entirely.

use std::{path::Path, process::Command};

#[test]
fn rust_ownership_example_still_checks() {
    let deck = Path::new(env!("CARGO_MANIFEST_DIR"))
        .join("docs/examples/rust-ownership/ownership-move.txt");
    let status = Command::new(env!("CARGO_BIN_EXE_alix"))
        .args(["doctor"])
        .arg(&deck)
        .status()
        .expect("failed to run the alix binary");
    assert!(
        status.success(),
        "alix deck check failed on {} — the shipped example deck no longer validates",
        deck.display()
    );
}