docusaurus 0.0.0-alpha.1

Drop-in Docusaurus CLI with Rust-native config (docusaurus.config.rs)
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

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

use tempfile::NamedTempFile;

use crate::error::DocusaurusError;

/// Locate the `node` binary via PATH.
pub fn find_node() -> Result<PathBuf, DocusaurusError> {
    Ok(which::which("node")?)
}

/// Walk up from `site_dir` until a `node_modules/docusau-rs` directory is found,
/// then return the path to the `.node` addon inside it.
pub fn find_addon(site_dir: &Path) -> Result<PathBuf, DocusaurusError> {
    let addon_name = addon_filename();
    let mut dir = site_dir.to_path_buf();
    loop {
        let candidate = dir
            .join("node_modules")
            .join("docusau-rs")
            .join(&addon_name);
        if candidate.exists() {
            return Ok(candidate);
        }
        match dir.parent() {
            Some(parent) => dir = parent.to_path_buf(),
            None => return Err(DocusaurusError::AddonNotFound),
        }
    }
}

fn addon_filename() -> String {
    if cfg!(target_os = "windows") {
        "docusau_rs.win32-x64-msvc.node".to_string()
    } else if cfg!(target_os = "macos") {
        if cfg!(target_arch = "aarch64") {
            "docusau_rs.darwin-arm64.node".to_string()
        } else {
            "docusau_rs.darwin-x64.node".to_string()
        }
    } else if cfg!(target_arch = "aarch64") {
        "docusau_rs.linux-arm64-gnu.node".to_string()
    } else {
        "docusau_rs.linux-x64-gnu.node".to_string()
    }
}

/// Write `config_json` into a temporary `.js` file as a `module.exports` assignment.
///
/// The returned `NamedTempFile` **must** be kept alive for as long as the path is in use;
/// the file is deleted when the handle drops.
pub fn write_temp_config(config_json: &str) -> Result<(NamedTempFile, PathBuf), DocusaurusError> {
    use std::io::Write as _;

    // JSON already contains double-quotes; embed using backtick template literal
    // so neither single- nor double-quote escaping is needed. Only backticks and
    // backslashes inside the JSON itself need escaping.
    let escaped = config_json.replace('\\', r"\\").replace('`', r"\`");
    let js_content = format!("module.exports = JSON.parse(`{escaped}`);\n");

    let mut file = tempfile::Builder::new().suffix(".js").tempfile()?;
    file.write_all(js_content.as_bytes())?;
    file.flush()?;

    let path = file.path().to_path_buf();
    Ok((file, path))
}