broot 1.56.2

File browser and launcher
Documentation 
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

use {
    lazy_regex::*,
    serde::Deserialize,
    std::str::FromStr,
};

#[derive(Debug, Clone, Default, Deserialize)]
#[serde(transparent)]
pub struct LayoutInstructions {
    pub instructions: Vec<LayoutInstruction>,
}

#[derive(Debug, Clone, Copy, Deserialize)]
#[serde(untagged)]
pub enum LayoutInstruction {
    Clear, // clear all instructions
    MoveDivider { divider: usize, dx: i16 },
    SetPanelWidth { panel: usize, width: u16 },
}

/// arguments for moving a divider, read from a string eg "0 -5"
/// (move the first divider 5 cells to the left)
#[derive(Debug, Clone, Copy)]
pub struct MoveDividerArgs {
    pub divider: usize,
    pub dx: i16,
}
impl FromStr for MoveDividerArgs {
    type Err = &'static str;
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        if let Some((_, divider, dx)) = regex_captures!(r"^\s*(\d)\s+(-?\d{1,3})\s*$", s) {
            Ok(Self {
                divider: divider.parse().unwrap(),
                dx: dx.parse().unwrap(),
            })
        } else {
            Err("not the expected move_divider args")
        }
    }
}

/// arguments for setting the width of a panel, read from a string eg "1 150"
#[derive(Debug, Clone, Copy)]
pub struct SetPanelWidthArgs {
    pub panel: usize,
    pub width: u16,
}
impl FromStr for SetPanelWidthArgs {
    type Err = &'static str;
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        if let Some((_, panel, width)) = regex_captures!(r"^\s*(\d)\s+(\d{1,4})\s*$", s) {
            Ok(Self {
                panel: panel.parse().unwrap(),
                width: width.parse().unwrap(),
            })
        } else {
            Err("not the expected set_panel_width args")
        }
    }
}

impl LayoutInstruction {
    pub fn is_moving_divider(
        self,
        idx: usize,
    ) -> bool {
        match self {
            Self::MoveDivider { divider, .. } => divider == idx,
            _ => false,
        }
    }
}

impl LayoutInstructions {
    pub fn push(
        &mut self,
        new_instruction: LayoutInstruction,
    ) {
        use LayoutInstruction::*;
        match new_instruction {
            Clear => {
                self.instructions.clear();
            }
            SetPanelWidth {
                panel: new_panel, ..
            } => {
                // all previous SetPanelWidth for the same panel are now irrelevant
                self.instructions.retain(|i| match i {
                    SetPanelWidth { panel, .. } => *panel != new_panel,
                    _ => true,
                });
            }
            MoveDivider {
                divider: new_divider,
                dx: new_dx,
            } => {
                // if the last instruction is a move of the same divider, we adjust it
                if let Some(MoveDivider { divider, dx }) = self.instructions.last_mut() {
                    if *divider == new_divider {
                        *dx += new_dx;
                        return;
                    }
                }
            }
        }
        self.instructions.push(new_instruction);
    }
}