bubbles-dialogue 0.8.0

Lightweight engine-agnostic dialogue runtime for Rust games.
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

use super::{BestLeastRecentlyViewed, Candidate, FirstAvailable, SaliencyStrategy};

#[cfg(feature = "rand")]
use super::RandomAvailable;

fn cand(ids: &[&'static str]) -> Vec<Candidate<'static>> {
    ids.iter()
        .map(|&id| Candidate {
            id,
            available: true,
        })
        .collect()
}

fn cand_mask(ids: &[&'static str], mask: &[bool]) -> Vec<Candidate<'static>> {
    ids.iter()
        .zip(mask.iter())
        .map(|(&id, &available)| Candidate { id, available })
        .collect()
}

// ── FirstAvailable ───────────────────────────────────────────────────────

#[test]
fn first_available_picks_first() {
    let mut s = FirstAvailable;
    let cs = cand_mask(&["a", "b", "c"], &[false, true, true]);
    assert_eq!(s.select(&cs), Some(1));
}

#[test]
fn first_available_none_when_all_unavailable() {
    let mut s = FirstAvailable;
    let cs = cand_mask(&["a", "b"], &[false, false]);
    assert_eq!(s.select(&cs), None);
}

#[test]
fn first_available_empty() {
    let mut s = FirstAvailable;
    assert_eq!(s.select(&[]), None);
}

// ── RandomAvailable ──────────────────────────────────────────────────────

#[cfg(feature = "rand")]
#[test]
fn random_available_returns_valid_index() {
    let mut s = RandomAvailable;
    let cs = cand_mask(&["a", "b", "c"], &[true, false, true]);
    let idx = s.select(&cs);
    assert!(idx == Some(0) || idx == Some(2));
}

#[cfg(feature = "rand")]
#[test]
fn random_available_none_when_empty() {
    let mut s = RandomAvailable;
    assert_eq!(s.select(&[]), None);
}

// ── BestLeastRecentlyViewed ───────────────────────────────────────────────

#[test]
fn blrv_cycles_through_all_candidates() {
    let mut s = BestLeastRecentlyViewed::new();
    let cs = cand(&["a", "b", "c"]);
    assert_eq!(s.select(&cs), Some(0)); // a - unseen
    assert_eq!(s.select(&cs), Some(1)); // b - unseen
    assert_eq!(s.select(&cs), Some(2)); // c - unseen
    assert_eq!(s.select(&cs), Some(0)); // a - oldest seen
}

#[test]
fn blrv_skips_unavailable() {
    let mut s = BestLeastRecentlyViewed::new();
    let cs = cand_mask(&["a", "b", "c"], &[false, true, true]);
    assert_eq!(s.select(&cs), Some(1)); // b - first available
    assert_eq!(s.select(&cs), Some(2)); // c - next unseen
}

#[test]
fn blrv_none_when_all_unavailable() {
    let mut s = BestLeastRecentlyViewed::new();
    let cs = cand_mask(&["a", "b"], &[false, false]);
    assert_eq!(s.select(&cs), None);
}

#[test]
fn blrv_single_candidate_always_picks_it() {
    let mut s = BestLeastRecentlyViewed::new();
    let cs = cand(&["only"]);
    assert_eq!(s.select(&cs), Some(0));
    assert_eq!(s.select(&cs), Some(0));
}