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 { 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 { 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, 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, } } }