trnovel 0.17.2

Terminal reader for novel
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use super::*;
use ratatui_kit_keymap::crokey::key;

#[test]
fn chapter_search_keys_and_overrides_preserve_case() {
    let mut km = reader_defaults();
    assert_eq!(km.action_for(key!(s)), Some(ReaderAction::SearchContent));
    assert_eq!(km.action_for(key!(n)), Some(ReaderAction::NextSearchMatch));
    assert_eq!(
        km.action_for(key!(shift - n)),
        Some(ReaderAction::PrevSearchMatch)
    );
    assert_eq!(
        km.action_for(key!(esc)),
        Some(ReaderAction::ClearContentSearch)
    );
    assert_eq!(display_first_key(&km, ReaderAction::NextSearchMatch), "n");
    assert_eq!(display_first_key(&km, ReaderAction::PrevSearchMatch), "N");
    let table = ratatui_kit_keymap::toml::from_str(
        "search_content = [\"ctrl-s\"]\nnext_search_match = [\"f3\"]\nprev_search_match = [\"shift-f3\"]\nclear_content_search = [\"ctrl-x\"]"
    ).unwrap();
    assert!(km.merge_toml_table(table).is_empty());
    assert_eq!(km.action_for(key!(s)), None);
    assert_eq!(
        km.action_for(key!(ctrl - s)),
        Some(ReaderAction::SearchContent)
    );
    assert_eq!(km.action_for(key!(f3)), Some(ReaderAction::NextSearchMatch));
    assert_eq!(
        km.action_for(key!(shift - f3)),
        Some(ReaderAction::PrevSearchMatch)
    );
    assert_eq!(
        km.action_for(key!(ctrl - x)),
        Some(ReaderAction::ClearContentSearch)
    );
}

/// 默认表必须能构建(无冲突、键位全部合法)—— build 内有断言,构建成功即验证。
#[test]
fn reader_defaults_build_and_match_legacy_keys() {
    let km = reader_defaults();
    // 逐键抽查与迁移前硬编码一致的代表键。
    assert_eq!(km.action_for(key!(k)), Some(ReaderAction::ScrollUp));
    assert_eq!(km.action_for(key!(down)), Some(ReaderAction::ScrollDown));
    assert_eq!(km.action_for(key!(pagedown)), Some(ReaderAction::PageDown));
    assert_eq!(km.action_for(key!(home)), Some(ReaderAction::GoTop));
    assert_eq!(km.action_for(key!('+')), Some(ReaderAction::VolumeUp));
    assert_eq!(km.action_for(key!('-')), Some(ReaderAction::VolumeDown));
    assert_eq!(km.action_for(key!(tab)), Some(ReaderAction::ToggleReadMode));
    // i/I、t/T 大小写双绑定(I = shift-i)。
    assert_eq!(km.action_for(key!(i)), Some(ReaderAction::ToggleInfo));
    assert_eq!(
        km.action_for(key!(shift - i)),
        Some(ReaderAction::ToggleInfo)
    );
    assert_eq!(
        km.action_for(key!(shift - t)),
        Some(ReaderAction::ToggleTts)
    );
    assert_eq!(
        km.action_for(key!(o)),
        Some(ReaderAction::ToggleReaderSettings)
    );
    // 整页翻页的 Vim 绑定与物理键并存。
    assert_eq!(km.action_for(key!(ctrl - f)), Some(ReaderAction::PageDown));
    assert_eq!(km.action_for(key!(ctrl - b)), Some(ReaderAction::PageUp));
}

/// 用户覆盖经 [reader] 表合并后生效,未覆盖的 action 不受影响。
#[test]
fn reader_override_merges() {
    let mut km = reader_defaults();
    let table: ratatui_kit_keymap::toml::Table =
        ratatui_kit_keymap::toml::from_str("page_down = [\"ctrl-d\"]").unwrap();
    let warnings = km.merge_toml_table(table);
    assert!(warnings.is_empty());
    assert_eq!(km.action_for(key!(ctrl - d)), Some(ReaderAction::PageDown));
    // 覆盖是整体替换:该 action 的全部默认键(含 ctrl-f)一并失效。
    assert_eq!(km.action_for(key!(pagedown)), None);
    assert_eq!(km.action_for(key!(ctrl - f)), None);
    assert_eq!(km.action_for(key!(k)), Some(ReaderAction::ScrollUp));
}

/// 显示层沿用「↑ / K」视觉习惯:方向键箭头、单字符大写、覆盖后显示新键。
#[test]
fn display_keys_follow_project_style() {
    let mut km = reader_defaults();
    assert_eq!(display_keys(&km, ReaderAction::ScrollUp), "↑ / K");
    assert_eq!(display_keys(&km, ReaderAction::VolumeDown), "-");
    // t 与 shift-t 双绑定折叠为单个「T」(同迁移前帮助显示)。
    assert_eq!(display_keys(&km, ReaderAction::ToggleTts), "T");
    let table: ratatui_kit_keymap::toml::Table =
        ratatui_kit_keymap::toml::from_str("page_down = [\"ctrl-d\"]").unwrap();
    km.merge_toml_table(table);
    assert_eq!(display_keys(&km, ReaderAction::PageDown), "Ctrl-d");
}

/// 告警渲染为中文且逐条对应。
#[test]
fn warnings_render_in_chinese() {
    let mut km = reader_defaults();
    let table: ratatui_kit_keymap::toml::Table =
        ratatui_kit_keymap::toml::from_str("page_down = \"ctrl-\"\ntypo = \"x\"\ntoggle_play = 3")
            .unwrap();
    let messages: Vec<String> = km
        .merge_toml_table(table)
        .iter()
        .map(render_warning)
        .collect();
    assert_eq!(messages.len(), 3);
    assert!(messages.iter().any(|m| m.contains("无法解析")));
    assert!(messages.iter().any(|m| m.contains("未知操作")));
    assert!(messages.iter().any(|m| m.contains("值类型不对")));
    // 全部回退/忽略后默认键完好。
    assert_eq!(km.action_for(key!(pagedown)), Some(ReaderAction::PageDown));
}