hearth-graph 0.2.0

Standalone tree-sitter symbol index and module graph with injectable languages
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

//! Filesystem-backed [`SourceLoader`] — the only module that touches
//! `std::fs`, so the build driver itself stays free of ambient I/O.

use std::path::PathBuf;

use crate::build::SourceLoader;

/// Filesystem-backed source loader rooted at one directory.
pub struct FsLoader {
    root: PathBuf,
}

impl FsLoader {
    /// Creates a loader that resolves every source path relative to `root`.
    pub fn new(root: impl Into<PathBuf>) -> Self {
        Self { root: root.into() }
    }
}

impl SourceLoader for FsLoader {
    fn verify(&self) -> Result<(), String> {
        let metadata = std::fs::metadata(&self.root).map_err(|error| {
            format!(
                "cannot build symbol index: source root '{}' is unavailable: {error}",
                self.root.display()
            )
        })?;
        if !metadata.is_dir() {
            return Err(format!(
                "cannot build symbol index: source root '{}' is not a directory",
                self.root.display()
            ));
        }
        Ok(())
    }

    fn probe(&self, path: &str) -> Option<u64> {
        let metadata = std::fs::metadata(self.root.join(path)).ok()?;
        metadata.is_file().then_some(metadata.len())
    }

    fn load(&self, path: &str) -> Option<String> {
        std::fs::read_to_string(self.root.join(path)).ok()
    }
}