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
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

//! TAR-family archive preview support.

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

pub fn preview_tar_gz(path: &Path) -> Text<'static> {
    let file = match std::fs::File::open(path) {
        Ok(f) => f,
        Err(e) => return error_text(e.to_string()),
    };
    let decoder = flate2::read::GzDecoder::new(file);
    let mut archive = tar::Archive::new(decoder);
    preview_tar_archive(&mut archive, ".tar.gz / .tgz")
}

pub fn preview_tar_bz2(path: &Path) -> Text<'static> {
    let file = match std::fs::File::open(path) {
        Ok(f) => f,
        Err(e) => return error_text(e.to_string()),
    };
    let decoder = bzip2::read::BzDecoder::new(file);
    let mut archive = tar::Archive::new(decoder);
    preview_tar_archive(&mut archive, ".tar.bz2")
}

pub fn preview_tar_xz(path: &Path) -> Text<'static> {
    let file = match std::fs::File::open(path) {
        Ok(f) => f,
        Err(e) => return error_text(e.to_string()),
    };
    let decoder = xz2::read::XzDecoder::new(file);
    let mut archive = tar::Archive::new(decoder);
    preview_tar_archive(&mut archive, ".tar.xz")
}

pub fn preview_tar_raw(path: &Path) -> Text<'static> {
    let file = match std::fs::File::open(path) {
        Ok(f) => f,
        Err(e) => return error_text(e.to_string()),
    };
    let mut archive = tar::Archive::new(file);
    preview_tar_archive(&mut archive, ".tar")
}

fn preview_tar_archive<R: Read>(
    archive: &mut tar::Archive<R>,
    kind_label: &'static str,
) -> Text<'static> {
    let mut doc = PreviewDoc::new();
    let mut entries: Vec<ArchiveEntry> = Vec::new();
    let mut total = 0usize;

    let Ok(iter) = archive.entries() else {
        doc.push_section("Error");
        doc.push_field("Message", "Could not read archive entries", Color::Red);
        return doc.into_text();
    };

    for entry_result in iter {
        total += 1;
        if entries.len() < MAX_ENTRIES_SHOWN + 1 {
            if let Ok(entry) = entry_result {
                let path_str = entry
                    .path()
                    .map(|p| p.to_string_lossy().to_string())
                    .unwrap_or_default();
                let is_dir = path_str.ends_with('/');
                let uncompressed = entry.header().size().unwrap_or(0);
                entries.push(ArchiveEntry {
                    name: path_str,
                    is_dir,
                    uncompressed,
                });
            }
        }
    }

    render_entries(&mut doc, &entries, total, "Archive Info", kind_label);
    doc.into_text()
}