gix-hash 0.24.0

Borrowed and owned git hash digests used to identify git objects
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

use crate::{oid, ObjectId};

/// The error returned by [`oid::verify()`].
#[derive(Debug, thiserror::Error)]
#[allow(missing_docs)]
#[error("Hash was {actual}, but should have been {expected}")]
pub struct Error {
    pub actual: ObjectId,
    pub expected: ObjectId,
}

impl oid {
    /// Verify that `self` matches the `expected` object ID.
    ///
    /// Returns an [`Error`] containing both object IDs if they differ.
    #[inline]
    pub fn verify(&self, expected: &oid) -> Result<(), Error> {
        if self == expected {
            Ok(())
        } else {
            Err(Error {
                actual: self.to_owned(),
                expected: expected.to_owned(),
            })
        }
    }
}