hyalo-cli 0.7.1

CLI for exploring and managing Markdown knowledge bases with YAML frontmatter
Documentation
use assert_cmd::Command;
use std::fs;
use std::path::Path;

/// Strip the leading newline from a raw string so the content aligns at column 0.
macro_rules! md {
    ($s:expr) => {
        $s.strip_prefix('\n').unwrap_or($s)
    };
}
#[allow(unused_imports)]
pub(crate) use md;

/// Returns a `Command` pre-configured to run the `hyalo` binary built by Cargo.
#[allow(dead_code)]
pub fn hyalo() -> Command {
    Command::cargo_bin("hyalo").unwrap()
}

/// Returns a `Command` pre-configured to run `hyalo` with `--no-hints`.
///
/// Use this in tests that verify plain (non-wrapped) JSON output and do not
/// test hint behaviour. Hints are on by default in the built-in config, so
/// without `--no-hints` the output would be wrapped in a hints envelope.
#[allow(dead_code)]
pub fn hyalo_no_hints() -> Command {
    let mut cmd = Command::cargo_bin("hyalo").unwrap();
    cmd.arg("--no-hints");
    cmd
}

/// Writes a file at `relative_path` inside `dir`, creating parent directories as needed.
pub fn write_md(dir: &Path, relative_path: &str, content: &str) {
    let full = dir.join(relative_path);
    if let Some(parent) = full.parent() {
        fs::create_dir_all(parent).unwrap();
    }
    fs::write(full, content).unwrap();
}

/// Write a markdown file with YAML frontmatter containing the given tags.
/// Used by tag-related tests and any future tests that need pre-tagged files.
#[allow(dead_code)]
pub fn write_tagged(dir: &Path, name: &str, tags: &[&str]) {
    let tags_yaml = if tags.is_empty() {
        "tags: []\n".to_owned()
    } else {
        let items = tags.iter().fold(String::new(), |mut s, t| {
            use std::fmt::Write as _;
            let _ = writeln!(s, "  - {t}");
            s
        });
        format!("tags:\n{items}")
    };
    write_md(
        dir,
        name,
        &format!("---\ntitle: {name}\n{tags_yaml}---\n# Body\n"),
    );
}

/// Returns a sample markdown document with YAML frontmatter containing various property types.
#[allow(dead_code)]
pub fn sample_frontmatter() -> &'static str {
    md!(r#"
---
title: My Note
priority: 3
draft: true
created: "2026-03-20"
updated: "2026-03-20T14:30:00"
tags:
  - rust
  - cli
---
# Body

Some content here.
"#)
}