turboreview 0.1.0

A terminal code-review tool for git: review working-tree changes and commits, stage files, leave line comments, and hand off to an AI agent.
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

use std::sync::OnceLock;

use ratatui::style::{Color, Modifier, Style};
use ratatui::text::Span;
use syntect::easy::HighlightLines;
use syntect::highlighting::{FontStyle, Theme, ThemeSet};
use syntect::parsing::SyntaxSet;

struct Assets {
    syntaxes: SyntaxSet,
    theme: Theme,
}

fn assets() -> &'static Assets {
    static ASSETS: OnceLock<Assets> = OnceLock::new();
    ASSETS.get_or_init(|| {
        let syntaxes = SyntaxSet::load_defaults_newlines();
        let mut themes = ThemeSet::load_defaults();
        // Try base16-mocha.dark (closest bundled to Catppuccin Mocha), fall back to base16-ocean.dark.
        let theme = themes
            .themes
            .remove("base16-mocha.dark")
            .or_else(|| themes.themes.remove("base16-ocean.dark"))
            .expect("a bundled dark theme present");
        Assets { syntaxes, theme }
    })
}

/// Convert a syntect RGBA colour to a ratatui Color.
/// Alpha == 0 means "no colour" in syntect conventions.
fn syntect_color_to_ratatui(c: syntect::highlighting::Color) -> Option<Color> {
    // syntect uses alpha == 0 as the "unset / no color" sentinel, not transparency.
    if c.a > 0 {
        Some(Color::Rgb(c.r, c.g, c.b))
    } else {
        None
    }
}

/// Convert syntect FontStyle to ratatui Modifier.
fn syntect_font_style_to_modifier(fs: FontStyle) -> Modifier {
    let mut m = Modifier::empty();
    if fs.contains(FontStyle::BOLD) {
        m |= Modifier::BOLD;
    }
    if fs.contains(FontStyle::ITALIC) {
        m |= Modifier::ITALIC;
    }
    if fs.contains(FontStyle::UNDERLINE) {
        m |= Modifier::UNDERLINED;
    }
    m
}

/// Convert a syntect (Style, &str) segment into an owned ratatui Span<'static>.
fn segment_to_span(style: syntect::highlighting::Style, content: &str) -> Span<'static> {
    let fg = syntect_color_to_ratatui(style.foreground);
    let bg = syntect_color_to_ratatui(style.background);
    let modifier = syntect_font_style_to_modifier(style.font_style);
    let mut ratatui_style = Style::default().add_modifier(modifier);
    if let Some(fg) = fg {
        ratatui_style = ratatui_style.fg(fg);
    }
    if let Some(bg) = bg {
        ratatui_style = ratatui_style.bg(bg);
    }
    Span::styled(content.to_owned(), ratatui_style)
}

/// Highlight one line of code, choosing the grammar by file extension.
/// Falls back to a single plain span if the extension is unknown or highlighting fails.
pub fn highlight_code(text: &str, extension: &str) -> Vec<Span<'static>> {
    let assets = assets();
    let syntax = assets
        .syntaxes
        .find_syntax_by_extension(extension)
        .unwrap_or_else(|| assets.syntaxes.find_syntax_plain_text());
    let mut hl = HighlightLines::new(syntax, &assets.theme);
    match hl.highlight_line(text, &assets.syntaxes) {
        Ok(ranges) => ranges
            .into_iter()
            .map(|(style, content)| segment_to_span(style, content))
            .collect(),
        Err(_) => vec![Span::raw(text.to_owned())],
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn known_extension_produces_spans() {
        let spans = highlight_code("let x = 42;", "rs");
        assert!(!spans.is_empty());
        let joined: String = spans.iter().map(|s| s.content.as_ref()).collect();
        assert!(joined.contains("let"));
    }

    #[test]
    fn unknown_extension_falls_back_without_panic() {
        let spans = highlight_code("anything goes", "zzz-unknown");
        let joined: String = spans.iter().map(|s| s.content.as_ref()).collect();
        assert!(joined.contains("anything goes"));
    }

}