drft/builders/
frontmatter.rs

1//! The `frontmatter` builder: emits link edges from frontmatter link-target
2//! values, plus the parsed frontmatter block as metadata on the file it read.
3//! It is colocated — its metadata is about its own file — so its drift rides the
4//! file's `fs` hash; it contributes no hash of its own.
5
6use globset::GlobSet;
7
8use crate::builders::link_edges;
9use crate::model::{Graph, Node};
10use crate::parsers::Parser;
11use crate::parsers::frontmatter::FrontmatterParser;
12
13/// Build the `frontmatter` graph fragment from text files, labeled `label`.
14/// `filter` scopes which paths the builder reads (`None` reads all). The
15/// fragment carries edges plus a node per file whose frontmatter parses to an
16/// object.
17pub fn build(label: &str, texts: &[(String, String)], filter: Option<GlobSet>) -> Graph {
18    let parser = FrontmatterParser {
19        file_filter: filter,
20    };
21    let mut graph = Graph::labeled(label);
22
23    for (path, content) in texts {
24        if !parser.matches(path) {
25            continue;
26        }
27        let result = parser.parse(path, content);
28
29        if let Some(serde_json::Value::Object(block)) = result.metadata {
30            graph.set_node(path.clone(), Node::new(block));
31        }
32
33        for edge in link_edges(path, &result.links) {
34            graph.add_edge(edge);
35        }
36    }
37
38    graph.sort_edges();
39    graph
40}
41
42#[cfg(test)]
43mod tests {
44    use super::*;
45
46    fn texts(pairs: &[(&str, &str)]) -> Vec<(String, String)> {
47        pairs
48            .iter()
49            .map(|(p, c)| (p.to_string(), c.to_string()))
50            .collect()
51    }
52
53    #[test]
54    fn emits_metadata_and_edges() {
55        let t = texts(&[(
56            "analysis.md",
57            "---\ntitle: Analysis\nstatus: draft\nsources:\n  - ./data/notes.md\n---\n\n# Body\n",
58        )]);
59        let graph = build("frontmatter", &t, None);
60        assert_eq!(graph.label.as_deref(), Some("frontmatter"));
61
62        let meta = &graph.nodes["analysis.md"].metadata;
63        assert_eq!(meta["title"], serde_json::json!("Analysis"));
64        assert_eq!(meta["status"], serde_json::json!("draft"));
65
66        let targets: Vec<&str> = graph.edges.iter().map(|e| e.target.as_str()).collect();
67        assert_eq!(targets, vec!["data/notes.md"]);
68    }
69
70    #[test]
71    fn no_node_without_frontmatter() {
72        let t = texts(&[("plain.md", "# Just a heading\n")]);
73        let graph = build("frontmatter", &t, None);
74        assert!(graph.nodes.is_empty());
75        assert!(graph.edges.is_empty());
76    }
77}
drft/builders/frontmatter.rs

drft/builders/
frontmatter.rs
