apo 0.1.0

APO — Engineering Evidence Platform. Repository Hygiene analyzer.
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
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

//! Repository discovery and file inventory.

mod inventory;

pub use inventory::{FileEntry, Inventory, RepoContext};

use std::path::{Path, PathBuf};

use crate::error::{Error, Result};
use crate::git;

/// Discover a repository at `root` and build analysis context.
pub fn discover(root: &Path, commit_sample_limit: usize) -> Result<RepoContext> {
    let root = root.canonicalize().map_err(|e| {
        Error::Io(std::io::Error::new(
            e.kind(),
            format!("{}: {e}", root.display()),
        ))
    })?;

    if !root.is_dir() {
        return Err(Error::NotADirectory(root));
    }

    let git_dir = find_git_dir(&root)?;
    let inventory = Inventory::scan(&root)?;
    let git_meta = git::inspect(&git_dir, &root, commit_sample_limit)?;

    Ok(RepoContext::new(root, inventory, git_meta))
}

fn find_git_dir(root: &Path) -> Result<PathBuf> {
    let git = root.join(".git");
    if git.is_dir() {
        return Ok(git);
    }
    // Worktree / gitfile support
    if git.is_file() {
        let contents = std::fs::read_to_string(&git)?;
        if let Some(rest) = contents.strip_prefix("gitdir: ") {
            let path = rest.trim();
            let resolved = if Path::new(path).is_absolute() {
                PathBuf::from(path)
            } else {
                root.join(path)
            };
            if resolved.is_dir() {
                return Ok(resolved);
            }
        }
    }
    Err(Error::NotAGitRepository(root.to_path_buf()))
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::fs;
    use tempfile::tempdir;

    #[test]
    fn rejects_non_git_directory() {
        let dir = tempdir().unwrap();
        let err = discover(dir.path(), 10).unwrap_err();
        assert!(matches!(err, Error::NotAGitRepository(_)));
    }

    #[test]
    fn discovers_simple_repo() {
        let dir = tempdir().unwrap();
        fs::create_dir(dir.path().join(".git")).unwrap();
        fs::write(dir.path().join("README.md"), "# hi\n").unwrap();
        let ctx = discover(dir.path(), 10).unwrap();
        assert!(ctx.has_file("README.md"));
    }
}