'\" t
.\"     Title: crystal-tool-macro_code_coverage
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-07-23
.\"    Manual: Crystal Compiler Command Line Reference Guide
.\"    Source: crystal 1.21.0
.\"  Language: English
.\"
.TH "CRYSTAL\-TOOL\-MACRO_CODE_COVERAGE" "1" "2026-07-23" "crystal 1.21.0" "Crystal Compiler Command Line Reference Guide"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
crystal-tool-macro_code_coverage \- generate a macro code coverage report.
.SH "SYNOPSIS"
.sp
\fBcrystal tool macro_code_coverage\fP [options] [programfile]
.SH "DESCRIPTION"
.sp
Generate and output a macro code coverage report to STDERR.
Any exception raised while computing the report is written to STDOUT.
.SH "OPTIONS"
.sp
\fB\-D\fP \fIFLAG\fP, \fB\-\-define\fP=\fIFLAG\fP
.RS 4
Define a compile\-time flag. This is useful to con    ditionally define types, methods, or commands based
on flags available at compile time. The default
flags are from the target triple given with \fB\-\-tar\fP     get\-triple or the hosts default, if none is given.
.RE
.sp
\fB\-f\fP \fIFORMAT\fP, \fB\-\-format\fP=\fIFORMAT\fP
.RS 4
Output format \*(Aqcodecov\*(Aq (default).
.RE
.sp
\fB\-i\fP \fIPATH\fP, \fB\-\-include\fP=\fIPATH\fP
.RS 4
Include path in output.
.RE
.sp
\fB\-e\fP \fIPATH\fP, \fB\-\-exclude\fP=\fIPATH\fP
.RS 4
Exclude path in output (default: lib).
.RE
.sp
\fB\-\-error\-trace\fP
.RS 4
Show full error trace.
.RE
.sp
\fB\-\-prelude\fP
.RS 4
Specify prelude to use. The default one initializes
the garbage collector. You can also use \fB\-\-pre\fP     lude=empty to use no preludes. This can be useful
for checking code generation for a specific source
code file.
.RE
.sp
\fB\-s\fP, \fB\-\-stats\fP
.RS 4
Print statistics about the different compiler stages for the current build. Output time and used memory for each compiler
process.
.RE
.sp
\fB\-p\fP, \fB\-\-progress\fP
.RS 4
Print statistics about the progress for the current build.
.RE
.sp
\fB\-t\fP, \fB\-\-time\fP
.RS 4
Print statistics about the execution time.
.RE
.sp
\fB\-\-no\-color\fP
.RS 4
Disable colored output.
.RE