quickcfg 0.6.3

Do basic configuration of a system, declaratively and quickly.
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
110
111
112
113
114
115
116

//! Git integration using libgit2

use anyhow::{anyhow, bail, Result};
use git2::{ObjectType, Oid, Repository, ResetType};
use std::fmt;
use std::path::{Path, PathBuf};

pub struct GitSystem(());

impl GitSystem {
    pub fn new() -> Self {
        GitSystem(())
    }
}

impl super::GitSystem for GitSystem {
    fn clone(&self, url: &str, path: &Path) -> Result<Box<dyn super::Git>> {
        Ok(Box::new(Git2 {
            path: path.to_owned(),
            repo: Repository::clone(url, path)?,
        }))
    }

    fn open(&self, path: &Path) -> Result<Box<dyn super::Git>> {
        Ok(Box::new(Git2 {
            path: path.to_owned(),
            repo: Repository::open(path)?,
        }))
    }
}

/// Helper to interact with a git repository.
pub struct Git2 {
    pub path: PathBuf,
    pub repo: Repository,
}

impl fmt::Debug for Git2 {
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt.debug_struct("Git2").field("path", &self.path).finish()
    }
}

impl Git2 {
    fn rev_parse(&self, git_ref: &str) -> Result<Oid> {
        let spec = self.repo.revparse(git_ref)?;

        if !spec.mode().contains(git2::RevparseMode::SINGLE) {
            bail!("bad rev spec");
        }

        let from = spec.from().ok_or_else(|| anyhow!("missing `from`"))?;
        Ok(from.id())
    }

    /// Find the merge base between two commits.
    fn merge_base(&self, a: Oid, b: Oid) -> Result<Oid> {
        Ok(self.repo.merge_base(a, b)?)
    }

    /// Get the current head branch.
    fn head_branch(&self) -> Result<String> {
        Ok(self
            .repo
            .head()?
            .name()
            .ok_or_else(|| anyhow!("could not find HEAD"))?
            .to_owned())
    }
}

impl super::Git for Git2 {
    fn path(&self) -> &Path {
        &self.path
    }

    fn needs_update(&self) -> Result<bool> {
        let head_branch = self.head_branch()?;

        let mut remote = self.repo.find_remote("origin")?;
        remote.fetch(&[head_branch.as_str()], None, None)?;

        let head = self.rev_parse("HEAD")?;
        let fetch_head = self.rev_parse("FETCH_HEAD")?;

        if fetch_head != head {
            // check if remote is a base
            return Ok(self.merge_base(fetch_head, head)? != fetch_head);
        }

        Ok(false)
    }

    fn is_fresh(&self) -> Result<bool> {
        let diff = self.repo.diff_index_to_workdir(None, None)?;
        Ok(diff.deltas().next().is_none())
    }

    fn force_update(&self) -> Result<()> {
        let fetch_head = self.rev_parse("FETCH_HEAD")?;
        let fetch_head = self
            .repo
            .find_object(fetch_head, Some(ObjectType::Commit))?;
        self.repo.reset(&fetch_head, ResetType::Hard, None)?;
        Ok(())
    }

    fn update(&self) -> Result<()> {
        // NB: needs --ff-only
        let fetch_head = self
            .repo
            .find_annotated_commit(self.rev_parse("FETCH_HEAD")?)?;
        self.repo.merge(&[&fetch_head], None, None)?;
        Ok(())
    }
}