crepuscularity-cli 0.8.0

use std::io;
use std::path::{Path, PathBuf};
use std::process::Command;

use serde_json::json;

use crate::crepus_toml::DocsHookConfig;

#[derive(Debug, Clone, PartialEq, Eq)]
struct DocsHookInvocation {
    program: PathBuf,
    args: Vec<String>,
}

#[derive(Clone, Debug)]
pub(crate) struct DocsHookTheme {
    pub(crate) accent: String,
    pub(crate) accent_soft: String,
    pub(crate) surface: String,
    pub(crate) text: String,
    pub(crate) muted: String,
    pub(crate) border: String,
}

pub(crate) fn docs_src_path(site_dir: &Path, hook: &DocsHookConfig) -> PathBuf {
    let src = hook.src.as_deref().unwrap_or("../docs");
    absolutize(site_dir, src)
}

pub(crate) fn run_docs_hook(
    site_dir: &Path,
    out_docs_dir: &Path,
    hook: &DocsHookConfig,
    site_name: &str,
    theme: &DocsHookTheme,
) -> io::Result<()> {
    let docs_src = docs_src_path(site_dir, hook);
    if !docs_src.is_dir() {
        return Ok(());
    }

    let theme_json = json!({
        "accent": theme.accent,
        "accent_soft": theme.accent_soft,
        "surface": theme.surface,
        "text": theme.text,
        "muted": theme.muted,
        "border": theme.border,
    })
    .to_string();

    let docs_src_arg = docs_src.to_string_lossy().into_owned();
    let out_docs_arg = out_docs_dir.to_string_lossy().into_owned();
    let runtime_args = [
        "--docs-src",
        docs_src_arg.as_str(),
        "--out-dir",
        out_docs_arg.as_str(),
        "--site-name",
        site_name,
        "--theme-json",
        theme_json.as_str(),
    ];
    let invocation = resolve_docs_hook_invocation(site_dir, hook);

    let status = Command::new(&invocation.program)
        .current_dir(site_dir)
        .args(&invocation.args)
        .args(runtime_args)
        .status()?;

    if status.success() {
        Ok(())
    } else {
        Err(io::Error::other(format!("docs hook exited with {status}")))
    }
}

fn resolve_docs_hook_invocation(site_dir: &Path, hook: &DocsHookConfig) -> DocsHookInvocation {
    if let Some(binary) = cargo_run_manifest_binary(site_dir, hook) {
        return DocsHookInvocation {
            program: binary,
            args: Vec::new(),
        };
    }

    DocsHookInvocation {
        program: PathBuf::from(&hook.command),
        args: hook.args.clone(),
    }
}

fn cargo_run_manifest_binary(site_dir: &Path, hook: &DocsHookConfig) -> Option<PathBuf> {
    if hook.command != "cargo" || hook.args.first().map(String::as_str) != Some("run") {
        return None;
    }

    let manifest_idx = hook.args.iter().position(|arg| arg == "--manifest-path")?;
    let manifest_raw = hook.args.get(manifest_idx + 1)?;
    let manifest_path = absolutize(site_dir, manifest_raw);
    let profile = if hook.args.iter().any(|arg| arg == "--release") {
        "release"
    } else {
        "debug"
    };
    let package_name = package_name_from_manifest(&manifest_path)?;
    let binary_name = if cfg!(windows) {
        format!("{package_name}.exe")
    } else {
        package_name
    };
    let binary = manifest_path
        .parent()?
        .join("target")
        .join(profile)
        .join(binary_name);
    binary.is_file().then_some(binary)
}

fn package_name_from_manifest(manifest_path: &Path) -> Option<String> {
    let contents = std::fs::read_to_string(manifest_path).ok()?;
    for line in contents.lines() {
        let trimmed = line.trim();
        if trimmed.starts_with('#') {
            continue;
        }
        if let Some((key, value)) = trimmed.split_once('=') {
            if key.trim() == "name" {
                return Some(value.trim().trim_matches('"').to_string());
            }
        }
    }
    None
}

fn absolutize(base: &Path, raw: &str) -> PathBuf {
    let path = Path::new(raw);
    if path.is_absolute() {
        path.to_path_buf()
    } else {
        let joined = base.join(path);
        std::fs::canonicalize(&joined).unwrap_or(joined)
    }
}

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

    #[test]
    fn resolve_docs_hook_prefers_built_cargo_run_binary() {
        let site_dir = Path::new(env!("CARGO_MANIFEST_DIR"))
            .join("../../docs-site")
            .canonicalize()
            .expect("docs-site");
        let hook = DocsHookConfig {
            command: "cargo".into(),
            args: vec![
                "run".into(),
                "--quiet".into(),
                "--locked".into(),
                "--manifest-path".into(),
                "docs-renderer/Cargo.toml".into(),
                "--".into(),
            ],
            src: Some("../docs".into()),
        };

        let manifest = site_dir.join("docs-renderer/Cargo.toml");
        let package_name = package_name_from_manifest(&manifest).expect("package name");
        let binary_name = if cfg!(windows) {
            format!("{package_name}.exe")
        } else {
            package_name
        };
        let expected_binary = site_dir
            .join("docs-renderer/target/debug")
            .join(binary_name);
        if !expected_binary.is_file() {
            eprintln!("skipping: docs renderer binary not built");
            return;
        }

        let invocation = resolve_docs_hook_invocation(&site_dir, &hook);
        assert_eq!(
            invocation.program,
            expected_binary
                .canonicalize()
                .expect("docs renderer binary")
        );
        assert!(invocation.args.is_empty());
    }

    #[test]
    fn resolve_docs_hook_falls_back_to_configured_command() {
        let hook = DocsHookConfig {
            command: "echo".into(),
            args: vec!["docs".into()],
            src: None,
        };
        let invocation = resolve_docs_hook_invocation(Path::new("."), &hook);
        assert_eq!(invocation.program, PathBuf::from("echo"));
        assert_eq!(invocation.args, vec!["docs".to_string()]);
    }

    #[test]
    fn package_name_from_manifest_reads_package_name() {
        let manifest =
            Path::new(env!("CARGO_MANIFEST_DIR")).join("../../docs-site/docs-renderer/Cargo.toml");
        assert_eq!(
            package_name_from_manifest(&manifest).as_deref(),
            Some("docs_site_renderer")
        );
    }
}