lx-ls 0.9.0

The file lister with personality! 🌟
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

pub use self::escape::escape;

pub mod details;
pub mod file_name;
pub mod grid;
pub mod grid_details;
pub mod icons;
pub mod lines;
pub mod render;
pub mod table;
pub mod time;
pub mod column_registry;

mod cell;
mod escape;
mod tree;


/// The **view** contains all information about how to format output.
#[derive(Debug)]
pub struct View {
    pub mode: Mode,
    pub width: TerminalWidth,
    pub file_style: file_name::Options,
}

impl View {
    /// Whether `--total-size` is active in the current mode.
    pub fn has_total_size(&self) -> bool {
        match &self.mode {
            Mode::Details(opts) => opts.table.as_ref().is_some_and(|t| t.total_size),
            Mode::GridDetails(opts) => opts.details.table.as_ref().is_some_and(|t| t.total_size),
            _ => false,
        }
    }

    /// The size format from the active table options, if any.
    pub fn size_format(&self) -> Option<table::SizeFormat> {
        match &self.mode {
            Mode::Details(opts) => opts.table.as_ref().map(|t| t.size_format),
            Mode::GridDetails(opts) => opts.details.table.as_ref().map(|t| t.size_format),
            _ => None,
        }
    }

    /// Access the table options, if the current mode has them.
    pub fn table_options(&self) -> Option<&table::Options> {
        match &self.mode {
            Mode::Details(opts) => opts.table.as_ref(),
            Mode::GridDetails(opts) => opts.details.table.as_ref(),
            _ => None,
        }
    }
}


/// The **mode** is the “type” of output.
#[derive(PartialEq, Eq, Debug)]
#[allow(clippy::large_enum_variant)]
pub enum Mode {
    Grid(grid::Options),
    Details(details::Options),
    GridDetails(grid_details::Options),
    Lines,
}


/// The width of the terminal requested by the user.
#[derive(PartialEq, Eq, Debug, Copy, Clone)]
pub enum TerminalWidth {

    /// The user requested this specific number of columns.
    Set(usize),

    /// Look up the terminal size at runtime.
    Automatic,
}

impl TerminalWidth {
    pub fn actual_terminal_width(self) -> Option<usize> {
        // All of stdin, stdout, and stderr could not be connected to a
        // terminal, but we’re only interested in stdout because it’s
        // where the output goes.

        match self {
            Self::Set(width)  => Some(width),
            Self::Automatic   => terminal_size::terminal_size().map(|(w, _)| w.0.into()),
        }
    }
}