neural/rune/cli/banner.rs

rust
ฯ€ 0.0% 469 words ยท 3 min 
//! The rune banner and help text โ€” matched to hemera's CLI aesthetic:
//! a gradient ASCII-art mark, a white tagline, a gray spec block, and an
//! aligned command list.

const R: &str = "\x1b[31m"; // red
const Y: &str = "\x1b[33m"; // yellow
const G: &str = "\x1b[32m"; // green
const C: &str = "\x1b[36m"; // cyan
const B: &str = "\x1b[34m"; // blue
const M: &str = "\x1b[35m"; // magenta
const W: &str = "\x1b[37m"; // white
const GR: &str = "\x1b[90m"; // gray
const X: &str = "\x1b[0m"; // reset

/// Colour `s` with `col` when `color`, else return it plain.
fn paint(color: bool, col: &str, s: &str) -> String {
    if color {
        format!("{col}{s}{X}")
    } else {
        s.to_string()
    }
}

/// The colored rune mark + tagline + spec block.
pub fn banner(color: bool) -> String {
    let line = |col: &str, s: &str| paint(color, col, s);
    let mut o = String::new();
    o.push('\n');
    o.push_str(&line(R, "    โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—\n"));
    o.push_str(&line(Y, "    โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ•—  โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•\n"));
    o.push_str(&line(G, "    โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—  \n"));
    o.push_str(&line(C, "    โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ•  \n"));
    o.push_str(&line(B, "    โ–ˆโ–ˆโ•‘  โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘ โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—\n"));
    o.push_str(&line(M, "    โ•šโ•โ•  โ•šโ•โ• โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ•  โ•šโ•โ•โ•โ•โ•šโ•โ•โ•โ•โ•โ•โ•\n"));
    o.push_str(&line(W, "    the robot scripting language\n"));
    o.push('\n');
    o.push_str(&line(GR, "    Nox ยท 18-pattern tree reduction ยท Goldilocks field\n"));
    o.push_str(&line(GR, "    two registers (classic + pure) ยท one AST ยท instant start\n"));
    o
}

/// The command list shown by `rune help`.
pub fn help(color: bool) -> String {
    let g = |s: &str| paint(color, GR, s);
    let mut o = banner(color);
    o.push('\n');
    o.push_str("  rune                        start the REPL\n");
    o.push_str("  rune eval [--pure] <expr>   evaluate one expression\n");
    o.push_str("  rune run <file>             interpret a program\n");
    o.push_str("  rune fmt [--to=โ€ฆ] <file>    format between registers (rust | rune)\n");
    o.push_str("  rune check <file>           type-check (mold) without running\n");
    o.push('\n');
    o.push_str(&g("  rune help                   print this help\n"));
    o.push_str(&g("  rune --version              print version\n"));
    o
}

/// The categorized help shown by `:help` inside the REPL.
pub fn repl_help(color: bool) -> String {
    let head = |s: &str| paint(color, W, s);
    let g = |s: &str| paint(color, GR, s);
    let mut o = String::new();

    o.push_str(&head("  commands\n"));
    o.push_str(&g("    :help               this list\n"));
    o.push_str(&g("    :env                show bound names\n"));
    o.push_str(&g("    :nox  <expr>        the Nox formula <expr> lowers to\n"));
    o.push_str(&g("    :type <expr>        mold-check <expr>\n"));
    o.push_str(&g("    :ast  <expr>        the parsed AST\n"));
    o.push_str(&g("    :load <file>        run a file into the session\n"));
    o.push_str(&g("    :reset              clear bindings\n"));
    o.push_str(&g("    :quit               leave  (Ctrl-D)\n"));
    o.push('\n');

    o.push_str(&head("  builtins\n"));
    o.push_str(&g("    text anno error log button col    prysm chunks\n"));
    o.push_str(&g("    emit query link seal subscribe    acts\n"));
    o.push_str(&g("    add sub mul lt gt                 arithmetic\n"));
    o.push('\n');

    o.push_str(&head("  editing\n"));
    o.push_str(&g("    โ†‘ โ†“ history    Ctrl-R search    Tab complete\n"));
    o.push_str(&g("    multi-line continues while ( [ or \" stay open\n"));
    o.push('\n');

    o.push_str(&head("  examples\n"));
    o.push_str(&g("    let x = 5           bind a name (persists for later lines)\n"));
    o.push_str(&g("    x * 2               evaluate against the bindings\n"));
    o.push_str(&g("    col(text(\"a\"), error(\"b\"))\n"));
    o
}

Graph