Trait broot::app::PanelState

pub trait PanelState {
    // Required methods
    fn get_type(&self) -> PanelStateType;
    fn set_mode(&mut self, mode: Mode);
    fn get_mode(&self) -> Mode;
    fn on_internal(
        &mut self,
        w: &mut W,
        internal_exec: &InternalExecution,
        input_invocation: Option<&VerbInvocation>,
        trigger_type: TriggerType<'_>,
        app_state: &mut AppState,
        cc: &CmdContext<'_>
    ) -> Result<CmdResult, ProgramError>;
    fn selected_path(&self) -> Option<&Path>;
    fn selection(&self) -> Option<Selection<'_>>;
    fn refresh(&mut self, screen: Screen, con: &AppContext) -> Command;
    fn tree_options(&self) -> TreeOptions;
    fn with_new_options(
        &mut self,
        screen: Screen,
        change_options: &dyn Fn(&mut TreeOptions) -> &'static str,
        in_new_panel: bool,
        con: &AppContext
    ) -> CmdResult;
    fn display(
        &mut self,
        w: &mut W,
        disc: &DisplayContext<'_>
    ) -> Result<(), ProgramError>;

    // Provided methods
    fn clear_pending(&mut self) { ... }
    fn on_click(
        &mut self,
        _x: u16,
        _y: u16,
        _screen: Screen,
        _con: &AppContext
    ) -> Result<CmdResult, ProgramError> { ... }
    fn on_double_click(
        &mut self,
        _x: u16,
        _y: u16,
        _screen: Screen,
        _con: &AppContext
    ) -> Result<CmdResult, ProgramError> { ... }
    fn on_pattern(
        &mut self,
        _pat: InputPattern,
        _app_state: &AppState,
        _con: &AppContext
    ) -> Result<CmdResult, ProgramError> { ... }
    fn on_mode_verb(&mut self, mode: Mode, con: &AppContext) -> CmdResult { ... }
    fn on_internal_generic(
        &mut self,
        _w: &mut W,
        internal_exec: &InternalExecution,
        input_invocation: Option<&VerbInvocation>,
        _trigger_type: TriggerType<'_>,
        app_state: &mut AppState,
        cc: &CmdContext<'_>
    ) -> Result<CmdResult, ProgramError> { ... }
    fn stage(
        &self,
        app_state: &mut AppState,
        cc: &CmdContext<'_>,
        con: &AppContext
    ) -> CmdResult { ... }
    fn unstage(
        &self,
        app_state: &mut AppState,
        cc: &CmdContext<'_>,
        _con: &AppContext
    ) -> CmdResult { ... }
    fn toggle_stage(
        &self,
        app_state: &mut AppState,
        cc: &CmdContext<'_>,
        con: &AppContext
    ) -> CmdResult { ... }
    fn execute_verb(
        &mut self,
        w: &mut W,
        verb: &Verb,
        invocation: Option<&VerbInvocation>,
        trigger_type: TriggerType<'_>,
        app_state: &mut AppState,
        cc: &CmdContext<'_>
    ) -> Result<CmdResult, ProgramError> { ... }
    fn execute_external(
        &mut self,
        w: &mut W,
        verb: &Verb,
        external_execution: &ExternalExecution,
        invocation: Option<&VerbInvocation>,
        app_state: &mut AppState,
        cc: &CmdContext<'_>
    ) -> Result<CmdResult, ProgramError> { ... }
    fn execute_sequence(
        &mut self,
        _w: &mut W,
        verb: &Verb,
        seq_ex: &SequenceExecution,
        invocation: Option<&VerbInvocation>,
        app_state: &mut AppState,
        _cc: &CmdContext<'_>
    ) -> Result<CmdResult, ProgramError> { ... }
    fn on_command(
        &mut self,
        w: &mut W,
        app_state: &mut AppState,
        cc: &CmdContext<'_>
    ) -> Result<CmdResult, ProgramError> { ... }
    fn open_preview(
        &mut self,
        prefered_mode: Option<PreviewMode>,
        close_if_open: bool,
        cc: &CmdContext<'_>
    ) -> CmdResult { ... }
    fn tree_root(&self) -> Option<&Path> { ... }
    fn sel_info<'c>(&'c self, _app_state: &'c AppState) -> SelInfo<'c> { ... }
    fn has_at_least_one_selection(&self, _app_state: &AppState) -> bool { ... }
    fn do_pending_task(
        &mut self,
        _app_state: &mut AppState,
        _screen: Screen,
        _con: &AppContext,
        _dam: &mut Dam
    ) -> Result<(), ProgramError> { ... }
    fn get_pending_task(&self) -> Option<&'static str> { ... }
    fn get_flags(&self) -> Vec<Flag>  { ... }
    fn get_starting_input(&self) -> String { ... }
    fn set_selected_path(&mut self, _path: PathBuf, _con: &AppContext) { ... }
    fn no_verb_status(
        &self,
        _has_previous_state: bool,
        _con: &AppContext
    ) -> Status { ... }
    fn get_status(
        &self,
        app_state: &AppState,
        cc: &CmdContext<'_>,
        has_previous_state: bool
    ) -> Status { ... }
    fn get_verb_status(
        &self,
        verb: &Verb,
        invocation: &VerbInvocation,
        sel_info: SelInfo<'_>,
        _cc: &CmdContext<'_>,
        app_state: &AppState
    ) -> Status { ... }
}

