Struct AppState 

pub struct AppState {

    pub theme: Option<String>,
    pub last_dir: Option<PathBuf>,
    pub last_dir_right: Option<PathBuf>,
    pub sort_mode: Option<SortMode>,
    pub show_hidden: Option<bool>,
    pub show_sizes: Option<bool>,
    pub show_dir_sizes: Option<bool>,
    pub use_trash: Option<bool>,
    pub show_git: Option<bool>,
    pub bookmarks: Option<Vec<PathBuf>>,
    pub single_pane: Option<bool>,
    pub cd_on_exit: Option<bool>,
    pub editor: Option<String>,
    pub active_pane: Option<String>,
    pub pane_dirs: Option<Vec<PathBuf>>,
    pub active_pane_idx: Option<usize>,
}

All application state that is persisted between sessions.

Every field is an Option so that absent keys are handled gracefully — the caller provides a sensible default for any field that is None.

Example

use tui_file_explorer::persistence::{load_state_from, save_state_to, AppState};
use tui_file_explorer::SortMode;

let path = tempfile::tempdir().unwrap().path().join("state.toml");
let mut state = load_state_from(&path); // missing file → defaults
state.theme       = Some("nord".into());
state.sort_mode   = Some(SortMode::SizeDesc);
state.show_hidden = Some(true);
save_state_to(&path, &state).unwrap();
assert_eq!(load_state_from(&path), state);

Fields

theme: Option<String>

Colour theme name (e.g. "grape", "nord", "catppuccin-mocha").

last_dir: Option<PathBuf>

Directory that was open in the left pane when the app last exited.

Only restored when the path still exists as a directory; stale entries (deleted directories) are silently ignored.

last_dir_right: Option<PathBuf>

Directory that was open in the right pane when the app last exited.

Only restored when the path still exists as a directory; stale entries (deleted directories) are silently ignored.

sort_mode: Option<SortMode>

Active sort mode: Name, SizeDesc, or Extension.

show_hidden: Option<bool>

Whether hidden (dot-prefixed) files were visible.

show_sizes: Option<bool>

Whether file/folder sizes were shown.

show_dir_sizes: Option<bool>

Whether recursive folder sizes were computed (false = item counts only).

use_trash: Option<bool>

Whether deletions go to the OS trash (needs the trash feature).

show_git: Option<bool>

Whether git change markers were shown.

bookmarks: Option<Vec<PathBuf>>

Bookmarked folders.

single_pane: Option<bool>

Whether single-pane mode was active.

cd_on_exit: Option<bool>

Whether the cd-on-exit feature is enabled.

When true, tfe prints the active pane’s current directory to stdout on dismiss so the shell wrapper can cd to it. When false (default), dismissing without a selection prints nothing and exits with code 1.

editor: Option<String>

The editor to use when the user presses e on a file.

Serialised as a short key string (e.g. "helix", "nvim", "custom:code"). None means “use the compiled-in default” (Helix).

active_pane: Option<String>

Which pane (left or right) had keyboard focus when the app last exited. Serialised as "left" or "right".

Superseded by active_pane_idx; still written/read for backward compatibility with older tfe versions that only support two panes.

pane_dirs: Option<Vec<PathBuf>>

Starting directory for every pane, in left-to-right order.

Supersedes last_dir / last_dir_right now that tfe supports an arbitrary number of panes. When absent (older state files), the caller falls back to reconstructing a 2-entry list from last_dir / last_dir_right.

active_pane_idx: Option<usize>

Index of the pane that had keyboard focus when the app last exited.

Trait Implementations

impl Clone for AppState

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AppState

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AppState

where AppState: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AppState

impl PartialEq for AppState

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for AppState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AppState