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
use crate::Repository;
///
#[allow(clippy::empty_docs)]
pub mod resource_cache {
/// The error returned by [Repository::diff_resource_cache()](super::Repository::diff_resource_cache()).
#[derive(Debug, thiserror::Error)]
#[allow(missing_docs)]
pub enum Error {
#[error("Could not obtain resource cache for diffing")]
ResourceCache(#[from] crate::diff::resource_cache::Error),
#[error(transparent)]
Index(#[from] crate::repository::index_or_load_from_head::Error),
#[error(transparent)]
AttributeStack(#[from] crate::config::attribute_stack::Error),
}
}
/// Diff-utilities
impl Repository {
/// Create a resource cache for diffable objects, and configured with everything it needs to know to perform diffs
/// faithfully just like `git` would.
/// `mode` controls what version of a resource should be diffed.
/// `worktree_roots` determine if files can be read from the worktree, where each side of the diff operation can
/// be represented by its own worktree root. `.gitattributes` are automatically read from the worktree if at least
/// one worktree is present.
///
/// Note that attributes will always be obtained from the current `HEAD` index even if the resources being diffed
/// might live in another tree. Further, if one of the `worktree_roots` are set, attributes will also be read from
/// the worktree. Otherwise, it will be skipped and attributes are read from the index tree instead.
pub fn diff_resource_cache(
&self,
mode: gix_diff::blob::pipeline::Mode,
worktree_roots: gix_diff::blob::pipeline::WorktreeRoots,
) -> Result<gix_diff::blob::Platform, resource_cache::Error> {
let index = self.index_or_load_from_head()?;
Ok(crate::diff::resource_cache(
self,
mode,
self.attributes_only(
&index,
if worktree_roots.new_root.is_some() || worktree_roots.old_root.is_some() {
gix_worktree::stack::state::attributes::Source::WorktreeThenIdMapping
} else {
gix_worktree::stack::state::attributes::Source::IdMapping
},
)?
.inner,
worktree_roots,
)?)
}
}