tere 1.5.2

Terminal file explorer
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

use std::cmp::{PartialEq, Eq};
use std::hash::Hash;
use strum_macros::{
    Display as StrumDisplay,
    EnumString,
    EnumIter,
};

/// The possible actions that the user can do


#[derive(Debug, PartialEq, Eq, Clone, StrumDisplay, EnumString, EnumIter)]
pub enum Action {
    ChangeDir,
    ChangeDirParent,
    ChangeDirHome,
    ChangeDirRoot,
    ChangeDirAndExit,

    CursorUp,
    CursorDown,
    CursorUpScreen,
    CursorDownScreen,
    CursorTop,
    CursorBottom,

    EraseSearchChar,
    ClearSearch,

    ChangeFilterSearchMode,
    ChangeCaseSensitiveMode,
    ChangeGapSearchMode,
    ChangeSortMode,

    RefreshListing,

    Help,

    Exit,
    ExitWithoutCd,

    None,
}

impl Action {
    pub fn description(&self) -> &'static str {
        match self {
            Self::ChangeDir => "Enter directory under the cursor",
            Self::ChangeDirParent => "Go to the parent directory",
            Self::ChangeDirHome => "Go to the home directory",
            Self::ChangeDirRoot => "Go to the root directory",
            Self::ChangeDirAndExit => "Enter the directory under the cursor and exit",

            Self::CursorUp => "Move the cursor up by one step",
            Self::CursorDown => "Move the cursor down by one step",
            Self::CursorUpScreen => "Move the cursor up by one screenful",
            Self::CursorDownScreen => "Move the cursor down by one screenful",
            Self::CursorTop => "Move the cursor to the first item in the listing",
            Self::CursorBottom => "Move the cursor to the last item in the listing",

            Self::EraseSearchChar => "Erase one character from the search",
            Self::ClearSearch => "Clear the search",

            Self::ChangeFilterSearchMode => "Toggle the filter-search mode",
            Self::ChangeCaseSensitiveMode => "Change the case-sensitive mode",
            Self::ChangeGapSearchMode => "Change the gap-search mode",
            Self::ChangeSortMode => "Change the sorting mode",

            Self::RefreshListing => "Refresh the directory listing",

            Self::Help => "Show the help screen",

            Self::Exit => "Exit the program",
            Self::ExitWithoutCd => "Exit the program without changing the working directory",

            Self::None => "Disable this mapping",
        }
    }
}

/// An extra quantifier on an action, like 'this only applies when searching'
#[derive(Hash, PartialEq, Eq, Clone, Debug, StrumDisplay, EnumString, EnumIter)]
pub enum ActionContext {
    /// Signifies that this shortcut should apply if no other condition applies
    None,

    /// This shortcut only applies when searching
    Searching,

    /// This shortcut only applies when not searching
    NotSearching,
}

impl ActionContext {
    /// Description of this context to use in the output of --help
    pub fn description(&self) -> &'static str {
        match self {
            Self::None => "This mapping applies if no other context applies. This is the behavior if no context is specified: the mapping 'key-combination:action' is equivalent to 'key-combination:None:action'.",
            Self::Searching => "This mapping only applies while searching (at least one search character has been given).",
            Self::NotSearching => "This mapping only applies while not searching.",
        }
    }

    /// Half-way between the serialization provided by strum::Display and self.description(): a
    /// short human-readable string.
    pub fn short_description(&self) -> &'static str {
        match self {
            Self::None => "no context",
            Self::Searching => "when searching",
            Self::NotSearching => "when not searching",
        }
    }
}