clap-tui 0.1.3

Auto-generate a TUI from clap commands
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

use std::ffi::OsString;

mod command;
mod field_hit;
mod form;
mod global;
mod pointer;
mod sidebar;

use crate::frame_snapshot::FrameSnapshot;
use crate::input::{ActiveTab, AppState, HoverTarget};
use crate::runtime::{AppKeyEvent, AppMouseEvent};

#[derive(Debug, Clone, PartialEq, Eq)]
pub(crate) enum Action {
    Exit,
    Run,
    CopyPreview,
    Escape,
    SearchInput(AppKeyEvent),
    Paste(String),
    ChoiceInput { arg_id: String, key: AppKeyEvent },
    FormTextInput(AppKeyEvent),
    FormWidgetInput(AppKeyEvent),
    ToggleFocus,
    ReverseFocus,
    ToggleHelp,
    FocusSearch,
    MoveSidebarSelection(isize),
    MoveFormSelection(isize),
    SidebarRight,
    CollapseSelected,
    SelectSidebar,
    ActivateFormField,
    UpdateHover { x: u16, y: u16 },
    UpdateMouseSelection(AppMouseEvent),
    ClearMouseSelection,
    CloseDropdown,
    ClickDropdownChoice { arg_id: String, row: u16 },
    ClickFooter(HoverTarget),
    ClickSidebar { x: u16, y: u16 },
    SwitchTab(ActiveTab),
    ClickForm(AppMouseEvent),
    ScrollSidebar(i16),
    ScrollDropdown(i16),
    ScrollForm(i16),
}

#[derive(Debug, Clone, PartialEq, Eq)]
// Reducers return at most one explicit effect for the app loop to interpret.
// This change keeps the current single-effect boundary rather than widening it
// into a broader command or subscription model.
pub(crate) enum Effect {
    None,
    Exit,
    Run(Vec<OsString>),
    CopyToClipboard(String),
}

pub(crate) fn apply_action(
    action: &Action,
    state: &mut AppState,
    frame_snapshot: &FrameSnapshot,
) -> Effect {
    match action {
        Action::Exit | Action::Run | Action::CopyPreview => command::apply(action, state),
        Action::Escape
        | Action::SearchInput(_)
        | Action::Paste(_)
        | Action::ToggleFocus
        | Action::ReverseFocus
        | Action::ToggleHelp
        | Action::FocusSearch
        | Action::CloseDropdown
        | Action::ClickFooter(_)
        | Action::SwitchTab(_) => global::apply(action, state, frame_snapshot),
        Action::MoveSidebarSelection(_)
        | Action::SidebarRight
        | Action::CollapseSelected
        | Action::SelectSidebar
        | Action::ClickSidebar { .. }
        | Action::ScrollSidebar(_) => sidebar::apply(action, state, frame_snapshot),
        Action::ChoiceInput { .. }
        | Action::FormTextInput(_)
        | Action::FormWidgetInput(_)
        | Action::MoveFormSelection(_)
        | Action::ActivateFormField
        | Action::ClickDropdownChoice { .. }
        | Action::ClickForm(_)
        | Action::ScrollDropdown(_)
        | Action::ScrollForm(_) => form::apply(action, state, frame_snapshot),
        Action::UpdateHover { .. }
        | Action::UpdateMouseSelection(_)
        | Action::ClearMouseSelection => pointer::apply(action, state, frame_snapshot),
    }
}