.TH DUB-TEST 1 "2026-08-16" "The D Language Foundation" "The D Language Foundation"
.SH "نام (NAME)"
dub-test \- اجرای آزمون‌های بستهٔ انتخاب‌شده
.SH "خلاصه دستور (SYNOPSIS)"
\fBdub test \fR[<\fIpackage\fR>[@<\fIversion-spec\fR>]] \fIOPTIONS\&.\&.\&.\fR
[\-\- <\fIapplication arguments\&.\&.\&.\fR>]
.SH "توضیحات (DESCRIPTION)"
بسته را می‌سازد و تمامی آزمون‌های واحد (unit tests) موجود در آن را اجرا می‌کند.
.PP
اگر هیچ پیکربندی مشخصی ارائه نشود، پیکربندی موجود «unittest» برای آزمون ترجیح داده خواهد شد. در صورتی که چنین پیکربندی‌ای وجود نداشته باشد، اولین پیکربندی از نوع کتابخانه (library) استفاده می‌شود، و اگر آن هم وجود نداشته باشد، اولین پیکربندی قابل‌اجرا (executable) انتخاب خواهد شد.
.PP
هنگامی که یک فایل اصلی سفارشی (\-\-main\-file) مشخص شده باشد، تنها می‌توان از پیکربندی‌های کتابخانه استفاده کرد. در غیر این صورت، بسته به نوع پیکربندی انتخاب‌شده، یا از یک فایل اصلی موجود استفاده می‌شود (که باید به‌درستی تنظیم شده باشد تا تنها آزمون‌های واحد را برای «version(unittest)» اجرا کند)، یا DUB یک فایل اصلی برای پیکربندی‌های از نوع کتابخانه تولید خواهد کرد.
.PP
در نهایت، اگر بسته شامل وابستگی به بستهٔ «tested» باشد، فایل اصلیِ تولیدشده به‌صورت خودکار از آن برای اجرای آزمون‌های واحد استفاده خواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-temp\-build\fR
.RS 4
در صورت امکان، پروژه را با استفاده از فایل‌های موقت می‌سازد.
.RE
.PP
\fB\-\-main\-file\fR=\fIVALUE\fR
.RS 4
یک فایل سفارشی حاوی تابع main() را برای اجرای آزمون‌ها مشخص می‌کند.
.RE
.PP
\fB\-\-combined\fR
.RS 4
تلاش می‌کند تا کل پروژه را در یک‌بار اجرای کامپایلر بسازد.
.RE
.PP
\fB\-\-parallel\fR
.RS 4
در صورت امکان، کامپایلر را با چندین ریسه (thread) اجرا می‌کند.
.RE
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
کامپایل مجدد را اجبار می‌کند، حتی اگر مقصد به‌روز باشد.
.RE
.PP
\fB\-\-coverage\fR
.RS 4
تولید آمار پوشش کد را فعال می‌کند.
.RE
.PP
\fB\-\-coverage\-ctfe\fR
.RS 4
تولید آمار پوشش کد (شامل CTFE) را فعال می‌کند.
.RE
.PP
\fB\-\-dest\fR=\fIVALUE\fR
.RS 4
دایرکتوری پایه‌ای که مصنوعات خروجی در آن قرار خواهند گرفت.
.RE
.PP
\fB\-b\fR, \fB\-\-build\fR=\fIVALUE\fR
.RS 4
نوع ساخت جهت انجام را مشخص می‌کند. توجه داشته باشید که تنظیم متغیر محیطی DFLAGS، نوع ساخت را با پرچم‌های سفارشی بازنویسی خواهد کرد.
نام‌های ممکن:
  debug, plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, cov-ctfe, unittest-cov, unittest-cov-ctfe, syntax و پروفایل‌های سفارشی
