neser 1.1.0

NESER - Nintendo Emulation Systems Engine (Rust). Desktop and WebAssembly frontends.
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

//! System-agnostic toast message formatters for frontend events.
//!
//! These generate human-readable strings for transient on-screen messages
//! (gamepad connection, ROM loading, etc.) that are the same regardless of
//! which emulated system is running.

pub fn gamepad_connected_toast_message(player_num: u8) -> String {
    format!("Gamepad connected: Player {player_num}")
}

pub fn gamepad_disconnected_toast_message(player_num: u8) -> String {
    format!("Gamepad disconnected: was Player {player_num}")
}

pub fn gamepad_init_toast_message(gamepads_enabled: bool, detected_controllers: usize) -> String {
    if !gamepads_enabled {
        return "Gamepads disabled: using keyboard controls".to_string();
    }

    match detected_controllers {
        0 => "No gamepads found: using keyboard controls".to_string(),
        1 => "Gamepad found: using 1 gamepad".to_string(),
        count => format!("Gamepads found: using {} gamepads", count),
    }
}

pub fn cartridge_load_toast_message(rom_path: &str, success: bool) -> String {
    if success {
        return format!("Cartridge loaded: {}", rom_path);
    }
    format!("Cartridge load failed: {}", rom_path)
}

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

    #[test]
    fn gamepad_init_toast_when_gamepads_disabled_uses_keyboard_message() {
        let message = gamepad_init_toast_message(false, 0);
        assert_eq!(message, "Gamepads disabled: using keyboard controls");
    }

    #[test]
    fn gamepad_init_toast_when_enabled_and_none_found_uses_fallback_message() {
        let message = gamepad_init_toast_message(true, 0);
        assert_eq!(message, "No gamepads found: using keyboard controls");
    }

    #[test]
    fn gamepad_init_toast_when_one_found_reports_single_gamepad() {
        let message = gamepad_init_toast_message(true, 1);
        assert_eq!(message, "Gamepad found: using 1 gamepad");
    }

    #[test]
    fn gamepad_init_toast_reports_three_gamepads_in_four_score() {
        let message = gamepad_init_toast_message(true, 3);
        assert_eq!(message, "Gamepads found: using 3 gamepads");
    }

    #[test]
    fn cartridge_load_success_toast_includes_rom_path() {
        let message = cartridge_load_toast_message("roms/games/mario.nes", true);
        assert_eq!(message, "Cartridge loaded: roms/games/mario.nes");
    }

    #[test]
    fn cartridge_load_failure_toast_includes_rom_path() {
        let message = cartridge_load_toast_message("roms/games/mario.nes", false);
        assert_eq!(message, "Cartridge load failed: roms/games/mario.nes");
    }

    #[test]
    fn gamepad_connected_toast_player_1() {
        let message = gamepad_connected_toast_message(1);
        assert_eq!(message, "Gamepad connected: Player 1");
    }

    #[test]
    fn gamepad_connected_toast_player_2() {
        let message = gamepad_connected_toast_message(2);
        assert_eq!(message, "Gamepad connected: Player 2");
    }

    #[test]
    fn gamepad_disconnected_toast_player_1() {
        let message = gamepad_disconnected_toast_message(1);
        assert_eq!(message, "Gamepad disconnected: was Player 1");
    }

    #[test]
    fn gamepad_disconnected_toast_player_2() {
        let message = gamepad_disconnected_toast_message(2);
        assert_eq!(message, "Gamepad disconnected: was Player 2");
    }
}