solid-pod-rs-forge 0.5.0-alpha.5

Clean-room Rust Git forge (Gogs/Gitea slice) composed on solid-pod-rs primitives: pod-native issues/PRs, forge push tokens, hosted did:nostr bodies, and Blocktrails anchoring. Cites JavaScriptSolidServer `forge` behaviour by function name only; all code original.
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

//! Repository materialisation and filesystem layout.
//!
//! Bare repositories live at `plugin_dir/repos/<owner>/<name>.git`.
//! The browse URL addresses `<owner>/<name>` (no `.git`); this module
//! bridges the two and enumerates repos for the index views.

pub mod browse;

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

use crate::error::ForgeError;
use crate::ownership::valid_name_segment;

/// Absolute path to a bare repo dir: `<repo_root>/<owner>/<name>.git`.
/// Validates both segments to prevent traversal before touching disk.
pub fn repo_git_dir(repo_root: &Path, owner: &str, name: &str) -> Result<PathBuf, ForgeError> {
    if !valid_name_segment(owner) {
        return Err(ForgeError::PathTraversal(format!("owner: {owner}")));
    }
    if !valid_name_segment(name) {
        return Err(ForgeError::PathTraversal(format!("repo: {name}")));
    }
    Ok(repo_root.join(owner).join(format!("{name}.git")))
}

/// `true` when a bare repo directory exists for `<owner>/<name>`.
pub async fn repo_exists(repo_root: &Path, owner: &str, name: &str) -> bool {
    match repo_git_dir(repo_root, owner, name) {
        Ok(p) => tokio::fs::metadata(&p).await.map(|m| m.is_dir()).unwrap_or(false),
        Err(_) => false,
    }
}

/// Enumerate every `<owner>/<name>` repo under `repo_root`, sorted.
/// Silently skips entries that fail validation or are not directories.
pub async fn list_all(repo_root: &Path) -> Vec<(String, String)> {
    let mut out = Vec::new();
    let Ok(mut owners) = tokio::fs::read_dir(repo_root).await else {
        return out;
    };
    while let Ok(Some(owner_entry)) = owners.next_entry().await {
        let owner = owner_entry.file_name().to_string_lossy().into_owned();
        if !valid_name_segment(&owner) {
            continue;
        }
        if !owner_entry.path().is_dir() {
            continue;
        }
        for repo in list_owner(repo_root, &owner).await {
            out.push((owner.clone(), repo));
        }
    }
    out.sort();
    out
}

/// List the repo names owned by `owner` (the `.git` suffix stripped),
/// sorted.
pub async fn list_owner(repo_root: &Path, owner: &str) -> Vec<String> {
    let mut out = Vec::new();
    if !valid_name_segment(owner) {
        return out;
    }
    let dir = repo_root.join(owner);
    let Ok(mut entries) = tokio::fs::read_dir(&dir).await else {
        return out;
    };
    while let Ok(Some(entry)) = entries.next_entry().await {
        if !entry.path().is_dir() {
            continue;
        }
        let name = entry.file_name().to_string_lossy().into_owned();
        if let Some(stem) = name.strip_suffix(".git") {
            if valid_name_segment(stem) {
                out.push(stem.to_string());
            }
        }
    }
    out.sort();
    out
}

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

    #[test]
    fn repo_git_dir_appends_dot_git() {
        let root = Path::new("/srv/repos");
        let p = repo_git_dir(root, "alice", "myrepo").unwrap();
        assert!(p.ends_with("alice/myrepo.git"));
    }

    #[test]
    fn repo_git_dir_rejects_traversal() {
        let root = Path::new("/srv/repos");
        assert!(repo_git_dir(root, "..", "x").is_err());
        assert!(repo_git_dir(root, "alice", "../etc").is_err());
        assert!(repo_git_dir(root, "alice", ".git").is_err());
    }

    #[tokio::test]
    async fn list_all_scans_two_levels() {
        let td = TempDir::new().unwrap();
        let root = td.path();
        tokio::fs::create_dir_all(root.join("alice/r1.git")).await.unwrap();
        tokio::fs::create_dir_all(root.join("alice/r2.git")).await.unwrap();
        tokio::fs::create_dir_all(root.join("bob/proj.git")).await.unwrap();
        // A non-.git dir is ignored.
        tokio::fs::create_dir_all(root.join("alice/notarepo")).await.unwrap();

        let all = list_all(root).await;
        assert_eq!(
            all,
            vec![
                ("alice".to_string(), "r1".to_string()),
                ("alice".to_string(), "r2".to_string()),
                ("bob".to_string(), "proj".to_string()),
            ]
        );

        let alice = list_owner(root, "alice").await;
        assert_eq!(alice, vec!["r1".to_string(), "r2".to_string()]);

        assert!(repo_exists(root, "bob", "proj").await);
        assert!(!repo_exists(root, "bob", "missing").await);
    }
}