cargo-resolvediff 1.0.2

A tool for diffing `cargo` dependency resolutions between updates
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

// Copyright (C) 2026 by GiGa infosystems

//! Git helpers for the application to add changes & commit them

use crate::cmd::cmd;
use color_eyre::Result;
use std::path::{Path, PathBuf};

/// A `git` repository
pub struct Repository {
    /// The path to the repository
    path: Option<PathBuf>,
    /// If any changes got `git add`ed to the repository
    dirty: bool,
}

impl Repository {
    /// Open an existing [`Repository`] at the given path.
    ///
    /// This does not check if the repository actually exist, methods on this type will simply fail
    /// if it doesn't.
    pub fn new(path: Option<PathBuf>) -> Self {
        Repository { path, dirty: false }
    }

    /// `git add` a given path if it includes changes.
    pub fn add(&mut self, path: &Path) -> Result<()> {
        let changed = !cmd!([git diff] ["-s" "--exit-code" "--" (path)] -> bool in &self.path)?;
        if changed {
            self.dirty = true;
            cmd!([git add] [(path)] in &self.path)?;
        }
        Ok(())
    }

    /// Returns the current commit ID
    pub fn current_commit(&self) -> Result<String> {
        cmd!([git "rev-parse"] [HEAD] -> String in &self.path)
    }

    /// `git commit` everything that got added, if there were any changes, and return the commit
    /// ID.
    ///
    /// If there were no changes, it returns `Ok(None)`.
    pub fn commit(&mut self, message: &str) -> Result<Option<String>> {
        if !self.dirty {
            return Ok(None);
        }
        cmd!([git commit] ["-m" (message)] in &self.path)?;
        self.dirty = false;
        Ok(Some(self.current_commit()?))
    }

    /// Returns the current branch, if any, or the current commit ID
    pub fn current_branch_or_commit(&self) -> Result<String> {
        let branch = cmd!([git branch] ["--show-current"] -> String in &self.path)?;
        if !branch.is_empty() {
            Ok(branch)
        } else {
            Ok(self.current_commit()?)
        }
    }

    /// Checks out a given branch or commit ID
    pub fn checkout(&mut self, target: &str) -> Result<()> {
        cmd!([git "checkout"] [(target)] in &self.path)
    }
}