Enum AppEvent 

pub enum AppEvent {
    Key(KeyEvent),
    Press(KeyEvent),
    Terminal(Event),
    Wake,
    TerminalBackground(ThemeMode),
    TerminalFocused,
    SettingsRead(Box<Result<Settings>>),
    OpenNamed(Vec<PathBuf>, OpenOptions),
    NamedPathMissing(PathBuf),
    Open(Vec<PathBuf>, OpenOptions),
    OpenLazyFrame(Box<LazyFrame>, OpenOptions),
    HomeListingReady {
        generation: u64,
        listing: Box<Listing>,
        known: HashMap<PathBuf, DatasetFacts>,
        visits: HashMap<PathBuf, Visits>,
        newest: Option<PathBuf>,
        folds: Option<HashMap<String, bool>>,
    },
    HomeListingFailed,
    HomePathListed {
        listing: Box<PathListing>,
    },
    HomePathCompleted {
        generation: u64,
        typed: String,
        completed: String,
        candidates: usize,
    },
    HomePreviewReady {
        path: PathBuf,
        stamp: Stamp,
        read_at: Option<Stamp>,
        rows: Option<Arc<PreviewRows>>,
        prepared: Handoff,
    },
    HomeSchemaReady {
        generation: u64,
        path: PathBuf,
        preview: Option<SchemaPreview>,
    },
    HomeMeasured {
        measured: Vec<(PathBuf, Measured)>,
        done: bool,
    },
    HomeSized {
        path: PathBuf,
        measured: Measured,
    },
    HomeWebGone {
        path: PathBuf,
        gone: HttpGone,
    },
    HomeClassified {
        measured: Vec<(PathBuf, Measured)>,
        done: bool,
    },
    HomeSearchBatch {
        generation: u64,
        root: PathBuf,
        found: Vec<Entry>,
        scanned: usize,
    },
    HomeSearchScored {
        epoch: u64,
        matches: Option<Box<Matches>>,
    },
    HomeSearchDone {
        generation: u64,
        root: PathBuf,
        scanned: usize,
        limited: Option<String>,
    },
    HomeCloudSources {
        sources: Vec<CloudSource>,
    },
    HomeCloudListed {
        id: String,
        buckets: Vec<PathBuf>,
        details: Vec<(PathBuf, Vec<(String, String)>)>,
        failure: Option<(String, String)>,
        listed_at: SystemTime,
    },
    HomeProbeReady {
        root: PathBuf,
        rows: Option<Vec<Entry>>,
        cut_short: bool,
    },
    HomeProbeProgress {
        root: PathBuf,
        rows: Vec<Entry>,
    },
    HomeCloudKinds {
        kinds: Vec<(PathBuf, (EntryKind, Holds))>,
        failed: Vec<PathBuf>,
    },
    HomeProbeCancelled {
        root: PathBuf,
    },
    HomeNarrowed {
        dir: PathBuf,
        prefix: String,
        listed: Option<(Vec<Entry>, bool)>,
    },
    HomeProbeFailed {
        root: PathBuf,
        message: String,
    },
    Followed(News),
    Exit,
    Crash(String),
    Applied(Applied),
    Collect,
    Update,
    Reset,
    Resize(u16, u16),
    Scroll(Scroll),
    AnalysisCompute(AnalysisTool),
    BackgroundQualitySampleKept {
        kept: KeptQualitySample,
    },
    BackgroundQualityCopyKept {
        dataset_generation: u64,
        copy: Option<Arc<LocalCopy>>,
    },
    BackgroundLenReady {
        len_generation: u64,
        num_rows: usize,
        file_row_groups: Option<Vec<Vec<usize>>>,
    },
    BackgroundLenFailed {
        len_generation: u64,
    },
    FramePainted,
    LookThenOpenDirectory(PathBuf, OpenOptions),
    ClassifyThenOpen {
        path: PathBuf,
        jump: bool,
    },
    JobEnded(Ticket),
    JobProgress {
        ticket: Ticket,
        progress: Progress,
    },
}

