kissreplace

KISS template engine for @VAR@ placeholders.

A minimal, zero-macro template engine that replaces @VARIABLE@ patterns in strings and paths. Designed for build tools, code generators, and configuration templating where simplicity matters.

Features

• Simple syntax: @VAR_NAME@ placeholders, nothing more
• Type-safe: Uses HashMap<String, String> — no proc macros, no DSL
• Path-aware: Replace variables in file/directory names, not just file contents
• Graceful degradation: Unknown or invalid variables are preserved as-is
• Optional async: Async API available behind the async feature flag

Quick Start

Add to your dependencies:

cargo add kissreplace

Basic usage:

use kissreplace::{KissReplace, Variables};

let mut vars = Variables::new();
vars.insert("PROJECT".to_string(), "my_app".to_string());
vars.insert("VERSION".to_string(), "0.1.0".to_string());

let result = vars.replace_str("crate @PROJECT@ v@VERSION@");
assert_eq!(result, "crate my_app v0.1.0");

// Works with paths too:
let paths = vars.replace_paths(vec![
    std::path::PathBuf::from("src/@PROJECT@/lib.rs"),
]);

Documentation

Full API reference and advanced usage examples are available in the book.

License

MIT OR Apache-2.0