Struct FileBrowser 

pub struct FileBrowser {
    pub current_path: PathBuf,
    pub entries: Vec<PathBuf>,
    pub state: ListState,
    /* private fields */
}

A TUI component for browsing the file system.

Allows navigation through directories, selection of files, and displaying directory contents.

Fields

current_path: PathBuf

The current directory being displayed.

entries: Vec<PathBuf>

A list of files and directories in the current_path.

state: ListState

The state of the List widget used to render the entries.

Implementations

impl FileBrowser

pub fn new() -> Self

Creates a new FileBrowser instance, initialized to the current working directory.

It automatically lists the entries in the initial directory.

pub fn list_entries(&mut self)

Lists the contents of the current_path, populating self.entries.

Directories are listed before files, and both are sorted alphabetically. A “..” entry is added if navigation upwards is possible.

pub fn navigate_up(&mut self) -> FileBrowserEvent

Navigates the browser one level up in the directory hierarchy.

Returns

FileBrowserEvent indicating if navigation occurred or not.

pub fn select_entry(&mut self) -> FileBrowserEvent

Handles the selection of the currently highlighted entry.

If a directory is selected (including “..”), it navigates into it. If a file is selected, it returns the PathBuf of that file.

Returns

FileBrowserEvent indicating the outcome of the selection.

pub fn selected_path(&self) -> Option<PathBuf>

Returns the PathBuf of the currently selected entry without performing any action.

Returns

Some(PathBuf) of the selected entry, or None if no entry is selected.

pub fn handle_key(&mut self, key: KeyCode) -> FileBrowserEvent

Handles key events for navigating and interacting with the file browser.

Arguments

• key - The KeyCode representing the pressed key.

Returns

FileBrowserEvent indicating the outcome of the key press.

pub fn get_status_message(&self) -> String