nordisk/znippy

znippy-build-thing/src/emit.rs

//! **znippy's half of the emitter** — `code → toml`, one-directional.
//!
//! The WRITER is `nornir_build_thing::emit` (one writer for every repo's recipe
//! crate, lane AG 2026-08-30); what lives here is this repo's own
//! [`EMITTED_HEADER`] and the three calls. The committed
//! `.nornir/build-variants.toml` is [`emitted_toml`]'s output and nothing else:
//! an edit to it has ZERO effect on what the recipe declares
//! (`tests/toml_parity.rs` measures that), and the only way to change the
//! description is to change the code and re-emit.

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

use anyhow::Result;
use nornir_build_thing::emit;
use nornir_build_thing::plugin::BuildThing;

use crate::recipe::ZnippyBuildThing;

/// The header every emission starts with — says what the file is, and what it
/// is not.
pub const EMITTED_HEADER: &str = "\
# znippy — .nornir/build-variants.toml — EMITTED, NOT SOURCE.
#
# Generated by `cargo run -p znippy-build-thing -- emit` from znippy-build-thing
# (the Rust `impl BuildThing`). The code is the one source; this file DESCRIBES
# the build for readers and for the doors that discover a repo by this path —
# `cargo xtask build --suite ORIGINAL` is `suite_cli` over this file, and
# `dwarves buildthing znippy` comes through the same one. Editing it changes
# NOTHING: re-emit after changing the code. Do not edit by hand.
#
# Model: variant → features → settings/sub-settings → typ. TWO atoms, both
# `role = tool` and both `linkage = not-applicable`: the five-shape ladder is an
# axis about WHERE THE SERVER LIVES, and znippy has no server — it is an archiver
# you run, that exits. See .nornir/build-thing-design.md.";

/// The emission — what `.nornir/build-variants.toml` must contain.
pub fn emitted_toml() -> Result<String> {
    emit::emitted_toml(EMITTED_HEADER, &ZnippyBuildThing)
}

/// Regenerate `<repo_root>/.nornir/build-variants.toml` from the code.
pub fn write_emitted(repo_root: &Path) -> Result<PathBuf> {
    emit::write_emitted(EMITTED_HEADER, &ZnippyBuildThing, repo_root)
}

/// The repo root, from this crate's manifest directory.
#[must_use]
pub fn repo_root() -> PathBuf {
    Path::new(env!("CARGO_MANIFEST_DIR"))
        .parent()
        .expect("znippy-build-thing has 1 ancestor(s)")
        .to_path_buf()
}

/// The set this recipe declares.
#[must_use]
pub fn declared() -> nornir_build_thing::variant::BuildVariantSet {
    ZnippyBuildThing.variants()
}