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
|
use std::path::{Path, PathBuf};
use gix_path::realpath::MAX_SYMLINKS;
impl crate::Repository {
/// Return the path to the repository itself, containing objects, references, configuration, and more.
///
/// Synonymous to [`path()`][crate::Repository::path()].
pub fn git_dir(&self) -> &std::path::Path {
self.refs.git_dir()
}
/// The trust we place in the git-dir, with lower amounts of trust causing access to configuration to be limited.
pub fn git_dir_trust(&self) -> gix_sec::Trust {
self.options.git_dir_trust.expect("definitely set by now")
}
/// Returns the main git repository if this is a repository on a linked work-tree, or the `git_dir` itself.
pub fn common_dir(&self) -> &std::path::Path {
self.common_dir.as_deref().unwrap_or_else(|| self.git_dir())
}
/// Return the path to the worktree index file, which may or may not exist.
pub fn index_path(&self) -> PathBuf {
self.git_dir().join("index")
}
/// The path to the `.gitmodules` file in the worktree, if a worktree is available.
#[cfg(feature = "attributes")]
pub fn modules_path(&self) -> Option<PathBuf> {
self.work_dir().map(|wtd| wtd.join(crate::submodule::MODULES_FILE))
}
/// The path to the `.git` directory itself, or equivalent if this is a bare repository.
pub fn path(&self) -> &std::path::Path {
self.git_dir()
}
/// Return the work tree containing all checked out files, if there is one.
#[doc(alias = "workdir", alias = "git2")]
pub fn work_dir(&self) -> Option<&std::path::Path> {
self.work_tree.as_deref()
}
// TODO: tests, respect precomposeUnicode
/// The directory of the binary path of the current process.
pub fn install_dir(&self) -> std::io::Result<PathBuf> {
crate::path::install_dir()
}
/// Returns the relative path which is the components between the working tree and the current working dir (CWD).
/// Note that it may be `None` if there is no work tree, or if CWD isn't inside of the working tree directory.
///
/// Note that the CWD is obtained once upon instantiation of the repository.
// TODO: tests, details - there is a lot about environment variables to change things around.
pub fn prefix(&self) -> Result<Option<&Path>, gix_path::realpath::Error> {
let (root, current_dir) = match self.work_dir().zip(self.options.current_dir.as_deref()) {
Some((work_dir, cwd)) => (work_dir, cwd),
None => return Ok(None),
};
let root = gix_path::realpath_opts(root, current_dir, MAX_SYMLINKS)?;
Ok(current_dir.strip_prefix(&root).ok())
}
/// Return the kind of repository, either bare or one with a work tree.
pub fn kind(&self) -> crate::repository::Kind {
match self.worktree() {
Some(wt) => {
if gix_discover::is_submodule_git_dir(self.git_dir()) {
crate::repository::Kind::Submodule
} else {
crate::repository::Kind::WorkTree {
is_linked: !wt.is_main(),
}
}
}
None => crate::repository::Kind::Bare,
}
}
}
|