.RE
.PP
\fB\-c\fR, \fB\-\-config\fR=\fIVALUE\fR
.RS 4
پیکربندی مشخص‌شده را می‌سازد. پیکربندی‌ها را می‌توان در dub.json تعریف کرد.
.RE
.PP
\fB\-\-override\-config\fR=\fIVALUE\fR
.RS 4
از پیکربندی مشخص‌شده برای یک وابستگی خاص استفاده می‌کند. می‌تواند چندین بار مشخص شود.
قالب: \-\-override\-config=<dependency>/<config>
.RE
.PP
\fB\-\-compiler\fR=\fIVALUE\fR
.RS 4
فایل باینری کامپایلر مورد استفاده را مشخص می‌کند (می‌تواند یک مسیر باشد).
پیشوندها و پسوندهای دلخواه برای شناسه‌های زیر شناسایی شده (مانند ldc2 یا dmd-2.063) و با نوع کامپایلر مناسب تطبیق داده می‌شوند:
  dmd, gdc, ldc, gdmd, ldmd
.RE
.PP
\fB\-a\fR, \fB\-\-arch\fR=\fIVALUE\fR
.RS 4
معماری متفاوتی را اجبار می‌کند (مانند x86 یا x86_64).
.RE
.PP
\fB\-d\fR, \fB\-\-debug\fR=\fIVALUE\fR
.RS 4
شناسهٔ نسخهٔ «debug» مشخص‌شده را هنگام ساخت تعریف می‌کند \- می‌تواند چندین بار استفاده شود.
.RE
.PP
\fB\-\-d\-version\fR=\fIVALUE\fR
.RS 4
شناسهٔ «version» مشخص‌شده را هنگام ساخت تعریف می‌کند \- می‌تواند چندین بار استفاده شود.
با احتیاط استفاده کنید؛ قدرت زیاد مسئولیت بزرگ به همراه دارد! برای نسخه‌های پرکاربرد یا به‌اشتراک‌گذاشته‌شده و نسخه‌هایی که سایر بسته‌ها باید بتوانند مشخص کنند، در عوض از پیکربندی‌های بسته استفاده کنید.
.RE
.PP
\fB\-\-nodeps\fR
.RS 4
وابستگی‌های مفقود را پیش از ساخت تفکیک نمی‌کند.
.RE
.PP
\fB\-\-build\-mode\fR=\fIVALUE\fR
.RS 4
نحوهٔ فراخوانی کامپایلر و پیونددهنده را مشخص می‌کند. مقادیر معتبر:
  separate (پیش‌فرض), allAtOnce, singleFile
.RE
.PP
\fB\-\-single\fR
.RS 4
نام بسته را به عنوان نام فایل در نظر می‌گیرد. فایل باید حاوی توضیح دستورالعمل بسته باشد.
.RE
.PP
\fB\-\-force\-remove\fR
.RS 4
گزینهٔ منسوخ‌شده‌ای که هیچ کاری انجام نمی‌دهد.
.RE
.PP
\fB\-\-filter\-versions\fR
.RS 4
[آزمایشی] شناسه‌های نسخه و شناسه‌های نسخهٔ اشکال‌زدایی را فیلتر می‌کند تا کارایی حافظهٔ نهان ساخت را بهبود بخشد.
.RE
.SS "گزینه‌های عمومی (COMMON OPTIONS)"
\fBdub\fR(1) را ببینید
.SH "وضعیت خروج (EXIT STATUS)"
.TP
.BR 0
عملیات DUB با موفقیت انجام شد
.TP
.BR 1
خطاهای نحوه استفاده، گزینه‌های ناشناخته خط فرمان
.TP
.BR 2
بسته پیدا نشد، بارگذاری بسته ناموفق بود، خطای متفرقه
.SH "فایل‌ها (FILES)"
\fIdub\&.sdl\fR, \fIdub\&.json\fR
.SH "نویسندگان (AUTHORS)"
حق نشر \(co ۱۹۹۹\-۲۰۲۶ متعلق به The D Language Foundation است
.SH "مستندات برخط (ONLINE DOCUMENTATION)"
.UR http://code.dlang.org/docs/commandline
http://code.dlang.org/docs/commandline
.UE
.SH "همچنین ببینید (SEE ALSO)"
\fBdub\fR(1), \fBdub-build\fR(1), \fBdub-dustmite\fR(1), \fBdub-lint\fR(1), \fBdub-run\fR(1)