arcature-cli 2026.1.0

Developer lifecycle CLI for Arcature applications.
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

//! File-writing helper for the `arc make` generators.
//!
//! Centralizes the write-or-fail behavior: create parent directories, refuse
//! to overwrite existing files, write content. Each generator produces a
//! `GeneratedFile` and this module handles the filesystem mechanics.

use std::path::Path;

/// A file to be written by a generator: its destination path and content.
pub(crate) struct GeneratedFile {
    pub path: std::path::PathBuf,
    pub content: String,
}

/// Write a generated file, refusing to overwrite an existing file. Creates
/// parent directories as needed. Returns a short status message.
pub(crate) fn write_file(file: &GeneratedFile) -> Result<String, String> {
    super::naming::ensure_missing(&file.path)?;
    if let Some(parent) = file.path.parent() {
        std::fs::create_dir_all(parent)
            .map_err(|e| format!("cannot create directory {}: {e}", parent.display()))?;
    }
    std::fs::write(&file.path, &file.content)
        .map_err(|e| format!("cannot write {}: {e}", file.path.display()))?;
    Ok(format!("created {}", file.path.display()))
}

/// The module directory's `mod.rs` path for a given module name.
pub(crate) fn module_mod_rs(root: &Path, module: &str) -> std::path::PathBuf {
    root.join("src").join(module).join("mod.rs")
}