italic 0.2.4

A static site generator for your digital garden
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

//! Watch mode: rebuild on every change to a source path or `config.yaml`.
//!
//! Per spec §2, v1 is full-rebuild only — `watch` is a debounced loop around
//! [`crate::build::run`]. Errors raised during a rebuild are logged and the
//! watcher keeps running; only watcher-setup errors propagate out of [`run`].

use crate::config::Config;
use anyhow::Result;
use notify_debouncer_mini::{new_debouncer, notify::RecursiveMode};
use std::path::{Path, PathBuf};
use std::sync::mpsc;
use std::time::{Duration, Instant};

const DEBOUNCE: Duration = Duration::from_millis(150);

pub fn run() -> Result<()> {
    // Build once up front so the output is ready before we start watching. A
    // failed build is logged (by `rebuild`) but doesn't stop us from watching.
    let _ = rebuild();
    watch_loop(|_| {})
}

/// Watch the source dirs and rebuild on change. The `on_rebuild` callback
/// fires after each rebuild attempt with its `Result`, so callers (e.g.
/// `serve`) can react to success/failure — broadcasting a reload only on `Ok`,
/// for instance.
///
/// This is purely the watch loop: it does *not* build once up front. Callers
/// own the initial build, because they disagree on how to handle its failure —
/// `watch` logs and keeps watching, `serve` aborts startup (`build::run()?`).
pub fn watch_loop<F>(mut on_rebuild: F) -> Result<()>
where
    F: FnMut(&Result<()>),
{
    let (config, _) = Config::load_with_theme(Path::new("config.yaml"))?;
    let (tx, rx) = mpsc::channel();
    let mut debouncer = new_debouncer(DEBOUNCE, tx)?;

    // Watch both overlay layers: the `*_roots` helpers expand to the theme's
    // subdir (when configured) and the site's, so a change to either a theme file
    // or a site override triggers a rebuild. Content and data stay site-only.
    let mut dirs: Vec<PathBuf> = vec![config.content_dir.clone(), config.data_dir.clone()];
    dirs.extend(config.template_roots());
    dirs.extend(config.archive_roots());
    dirs.extend(config.static_roots());
    for dir in &dirs {
        if dir.exists() {
            debouncer.watcher().watch(dir, RecursiveMode::Recursive)?;
        }
    }
    let config_path = Path::new("config.yaml");
    if config_path.exists() {
        debouncer
            .watcher()
            .watch(config_path, RecursiveMode::NonRecursive)?;
    }

    eprintln!("watching for changes…");

    for batch in rx {
        match batch {
            Ok(_) => {
                let result = rebuild();
                on_rebuild(&result);
            }
            Err(e) => eprintln!("watch error: {e}"),
        }
    }
    Ok(())
}

fn rebuild() -> Result<()> {
    let start = Instant::now();
    // watch (and serve, which drives this loop) is the local preview, so drafts
    // are always included.
    let result = crate::build::run(true);
    match &result {
        Ok(()) => eprintln!("rebuilt in {:?}", start.elapsed()),
        Err(e) => eprintln!("build failed: {e:#}"),
    }
    result
}