diffler 0.20.0

Standalone magit-style git TUI and code reviewer, on its own or with your coding 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
108
109

//! Visual selection over a list of rows, shared by every screen that has a
//! cursor walking rows: the diff, the log, a CI job's log, and the file view.
//! `V` anchors, a motion extends, `y` yanks, `esc` drops it.

use super::{App, Screen};

/// A screen whose cursor walks rows and can anchor a `V` selection over them.
pub trait RowSelect {
    fn cursor(&self) -> usize;
    fn anchor(&self) -> Option<usize>;
    fn set_anchor(&mut self, anchor: Option<usize>);

    /// Inclusive row span the visual selection covers, when active.
    fn selection(&self) -> Option<(usize, usize)> {
        let anchor = self.anchor()?;
        Some((anchor.min(self.cursor()), anchor.max(self.cursor())))
    }

    /// True when the row is the cursor's or inside the selection, which is
    /// what the renderers tint.
    fn row_selected(&self, row: usize) -> bool {
        row == self.cursor()
            || self
                .selection()
                .is_some_and(|(lo, hi)| row >= lo && row <= hi)
    }

    fn toggle_visual(&mut self) {
        let next = match self.anchor() {
            Some(_) => None,
            None => Some(self.cursor()),
        };
        self.set_anchor(next);
    }

    /// Keep an anchor inside the row range after rows disappear under it, which
    /// a fold or a refresh can do.
    fn clamp_anchor(&mut self, last: usize) {
        let clamped = self.anchor().map(|anchor| anchor.min(last));
        self.set_anchor(clamped);
    }
}

/// A [`RowSelect`] screen whose rows are plain text, so a selection yanks as
/// itself.
pub trait RowText: RowSelect {
    fn row_count(&self) -> usize;
    fn row_text(&self, row: usize) -> String;

    /// The selected rows as text, falling back to the cursor's row so `y`
    /// without a selection still copies the line under it.
    fn selection_text(&self) -> String {
        let last = self.row_count().saturating_sub(1);
        let (lo, hi) = self.selection().unwrap_or((self.cursor(), self.cursor()));
        (lo.min(last)..=hi.min(last))
            .map(|row| self.row_text(row))
            .collect::<Vec<_>>()
            .join("\n")
    }
}

impl App {
    /// The row list the keyboard is on, so `esc` and the selection check reach
    /// it without every screen spelling out its own arm.
    pub(crate) fn row_select_mut(&mut self) -> Option<&mut dyn RowSelect> {
        match self.screen() {
            Screen::Diff => self.diff.as_mut().map(|view| view as &mut dyn RowSelect),
            Screen::Log => self.log.as_mut().map(|view| view as &mut dyn RowSelect),
            Screen::CiLog => self.ci_log.as_mut().map(|view| view as &mut dyn RowSelect),
            Screen::File => self.file.as_mut().map(|view| view as &mut dyn RowSelect),
            Screen::Status => Some(&mut self.status),
            Screen::Graph | Screen::Runs | Screen::Prs | Screen::Stats => None,
        }
    }

    pub(crate) fn visual_active(&self) -> bool {
        match self.screen() {
            Screen::Diff => self.diff.as_ref().is_some_and(|v| v.anchor().is_some()),
            Screen::Log => self.log.as_ref().is_some_and(|v| v.anchor().is_some()),
            Screen::CiLog => self.ci_log.as_ref().is_some_and(|v| v.anchor().is_some()),
            Screen::File => self.file.as_ref().is_some_and(|v| v.anchor().is_some()),
            Screen::Status => self.status.anchor().is_some(),
            Screen::Graph | Screen::Runs | Screen::Prs | Screen::Stats => false,
        }
    }

    /// The rows under the keyboard as plain text.
    fn row_text_view(&self) -> Option<&dyn RowText> {
        match self.screen() {
            Screen::Diff => self.diff.as_ref().map(|view| view as &dyn RowText),
            Screen::Log => self.log.as_ref().map(|view| view as &dyn RowText),
            Screen::CiLog => self.ci_log.as_ref().map(|view| view as &dyn RowText),
            Screen::File => self.file.as_ref().map(|view| view as &dyn RowText),
            Screen::Status | Screen::Graph | Screen::Runs | Screen::Prs | Screen::Stats => None,
        }
    }

    /// Yank the row selection (or the cursor's row) and drop the anchor.
    pub(crate) fn yank_rows(&mut self, note: &str) {
        let Some(text) = self.row_text_view().map(RowText::selection_text) else {
            return;
        };
        self.pending_clipboard = Some(text);
        if let Some(view) = self.row_select_mut() {
            view.set_anchor(None);
        }
        self.info(note.to_owned());
    }
}