mod cli;
pub mod context;
pub mod diff;
mod libgit2;
pub mod repository;
pub mod staging;
use std::ffi::OsStr;
use std::path::{Path, PathBuf};
use crate::error::{Result, TuicrError};
use crate::model::{DiffFile, DiffLine, FileStatus};
use crate::process::{CommandOutputError, CommandOutputErrorKind, run_command_output};
use crate::syntax::SyntaxHighlighter;
use super::traits::{ChangeKind, CommitInfo, VcsBackend, VcsChangeStatus, VcsInfo};
use cli::GitCliBackend;
pub use libgit2::Libgit2Backend;
pub use context::calculate_gap;
pub enum GitBackend {
Libgit2(Libgit2Backend),
Cli(GitCliBackend),
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum GitBackendPreference {
Libgit2,
Cli,
}
impl GitBackendPreference {
pub fn from_config(value: Option<&str>) -> Self {
match value {
Some("cli") => Self::Cli,
_ => Self::Libgit2,
}
}
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum GitRepoMode {
Standard,
SparseCheckout,
SparseIndex,
}
impl GitRepoMode {
fn detect(root_path: &Path) -> Result<Self> {
let output = run_git_command(
root_path,
&[
"config",
"--get-regexp",
r"^(core\.sparsecheckout|index\.sparse)$",
],
)
.unwrap_or_default();
Ok(Self::from_config(&output))
}
fn from_config(output: &str) -> Self {
let mut sparse_checkout = false;
let mut sparse_index = false;
for line in output.lines() {
let mut parts = line.splitn(2, char::is_whitespace);
let Some(key) = parts.next() else {
continue;
};
let raw_value = parts.next().unwrap_or_default();
match key {
"core.sparsecheckout" => sparse_checkout = git_bool_config_enabled(raw_value),
"index.sparse" => sparse_index = git_bool_config_enabled(raw_value),
_ => {}
}
}
if sparse_index {
Self::SparseIndex
} else if sparse_checkout {
Self::SparseCheckout
} else {
Self::Standard
}
}
fn is_sparse_checkout(self) -> bool {
matches!(self, Self::SparseCheckout | Self::SparseIndex)
}
}
impl GitBackend {
pub fn discover(preference: GitBackendPreference) -> Result<Self> {
let cwd = std::env::current_dir().map_err(|_| TuicrError::NotARepository)?;
Self::discover_from(&cwd, preference)
}
fn discover_from(cwd: &Path, preference: GitBackendPreference) -> Result<Self> {
if preference == GitBackendPreference::Cli {
return Ok(Self::Cli(GitCliBackend::discover_from(cwd)?));
}
if uses_reftable(cwd) {
return Ok(Self::Cli(GitCliBackend::discover_from(cwd)?));
}
let backend = Self::Libgit2(Libgit2Backend::discover_from(cwd)?);
let repo_mode = GitRepoMode::detect(&backend.info().root_path)?;
if repo_mode.is_sparse_checkout() && !backend.supports_sparse_checkout() {
return Ok(Self::Cli(GitCliBackend::discover_from(cwd)?));
}
Ok(backend)
}
}
fn run_git_command(workdir: &Path, args: &[&str]) -> Result<String> {
run_command_output(
"git",
Some(workdir),
args.iter().map(|arg| OsStr::new(*arg)),
)
.map_err(git_command_error)
}
pub(super) fn git_command_error(error: CommandOutputError) -> TuicrError {
match error.kind {
CommandOutputErrorKind::Unsuccessful => TuicrError::VcsCommand(error.stderr),
CommandOutputErrorKind::NotFound | CommandOutputErrorKind::SpawnFailed => {
TuicrError::VcsCommand(format!("Failed to run git: {}", error.stderr))
}
}
}
fn git_bool_config_enabled(value: &str) -> bool {
matches!(value.trim(), "true" | "1" | "yes" | "on")
}
fn git_fsmonitor_config_enabled(value: &str) -> bool {
let value = value.trim();
git_bool_config_enabled(value)
|| (!value.is_empty() && !matches!(value, "false" | "0" | "no" | "off"))
}
fn uses_reftable(cwd: &Path) -> bool {
run_git_command(cwd, &["config", "--get", "extensions.refStorage"])
.ok()
.map(|v| v.trim().eq_ignore_ascii_case("reftable"))
.unwrap_or(false)
}
impl VcsBackend for GitBackend {
fn info(&self) -> &VcsInfo {
match self {
Self::Libgit2(backend) => backend.info(),
Self::Cli(backend) => backend.info(),
}
}
fn startup_warnings(&self) -> Vec<String> {
match self {
Self::Libgit2(backend) => backend.startup_warnings(),
Self::Cli(backend) => backend.startup_warnings(),
}
}
fn supports_sparse_checkout(&self) -> bool {
match self {
Self::Libgit2(backend) => backend.supports_sparse_checkout(),
Self::Cli(backend) => backend.supports_sparse_checkout(),
}
}
fn get_working_tree_diff(&self, highlighter: &SyntaxHighlighter) -> Result<Vec<DiffFile>> {
match self {
Self::Libgit2(backend) => backend.get_working_tree_diff(highlighter),
Self::Cli(backend) => backend.get_working_tree_diff(highlighter),
}
}
fn get_staged_diff(&self, highlighter: &SyntaxHighlighter) -> Result<Vec<DiffFile>> {
match self {
Self::Libgit2(backend) => backend.get_staged_diff(highlighter),
Self::Cli(backend) => backend.get_staged_diff(highlighter),
}
}
fn get_unstaged_diff(&self, highlighter: &SyntaxHighlighter) -> Result<Vec<DiffFile>> {
match self {
Self::Libgit2(backend) => backend.get_unstaged_diff(highlighter),
Self::Cli(backend) => backend.get_unstaged_diff(highlighter),
}
}
fn get_change_status(&self) -> Result<VcsChangeStatus> {
match self {
Self::Libgit2(backend) => backend.get_change_status(),
Self::Cli(backend) => backend.get_change_status(),
}
}
fn list_changed_paths(&self, kind: ChangeKind) -> Result<Vec<PathBuf>> {
match self {
Self::Libgit2(backend) => backend.list_changed_paths(kind),
Self::Cli(backend) => backend.list_changed_paths(kind),
}
}
fn fetch_context_lines(
&self,
file_path: &Path,
file_status: FileStatus,
ref_commit: Option<&str>,
start_line: u32,
end_line: u32,
) -> Result<Vec<DiffLine>> {
match self {
Self::Libgit2(backend) => backend.fetch_context_lines(
file_path,
file_status,
ref_commit,
start_line,
end_line,
),
Self::Cli(backend) => backend.fetch_context_lines(
file_path,
file_status,
ref_commit,
start_line,
end_line,
),
}
}
fn file_line_count(
&self,
file_path: &Path,
file_status: FileStatus,
ref_commit: Option<&str>,
) -> Result<u32> {
match self {
Self::Libgit2(backend) => backend.file_line_count(file_path, file_status, ref_commit),
Self::Cli(backend) => backend.file_line_count(file_path, file_status, ref_commit),
}
}
fn get_recent_commits(&self, offset: usize, limit: usize) -> Result<Vec<CommitInfo>> {
match self {
Self::Libgit2(backend) => backend.get_recent_commits(offset, limit),
Self::Cli(backend) => backend.get_recent_commits(offset, limit),
}
}
fn resolve_revisions(&self, revisions: &str) -> Result<Vec<String>> {
match self {
Self::Libgit2(backend) => backend.resolve_revisions(revisions),
Self::Cli(backend) => backend.resolve_revisions(revisions),
}
}
fn get_commit_range_diff(
&self,
commit_ids: &[String],
highlighter: &SyntaxHighlighter,
) -> Result<Vec<DiffFile>> {
match self {
Self::Libgit2(backend) => backend.get_commit_range_diff(commit_ids, highlighter),
Self::Cli(backend) => backend.get_commit_range_diff(commit_ids, highlighter),
}
}
fn get_commits_info(&self, ids: &[String]) -> Result<Vec<CommitInfo>> {
match self {
Self::Libgit2(backend) => backend.get_commits_info(ids),
Self::Cli(backend) => backend.get_commits_info(ids),
}
}
fn get_working_tree_with_commits_diff(
&self,
commit_ids: &[String],
highlighter: &SyntaxHighlighter,
) -> Result<Vec<DiffFile>> {
match self {
Self::Libgit2(backend) => {
backend.get_working_tree_with_commits_diff(commit_ids, highlighter)
}
Self::Cli(backend) => {
backend.get_working_tree_with_commits_diff(commit_ids, highlighter)
}
}
}
fn stage_file(&self, path: &Path) -> Result<()> {
match self {
Self::Libgit2(backend) => backend.stage_file(path),
Self::Cli(backend) => backend.stage_file(path),
}
}
}
#[cfg(test)]
mod tests {
use super::*;
use std::fs;
use tempfile::tempdir;
#[test]
fn derives_git_repo_mode_from_config() {
assert_eq!(GitRepoMode::from_config(""), GitRepoMode::Standard);
assert_eq!(
GitRepoMode::from_config("core.sparsecheckout true\n"),
GitRepoMode::SparseCheckout
);
assert_eq!(
GitRepoMode::from_config("core.sparsecheckout true\nindex.sparse true\n"),
GitRepoMode::SparseIndex
);
}
#[test]
fn derives_backend_preference_from_config() {
assert_eq!(
GitBackendPreference::from_config(None),
GitBackendPreference::Libgit2
);
assert_eq!(
GitBackendPreference::from_config(Some("libgit2")),
GitBackendPreference::Libgit2
);
assert_eq!(
GitBackendPreference::from_config(Some("cli")),
GitBackendPreference::Cli
);
}
#[test]
fn default_preference_routes_sparse_index_repo_to_cli_with_warning() {
let temp_dir = tempdir().expect("failed to create temp dir");
let root = temp_dir.path();
setup_standard_repo(root);
run_git_command(
root,
&["sparse-checkout", "init", "--cone", "--sparse-index"],
)
.expect("failed to enable sparse checkout");
run_git_command(root, &["sparse-checkout", "set", "src"])
.expect("failed to set sparse checkout paths");
let backend = GitBackend::discover_from(root, GitBackendPreference::Libgit2)
.expect("failed to discover backend");
match backend {
GitBackend::Cli(backend) => {
assert!(backend.supports_sparse_checkout());
assert_eq!(
backend.startup_warnings().first().map(String::as_str),
Some("Sparse checkout detected; using Git CLI backend.")
);
}
GitBackend::Libgit2(_) => panic!("sparse-index repo should use Git CLI backend"),
}
}
#[test]
fn default_preference_keeps_standard_repo_on_libgit2() {
let temp_dir = tempdir().expect("failed to create temp dir");
let root = temp_dir.path();
setup_standard_repo(root);
let backend = GitBackend::discover_from(root, GitBackendPreference::Libgit2)
.expect("failed to discover backend");
match backend {
GitBackend::Libgit2(backend) => assert!(!backend.supports_sparse_checkout()),
GitBackend::Cli(_) => panic!("standard repo should use libgit2 by default"),
}
}
#[test]
fn default_preference_routes_reftable_repo_to_cli() {
let temp_dir = tempdir().expect("failed to create temp dir");
let root = temp_dir.path();
setup_standard_repo(root);
run_git_command(root, &["config", "core.repositoryFormatVersion", "1"])
.expect("failed to set repositoryFormatVersion");
run_git_command(root, &["config", "extensions.refStorage", "reftable"])
.expect("failed to set reftable extension");
let backend = GitBackend::discover_from(root, GitBackendPreference::Libgit2)
.expect("reftable repo should open via CLI fallback");
assert!(
matches!(backend, GitBackend::Cli(_)),
"reftable repo should use Git CLI backend, not libgit2"
);
}
fn setup_standard_repo(root: &Path) {
fs::create_dir(root.join("src")).expect("failed to create src dir");
fs::write(root.join("src/file.txt"), "one\n").expect("failed to write file");
run_git_command(root, &["init"]).expect("failed to init repo");
run_git_command(root, &["config", "user.name", "Tuicr Test"])
.expect("failed to set user name");
run_git_command(root, &["config", "user.email", "tuicr@example.com"])
.expect("failed to set user email");
run_git_command(root, &["add", "src/file.txt"]).expect("failed to add file");
run_git_command(root, &["commit", "-m", "initial"]).expect("failed to commit");
}
}