CRYST...ERAGE(1)

🎀 CRYST...ERAGE(1) — crystal-tool-macro_code_coverage 🎀

okay so bestie, welcome to the Crystal Compiler Command Line Reference Guide ✨ this little page is all about crystal-tool-macro_code_coverage, one of the tools tucked inside your Crystal compiler, and honestly? it's giving "niche but iconic" 💅

---

🌸 NAME 🌸

crystal-tool-macro_code_coverage — literally generates a macro code coverage report. that's it. that's the whole vibe. 🦋

---

✨ SYNOPSIS ✨

crystal tool macro_code_coverage [options] [programfile]

short, sweet, slays 🫶

---

💖 DESCRIPTION 💖

So here's the tea ☕ — this tool generates a macro code coverage report and outputs it to STDERR. Yes, STDERR, not STDOUT, stay with me here 👀 and also? any exception that gets raised while it's computing the report goes to STDOUT instead. so the channels are a little swapped, no cap — output on STDERR, exceptions on STDOUT. that's just how it is, don't @ me 💀

---

👑 OPTIONS 👑

here's the full lineup, no skips, no cuts, we don't do that here 💜

• -D FLAG, --define=FLAG — defines a compile-time flag ✨ this is lowkey so useful because it lets you conditionally define types, methods, or commands depending on which flags are available at compile time. the default flags come from the target triple you passed with --target-triple, or from the host's default if you didn't give one at all 🌈
• -f FORMAT, --format=FORMAT — picks the output format. the one and only option: codecov, and yes it's the default 💅
• -i PATH, --include=PATH — includes a path in the output 🎀
• -e PATH, --exclude=PATH — excludes a path in the output. default is lib 👀
• --error-trace — shows the full error trace, i.e. the whole receipts trail when something goes wrong 😭
• --prelude — specifies the prelude to use. the default one initializes the garbage collector 🗑️✨ you can also go --prelude=empty to use no preludes at all — genuinely handy for checking code generation for a specific source code file 🔥
• -s, --stats — prints statistics about the different compiler stages for the current build. that means output time and used memory for each compiler process, so you can be nosy about where your resources went 🕵️‍♀️
• -p, --progress — prints statistics about the progress for the current build 📈
• -t, --time — prints statistics about the execution time ⏱️
• --no-color — disables colored output 🚫🌈 (sad, but sometimes you need it, respect)

---

ngl bestie, remember the channel situation: the report itself lands on STDERR, and any exception raised while computing it lands on STDOUT. that's not a typo, that's just the lore 💀💖

---

and that's the whole page, you ate it up fr fr 👑 this was crystal 1.22.2, dated 2026-10-30 — mwah, drink some water, and go generate some coverage 🍓🧚💜