broot 1.56.0

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

/// a displayable representation of where
/// the needle was found, with some text around
#[derive(Debug, Clone)]
pub struct ContentMatch {
    pub extract: String,
    pub needle_start: usize, // position in the extract, in bytes
    pub needle_end: usize,   // length in bytes
}

impl ContentMatch {
    pub fn build(
        hay: &[u8],
        pos: usize, // position in the hay
        needle: &str,
        desired_len: usize, // max length of the extract in bytes
    ) -> Self {
        if hay.is_empty() {
            // this happens if you search `cr/.*` and a file starts with an empty line
            return Self {
                extract: String::new(),
                needle_start: 0,
                needle_end: 0,
            };
        }
        let mut extract_start = pos;
        let mut extract_end = pos + needle.len(); // not included
        loop {
            if extract_start == 0 || extract_end - extract_start >= desired_len / 2 {
                break;
            }
            let c = hay[extract_start - 1];
            if c < 32 {
                break;
            }
            extract_start -= 1;
        }
        // left trimming
        while (hay[extract_start] == 32) && extract_start < pos {
            extract_start += 1;
        }
        loop {
            if extract_end == hay.len() || extract_end - extract_start >= desired_len {
                break;
            }
            let c = hay[extract_end];
            if c < 32 {
                break;
            }
            extract_end += 1;
        }
        // at this point we're unsure whether we start at a correct char boundary, hence
        // the from_utf8_lossy
        let extract = String::from_utf8_lossy(&hay[extract_start..extract_end]).to_string();
        let needle_start = extract.find(needle).unwrap_or(0);
        Self {
            extract,
            needle_start,
            needle_end: needle_start + needle.len(),
        }
    }
}