Variants

Key(KeyEvent)

Press(KeyEvent)

A key taken as if typed (Enter on a help line). The pump runs it through classify like a typed key; outside the pump it is a Key.

Terminal(Event)

Read from the terminal by app::terminal_input::TerminalInput. The app::event_pump::EventPump turns it into Key/Resize.

Wake

Something polled rather than sent changed (a background panic, a Polars warning): wakes the loop. Handled as nothing.

TerminalBackground(ThemeMode)

The terminal’s background (an OSC 11 reply); theme.mode = "auto" follows it.

TerminalFocused

The terminal regained focus: under auto the background is asked again.

SettingsRead(Box<Result<Settings>>)

Settings run reads on a worker before building the app; never reaches the app.

OpenNamed(Vec<PathBuf>, OpenOptions)

Paths from the command line or the Python binding, checked on a worker (JobKind::OpenNamed): a local-looking path may be a slow mount.

NamedPathMissing(PathBuf)

A path named on the command line is not there: the session ends.

Open(Vec<PathBuf>, OpenOptions)

Open these paths, through the loading controller’s phases.

OpenLazyFrame(Box<LazyFrame>, OpenOptions)

Open with an existing LazyFrame (e.g. from Python binding); no file load.

HomeListingReady

A home listing built off-thread is ready.

Fields

generation: u64

listing: Box<Listing>

known: HashMap<PathBuf, DatasetFacts>

What earlier runs measured, read from the cache with the listing.

visits: HashMap<PathBuf, Visits>

How often and how lately each recent was opened.

newest: Option<PathBuf>

The recent opened last, where the cursor lands.

folds: Option<HashMap<String, bool>>

The saved folds, when entering the home screen asked for them.

HomeListingFailed

The home listing worker panicked; the panic is flashed.

HomePathListed

The directory the ~ prompt is typing, read off-thread.

Fields

listing: Box<PathListing>

HomePathCompleted

A completed path, worked out off-thread.

Fields

generation: u64

typed: String

What was typed when completion was asked; a later keystroke makes it stale.

completed: String

candidates: usize

HomePreviewReady

The highlighted file’s first rows, read as its open reads them, and the dataset that read built, for the open to install.

Fields

path: PathBuf

stamp: Stamp

The row’s stamp when it was asked for: what the rows are kept under.

read_at: Option<Stamp>

The file’s stamp when it was read: what the dataset is installed under.

rows: Option<Arc<PreviewRows>>

prepared: Handoff

HomeSchemaReady

A schema read off-thread for the highlighted dataset.

Fields

generation: u64

path: PathBuf

preview: Option<SchemaPreview>

HomeMeasured

Measurements for home rows, sent per row so a slow one holds back no other. done ends the batch. No generation: a measurement is keyed by path and stays true whichever listing asked.

Fields

measured: Vec<(PathBuf, Measured)>

done: bool

HomeSized

What a HEAD said an HTTP(S) file on home weighs: its row, measured.

Fields

path: PathBuf

measured: Measured

HomeWebGone

What a HEAD settled about an HTTP(S) file on home: it cannot be had.

Fields

path: PathBuf

gone: HttpGone

HomeClassified

What the rows on screen turned out to be; folded like AppEvent::HomeMeasured.

Fields

measured: Vec<(PathBuf, Measured)>

done: bool

HomeSearchBatch

A batch of datasets from the background search, sent repeatedly while it walks.

Fields

generation: u64

root: PathBuf

found: Vec<Entry>

scanned: usize

HomeSearchScored

The filter scored against the search’s files, for the walk epoch names.

Fields

epoch: u64

matches: Option<Box<Matches>>

None from a worker that died.

HomeSearchDone

The background search stopped; limited says why if it stopped short.

Fields

generation: u64

root: PathBuf

scanned: usize

limited: Option<String>

HomeCloudSources

