rootle-provider 0.12.2

rootle's backend seam: the Provider trait and wire vocabulary shared by the TUI and every adapter
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

//! Commit detail vocabulary. Missing patches/counts are unknown, not proof
//! that a file is binary or that no lines changed.

use crate::id::{RepoPath, Sha};

#[derive(Debug, Clone, PartialEq, Eq, serde::Deserialize)]
pub struct CommitFile {
    pub path: RepoPath,
    pub status: FileStatus,
    #[serde(default)]
    pub additions: Option<u32>,
    #[serde(default)]
    pub deletions: Option<u32>,
    #[serde(default)]
    pub patch: Option<String>,
    #[serde(default)]
    pub previous_path: Option<RepoPath>,
    /// True only when the backend has positively identified binary content.
    #[serde(default)]
    pub binary: bool,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, serde::Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum FileStatus {
    Added,
    Removed,
    Renamed,
    #[default]
    #[serde(other)]
    Modified,
}
impl FileStatus {
    pub fn label(self) -> &'static str {
        match self {
            Self::Added => "added",
            Self::Removed => "removed",
            Self::Renamed => "renamed",
            Self::Modified => "modified",
        }
    }
}

#[derive(Debug, Clone, PartialEq, Eq, serde::Deserialize)]
pub struct CommitDetail {
    pub sha: Sha,
    pub author: String,
    pub date: String,
    pub message: String,
    #[serde(default)]
    pub parents: Vec<Sha>,
    pub files: Vec<CommitFile>,
    /// The provider stopped at its file budget. This is not a complete list.
    #[serde(default)]
    pub truncated: bool,
    /// Provider-built permalink to this commit, not its repository homepage.
    #[serde(default)]
    pub web_url: Option<String>,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct CommitStatistics {
    pub additions: Option<u64>,
    pub deletions: Option<u64>,
}
impl CommitDetail {
    /// Sum known counts without overflow; retain unknownness per side.
    pub fn line_stats(&self) -> CommitStatistics {
        CommitStatistics {
            additions: self.files.iter().try_fold(0u64, |total, file| {
                total.checked_add(u64::from(file.additions?))
            }),
            deletions: self.files.iter().try_fold(0u64, |total, file| {
                total.checked_add(u64::from(file.deletions?))
            }),
        }
    }
}