a panel state, stackable to allow reverting to a previous one

Required Methods

fn get_type(&self) -> PanelStateType

fn set_mode(&mut self, mode: Mode)

fn get_mode(&self) -> Mode

fn on_internal(
&mut self,
w: &mut W,
internal_exec: &InternalExecution,
input_invocation: Option<&VerbInvocation>,
trigger_type: TriggerType<'_>,
app_state: &mut AppState,
cc: &CmdContext<'_>
) -> Result<CmdResult, ProgramError>

execute the internal with the optional given invocation.

The invocation comes from the input and may be related to a different verb (the verb may have been triggered by a key shortcut)

fn selected_path(&self) -> Option<&Path>

fn selection(&self) -> Option<Selection<'_>>

fn refresh(&mut self, screen: Screen, con: &AppContext) -> Command

fn tree_options(&self) -> TreeOptions

fn with_new_options(
&mut self,
screen: Screen,
change_options: &dyn Fn(&mut TreeOptions) -> &'static str,
in_new_panel: bool,
con: &AppContext
) -> CmdResult

Build a cmdResult in response to a command being a change of tree options. This may or not be a new state.

The provided change_options function returns a status message explaining the change

fn display(
&mut self,
w: &mut W,
disc: &DisplayContext<'_>
) -> Result<(), ProgramError>

Provided Methods

fn clear_pending(&mut self)

called on start of on_command

fn on_click(
&mut self,
_x: u16,
_y: u16,
_screen: Screen,
_con: &AppContext
) -> Result<CmdResult, ProgramError>

fn on_double_click(
&mut self,
_x: u16,
_y: u16,
_screen: Screen,
_con: &AppContext
) -> Result<CmdResult, ProgramError>

fn on_pattern(
&mut self,
_pat: InputPattern,
_app_state: &AppState,
_con: &AppContext
) -> Result<CmdResult, ProgramError>

fn on_mode_verb(&mut self, mode: Mode, con: &AppContext) -> CmdResult

fn on_internal_generic(
&mut self,
_w: &mut W,
internal_exec: &InternalExecution,
input_invocation: Option<&VerbInvocation>,
_trigger_type: TriggerType<'_>,
app_state: &mut AppState,
cc: &CmdContext<'_>
) -> Result<CmdResult, ProgramError>

a generic implementation of on_internal which may be called by states when they don’t have a specific behavior to execute

fn stage(
&self,
app_state: &mut AppState,
cc: &CmdContext<'_>,
con: &AppContext
) -> CmdResult

fn unstage(
&self,
app_state: &mut AppState,
cc: &CmdContext<'_>,
_con: &AppContext
) -> CmdResult

fn toggle_stage(
&self,
app_state: &mut AppState,
cc: &CmdContext<'_>,
con: &AppContext
) -> CmdResult

fn execute_verb(
&mut self,
w: &mut W,
verb: &Verb,
invocation: Option<&VerbInvocation>,
trigger_type: TriggerType<'_>,
app_state: &mut AppState,
cc: &CmdContext<'_>
) -> Result<CmdResult, ProgramError>

fn execute_external(
&mut self,
w: &mut W,
verb: &Verb,
external_execution: &ExternalExecution,
invocation: Option<&VerbInvocation>,
app_state: &mut AppState,
cc: &CmdContext<'_>
) -> Result<CmdResult, ProgramError>

fn execute_sequence(
&mut self,
_w: &mut W,
verb: &Verb,
seq_ex: &SequenceExecution,
invocation: Option<&VerbInvocation>,
app_state: &mut AppState,
_cc: &CmdContext<'_>
) -> Result<CmdResult, ProgramError>

fn on_command(
&mut self,
w: &mut W,
app_state: &mut AppState,
cc: &CmdContext<'_>
) -> Result<CmdResult, ProgramError>

change the state, does no rendering

fn open_preview(
&mut self,
prefered_mode: Option<PreviewMode>,
close_if_open: bool,
cc: &CmdContext<'_>
) -> CmdResult

return a cmdresult asking for the opening of a preview

fn tree_root(&self) -> Option<&Path>

must return None if the state doesn’t display a file tree

fn sel_info<'c>(&'c self, _app_state: &'c AppState) -> SelInfo<'c>

fn has_at_least_one_selection(&self, _app_state: &AppState) -> bool

fn do_pending_task(
&mut self,
_app_state: &mut AppState,
_screen: Screen,
_con: &AppContext,
_dam: &mut Dam
) -> Result<(), ProgramError>

fn get_pending_task(&self) -> Option<&'static str>

fn get_flags(&self) -> Vec<Flag>

return the flags to display

fn get_starting_input(&self) -> String

fn set_selected_path(&mut self, _path: PathBuf, _con: &AppContext)

fn no_verb_status(&self, _has_previous_state: bool, _con: &AppContext) -> Status

return the status which should be used when there’s no verb edited

fn get_status(
&self,
app_state: &AppState,
cc: &CmdContext<'_>,
has_previous_state: bool
) -> Status

fn get_verb_status(
&self,
verb: &Verb,
invocation: &VerbInvocation,
sel_info: SelInfo<'_>,
_cc: &CmdContext<'_>,
app_state: &AppState
) -> Status

Implementors

impl PanelState for BrowserState

impl PanelState for FilesystemState

impl PanelState for HelpState

impl PanelState for PreviewState

impl PanelState for StageState