The cloud sources on this machine with what an earlier run listed, sent before anything is fetched.

Fields

sources: Vec<CloudSource>

HomeCloudListed

One source’s buckets listed, or not. Each source reports on its own.

Fields

id: String

buckets: Vec<PathBuf>

details: Vec<(PathBuf, Vec<(String, String)>)>

Lines for the details pane of each listed place that has any.

failure: Option<(String, String)>

(short, detail) when the listing failed.

listed_at: SystemTime

HomeProbeReady

A network root has been listed off-thread, or could not be.

Fields

root: PathBuf

rows: Option<Vec<Entry>>

cut_short: bool

The listing stopped at crate::home::discover::MAX_ENTRIES_PER_DIR.

HomeProbeProgress

Rows of a network directory read since its last batch.

Fields

root: PathBuf

rows: Vec<Entry>

HomeCloudKinds

Cloud directories that peeking found to be partitioned or Parquet datasets.

Fields

kinds: Vec<(PathBuf, (EntryKind, Holds))>

failed: Vec<PathBuf>

Directories whose peek failed or was lost, so left unlabeled.

HomeProbeCancelled

A cloud listing stopped because its place was left; it is listed again on return.

Fields

root: PathBuf

HomeNarrowed

Names under prefix in a cut-short cloud directory, asked for by a filter; None when the listing failed or was stopped.

Fields

dir: PathBuf

prefix: String

listed: Option<(Vec<Entry>, bool)>

HomeProbeFailed

A cloud listing was refused, with the service’s reason.

Fields

root: PathBuf

message: String

Followed(News)

A followed file’s watcher found more rows, or that the file went.

Exit

Crash(String)

Applied(Applied)

A dialog or prompt answered: what it asks of the app. See Applied.

Collect

Update

Reset

Resize(u16, u16)

Scroll(Scroll)

A scroll deferred one frame, so the spinner shows while its rows are read.

AnalysisCompute(AnalysisTool)

Run an analysis tool off the UI thread; deferred so its progress shows first.

BackgroundQualitySampleKept

The sample a stopped Data Quality run had read, kept for the next run.

Fields

kept: KeptQualitySample

BackgroundQualityCopyKept

A full scan’s local copy of a remote dataset, kept for that dataset. None when the copy did not read as the source.

Fields

dataset_generation: u64

copy: Option<Arc<LocalCopy>>

BackgroundLenReady

The exact row count for the current LazyFrame, applied only if len_generation still matches. Runs alongside the first paint, never blocking it.

Fields

len_generation: u64

num_rows: usize

file_row_groups: Option<Vec<Vec<usize>>>

For a remote multi-file dataset, each file’s row-group sizes from its footer.

BackgroundLenFailed

The row count failed: the total stays unknown. Scrolling does not count again; End does.

Fields

len_generation: u64

FramePainted

A frame was painted. The run loop calls App::frame_painted; a harness sends this when App::count_waits_for_a_frame.

LookThenOpenDirectory(PathBuf, OpenOptions)

A directory named on the command line: look at it on a worker, then do what Enter on its row would. An event so the first frame, with a spinner and a way out, is drawn before a look that can take seconds.

ClassifyThenOpen

Look at a path off the UI thread, then browse into it, report a lake table, or open it. The filesystem calls can hang on a slow mount.

Fields

path: PathBuf

jump: bool

A path typed at ~ rather than a listed row: Esc returns to the listing.

JobEnded(Ticket)

A background job’s outcome is in its record: app::jobs::Jobs::end takes it.

JobProgress

A report from a background job still running.

Fields

ticket: Ticket

progress: Progress

Implementations

impl AppEvent

pub fn is_progress(&self) -> bool

A report sent many times while work runs: the loop may fold several into one frame. A measuring batch’s end too: batches of tiny files end a few a millisecond, and a frame each cost more than the measuring.

Trait Implementations

impl From<Applied> for AppEvent

fn from(applied: Applied) -> Self

Converts to this type from the input type.