binocular-cli 0.2.3

Not exactly a telescope, but it's useful sometimes. TUI to search/navigate through files and workspaces.
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

//! ZIP-family archive preview support.

use crate::preview::archive::listing::{render_entries, ArchiveEntry, MAX_ENTRIES_SHOWN};
use crate::preview::doc::PreviewDoc;
use ratatui::style::Color;
use ratatui::text::Text;
use std::path::Path;

pub fn preview_zip(path: &Path) -> Text<'static> {
    let mut doc = PreviewDoc::new();

    let file = match std::fs::File::open(path) {
        Ok(f) => f,
        Err(e) => {
            doc.push_section("Error");
            doc.push_field("Message", e.to_string(), Color::Red);
            return doc.into_text();
        }
    };

    let mut archive = match zip::ZipArchive::new(file) {
        Ok(a) => a,
        Err(e) => {
            doc.push_section("Error");
            doc.push_field("Message", e.to_string(), Color::Red);
            return doc.into_text();
        }
    };

    let total = archive.len();
    let mut entries: Vec<ArchiveEntry> = Vec::with_capacity(total.min(MAX_ENTRIES_SHOWN + 1));

    // SECURITY: cap iteration to avoid CPU DoS on ZIPs with millions of entries.
    let iter_limit = total.min(MAX_ENTRIES_SHOWN + 1);
    for i in 0..iter_limit {
        let Ok(entry) = archive.by_index(i) else {
            continue;
        };
        entries.push(ArchiveEntry {
            name: entry.name().to_string(),
            is_dir: entry.is_dir(),
            uncompressed: entry.size(),
        });
    }

    render_entries(
        &mut doc,
        &entries,
        total,
        "Archive Info",
        "ZIP / JAR / Office",
    );
    doc.into_text()
}