Struct Entry 

pub struct Entry {

    pub path: PathBuf,
    pub kind: EntryKind,
    pub name: String,
    pub size: Option<u64>,
    pub modified: Option<SystemTime>,
    pub rows: Option<usize>,
    pub cols: Option<usize>,
    pub cols_sampled: bool,
    pub columns: Vec<String>,
    pub cost: Cost,
    pub holds: Holds,
    pub opens_whole_directory: bool,
    pub format_spec: Option<String>,
    pub table: Option<TableOf>,
}

One row on the home screen.

Fields

path: PathBuf

kind: EntryKind

name: String

Display name — the file or directory name, not the full path.

size: Option<u64>

Size in bytes. For a multi-file or hive dataset this is the sum of the files actually inspected, so it is a floor rather than an exact total.

modified: Option<SystemTime>

rows: Option<usize>

Row count, when it can be had without reading data (Parquet footers only).

cols: Option<usize>

Column count, same caveat.

cols_sampled: bool

Whether cols came from a spread of the directory rather than all of it. A directory past the footer budget is read at its ends and its middle, so the count is a floor: shown as 6+ rather than 6, the way the row count is already shown as ? when it is out of reach.

columns: Vec<String>

Column names, when they were free to obtain. A Parquet footer carries them alongside the row count, so knowing what is in a dataset costs nothing beyond knowing how big it is.

cost: Cost

What opening this will cost: where it lives, how it is stored, how it is laid out. All of it derived from bytes datui already reads.

holds: Holds

What one listing of it found, for a directory. Empty for a file, and for a directory nothing has looked into.

opens_whole_directory: bool

Whether this row is the door that opens the directory being browsed, rather than something in it.

It carries no label. Every other label counts what is directly inside a directory, and this row is the one that reads the whole of it — so dir beside (all files) would say there is no data here while offering to open it, and 2 parquet beside it would name two of the twenty it is about to read. The name says what it does; the numbers beside it, once measured, say how much.

format_spec: Option<String>

The format spec that reads this file: its glob names it, or its magic is at the front of it.

table: Option<TableOf>

A table inside a file of tables (a SQLite database, a NumPy archive), for the rows listed inside one: its path is the file’s with the table’s name after it, which nothing on disk has.

Implementations

impl Entry

pub fn enter_lists_tables(&self) -> bool

Whether Enter on this row lists the tables inside it: a file of several that is no table itself. A file that opens one of its tables (a workbook’s first sheet) opens it, and a file a spec reads as several variants is one table too (each row a variant, with a type column), which Enter opens; → lists them.

pub fn hidden_by_default(&self) -> bool

Whether the home screen leaves this row out until Ctrl+A: a file datui cannot open, or a database’s own table.

pub fn label(&self) -> Cow<'static, str>

The short label beside a row’s name: what it holds, rather than what Enter will do with it.

A directory that has been looked into is described by the count — 12 parquet, mixed, dir — and a lake table or a hive root by the format’s own name, which is the thing it is. A row nothing has looked into has only its kind to go on.

impl Entry

pub fn directory(path: &Path) -> Self

A plain directory row — somewhere to step into, with nothing read from it.

pub fn for_test(path: &Path, name: &str) -> Self

A file entry with a chosen display name, for tests that need a search result without running a walk to produce one.

Trait Implementations

impl Clone for Entry

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 Entry

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

Formats the value using the given formatter.