'\" 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 \- ایجاد گزارش پوشش کد ماکرو.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcrystal tool macro_code_coverage\fP [options] [programfile]
.SH "توضیحات (DESCRIPTION)"
.sp
تولید و ارسال گزارش پوشش کد ماکرو به STDERR.
هرگونه استثنای (exception) رخ‌داده هنگام محاسبه گزارش در STDOUT نوشته می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-D\fP \fIFLAG\fP, \fB\-\-define\fP=\fIFLAG\fP
.RS 4
تعریف یک فلگ زمان کامپایل. این گزینه برای تعریف شرطی انواع، متدها یا دستورات بر اساس فلگ‌های موجود در زمان کامپایل مفید است. فلگ‌های پیش‌فرض از سه‌گانه هدف (target triple) مشخص‌شده با \fB\-\-target\-triple\fP یا در صورت عدم تعیین، از مقادیر پیش‌فرض میزبان گرفته می‌شوند.
.RE
.sp
\fB\-f\fP \fIFORMAT\fP, \fB\-\-format\fP=\fIFORMAT\fP
.RS 4
قالب خروجی \*(Aqcodecov\*(Aq (پیش‌فرض).
.RE
.sp
\fB\-i\fP \fIPATH\fP, \fB\-\-include\fP=\fIPATH\fP
.RS 4
گنجاندن مسیر در خروجی.
.RE
.sp
\fB\-e\fP \fIPATH\fP, \fB\-\-exclude\fP=\fIPATH\fP
.RS 4
مستثنی کردن مسیر در خروجی (پیش‌فرض: lib).
.RE
.sp
\fB\-\-error\-trace\fP
.RS 4
نمایش ردیابی کامل خطا (error trace).
.RE
.sp
\fB\-\-prelude\fP
.RS 4
تعیین prelude مورد استفاده. گزینه پیش‌فرض، جمع‌آوری‌کننده زباله (garbage collector) را مقداردهی اولیه می‌کند. همچنین می‌توانید از \fB\-\-prelude=empty\fP برای استفاده نکردن از مقدمه‌ها بهره ببرید. این مورد می‌تواند برای بررسی تولید کد در یک فایل سورس‌کد خاص مفید باشد.
.RE
.sp
\fB\-s\fP, \fB\-\-stats\fP
.RS 4
چاپ آمار مراحل مختلف کامپایلر برای ساخت فعلی. زمان خروجی و حافظه مصرفی برای هر فرآیند کامپایلر.
.RE
.sp
\fB\-p\fP, \fB\-\-progress\fP
.RS 4
چاپ آمار پیشرفت ساخت فعلی.
.RE
.sp
\fB\-t\fP, \fB\-\-time\fP
.RS 4
چاپ آمار مربوط به زمان اجرا.
.RE
.sp
\fB\-\-no\-color\fP
.RS 4
غیرفعال کردن خروجی رنگی.
.RE