mdbook-utils 0.1.3

//! `mdbook` book building
#![allow(unused)]
use std::path::Path;
use std::process::Command;

use anyhow::anyhow;
use anyhow::Context;
use anyhow::Result;

/// Invokes `mdbook build`.
///
/// Usage example:
///
/// ```rust,ignore
/// println!("Info: building the book...");
/// let res = build_book(&root_path);
/// if let Err(ref e) = res {
///     println!("cargo:warning=ERROR: {}", e);
///     return res;
/// }
/// ```
pub(crate) fn build_book(root_path: &Path) -> Result<()> {
    let output = Command::new("mdbook")
        .args(["build"])
        .current_dir(root_path)
        .output()
        .context("[build_book] Failed to execute `mdbook`. Is it installed?")?; // return if failed to execute process

    // write_log(&output.stdout, &output.stderr)?;

    if !output.status.success() {
        return Err(anyhow!(
            "Book building failed. Status: {}. Output: {}\n{}",
            output.status,
            String::from_utf8(output.stdout)
                .context("[build_book] Failed to read a string from stdout.")?,
            String::from_utf8(output.stderr)
                .context("[build_book] Failed to read a string from stderr.")?
        ));
    }
    Ok(())
}

// // Tell Cargo to rerun the build.rs script, if the .md files
// change.
// See also: https://crates.io/crates/cargo-emit
// fn build_rs_helper() -> Result<()> {
//     let root_path = std::fs::canonicalize("..")
//          .context("[build_rs_helper] Failed to locate the root path on disk.
// Does it exist?")?;     let original_markdown_dir_path =
// root_path.join("src/");     let original_markdown_paths =
// WalkDir::new(original_markdown_dir_path).into_iter()
//         .map(|p| p.unwrap().path().to_string_lossy().into_owned())
// // DirEntry to String         .filter(|p| p.ends_with(".md"))
//         .collect::<Vec<_>>();

//     for path in original_markdown_paths {
//         println!("cargo:rerun-if-changed={}", path);
//         // println!("cargo:warning=DEBUG:{}", path);
//     }

//     Ok(())
// }

#[cfg(test)]
mod test {
    // use super::*;

    // #[test]
    // fn test() {
    // }
}