orbit-md 0.1.0

Fast static site generator with React-like Markdown components
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

//! Parallel disk writer for rendered HTML pages.

use std::fs;
use std::path::Path;

use rayon::prelude::*;

use crate::error::PageError;
use crate::models::RenderedPage;

/// Writes all rendered pages to disk in parallel.
///
/// Parent directories are created as needed. Each write is independent, so
/// no global lock serializes the hot path.
pub fn write_all(pages: &[RenderedPage]) -> Result<(), PageError> {
    pages.par_iter().try_for_each(write_one)
}

fn write_one(page: &RenderedPage) -> Result<(), PageError> {
    if let Some(parent) = page.output_path.parent() {
        fs::create_dir_all(parent).map_err(|err| {
            PageError::new(
                &page.output_path,
                format!("failed to create directory: {err}"),
            )
        })?;
    }

    // NOTE: single write call — OS page cache handles streaming; no extra buffer.
    fs::write(&page.output_path, page.html.as_bytes()).map_err(|err| {
        PageError::new(
            &page.output_path,
            format!("failed to write HTML output: {err}"),
        )
    })
}

/// Ensures the output directory exists before compilation begins.
pub fn prepare_output_dir(path: &Path) -> Result<(), PageError> {
    fs::create_dir_all(path)
        .map_err(|err| PageError::new(path, format!("failed to create output directory: {err}")))
}

/// Removes and recreates the output directory for clean builds.
pub fn clean_output_dir(path: &Path) -> Result<(), PageError> {
    if path.exists() {
        fs::remove_dir_all(path).map_err(|err| {
            PageError::new(path, format!("failed to clean output directory: {err}"))
        })?;
    }
    prepare_output_dir(path)
}