DUB-DESCRIBE(1) The D Language Foundation DUB-DESCRIBE(1) نام (NAME) dub-describe - چاپ توصیف JSON از پروژه و وابستگی‌های آن خلاصه دستور (SYNOPSIS) dub describe [[@]] OPTIONS... توضیحات (DESCRIPTION) یک توصیف ساخت JSON برای بستهٔ ریشه و تمام وابستگی‌های آن در قالبی مشابه فایل توصیف بستهٔ JSON چاپ می‌کند. این ویژگی بیشتر برای IDEها مفید است. تمام گزینه‌های معمول که برای build/run/generate استفاده می‌شوند نیز در اینجا اعمال می‌شوند. هنگامی که --data=VALUE مشخص شود، به جای آن تنظیمات ساخت مشخصی برای یک پروژه چاپ خواهد شد (به طور پیش‌فرض، برای کامپایلر فعلی قالب‌بندی می‌شود). گزینهٔ --data=VALUE می‌تواند چندین بار برای بازیابی چند بخش از اطلاعات به طور هم‌زمان مشخص شود. یک فهرست جداشده با کاما نیز قابل قبول است (برای مثال: --data=dflags,libs). داده‌ها با همان ترتیبی که در خط فرمان درخواست شده‌اند در خروجی قرار خواهند گرفت. مقادیر پذیرفته‌شده برای --data=VALUE عبارتند از: main-source-file, dflags, lflags, libs, linker-files, source-files, versions, debug-versions, import-paths, string-import-paths, import- files, options موارد زیر نیز در صورت استفاده از --data-list توسط --data پذیرفته می‌شوند: target-type, target-path, target-name, working-directory, copy-files, string-import-files, pre-generate-commands, post-generate-commands, pre-build-commands, post-build-commands, pre-run-commands, post-run- commands, requirements گزینه‌ها (OPTIONS) --dest=VALUE دایرکتوری پایه‌ای که مصنوعات خروجی در آن قرار خواهند گرفت -b, --build=VALUE نوع ساخت برای اجرا را مشخص می‌کند. توجه داشته باشید که تنظیم متغیر محیطی DFLAGS نوع ساخت را با پرچم‌های سفارشی رونویسی خواهد کرد. نام‌های ممکن: debug, plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, cov-ctfe, unittest-cov, unittest-cov-ctfe, syntax و انواع سفارشی -c, --config=VALUE پیکربندی مشخص‌شده را می‌سازد. پیکربندی‌ها می‌توانند در dub.json تعریف شوند --override-config=VALUE از پیکربندی مشخص‌شده برای یک وابستگی خاص استفاده می‌کند. می‌تواند چندین بار مشخص شود. قالب: --override-config=/ --compiler=VALUE باینری کامپایلر مورد استفاده را مشخص می‌کند (می‌تواند یک مسیر باشد). پیشوندها و پسوندهای دلخواه شناسه‌های زیر شناسایی شده (مانند ldc2 یا dmd-2.063) و با نوع کامپایلر مناسب تطبیق داده می‌شوند: dmd, gdc, ldc, gdmd, ldmd -a, --arch=VALUE اجبار به استفاده از یک معماری متفاوت (مانند x86 یا x86_64) -d, --debug=VALUE شناسهٔ نسخهٔ `debug` مشخص‌شده را هنگام ساخت تعریف می‌کند - می‌تواند چندین بار استفاده شود --d-version=VALUE شناسهٔ `version` مشخص‌شده را هنگام ساخت تعریف می‌کند - می‌تواند چندین بار استفاده شود. با احتیاط استفاده کنید، قدرت زیاد مسئولیت زیادی به همراه دارد! برای نسخه‌های پرکاربرد یا ترکیبی و نسخه‌هایی که وابستگان باید بتوانند از آن‌ها استفاده کنند، در بستهٔ خود پیکربندی ایجاد کنید. --nodeps وابستگی‌های ناموجود را قبل از ساخت حل‌وفصل نمی‌کند --build-mode=VALUE نحوهٔ فراخوانی کامپایلر و پیونددهنده را مشخص می‌کند. مقادیر معتبر: separate (پیش‌فرض), allAtOnce, singleFile --single با نام بسته به عنوان یک نام فایل رفتار می‌کند. فایل باید شامل یک کامنت دستورالعمل بسته باشد. --force-remove گزینهٔ منسوخ‌شده‌ای که کاری انجام نمی‌دهد. --filter-versions [آزمایشی] شناسه‌های نسخه و شناسه‌های نسخهٔ اشکال‌زدایی را فیلتر می‌کند تا کارایی حافظهٔ موقت ساخت بهبود یابد. --import-paths میانبری برای --data=import-paths --data-list --string-import-paths میانبری برای --data=string-import-paths --data-list --data=VALUE صرفاً مقادیر یک تنظیم ساخت خاص را، چه تنها برای این بسته یا به صورت بازگشتی با احتساب تمام وابستگی‌ها، فهرست می‌کند. یک فهرست جداشده با کاما را می‌پذیرد. برای جزئیات بیشتر و گزینه‌های پذیرفته‌شده برای VALUE، به بالا مراجعه کنید. --data-list اطلاعات --data را به جای قالب‌بندی برای خط فرمان کامپایلر، در قالب فهرست (خط‌به‌خط) در خروجی نمایش می‌دهد. --data-0 اطلاعات --data را با استفاده از جداکننده‌های null، به جای فاصله‌ها یا خط‌های جدید خروجی می‌دهد. نتیجه برای مثال با xargs -0 قابل استفاده است. گزینه‌های مشترک (COMMON OPTIONS) به dub(1) مراجعه کنید وضعیت خروج (EXIT STATUS) 0 دستور DUB با موفقیت اجرا شد 1 خطاهای نحوهٔ استفاده، پرچم‌های ناشناخته در خط فرمان 2 بسته پیدا نشد، بارگیری بسته ناموفق بود، خطای متفرقه فایل‌ها (FILES) dub.sdl, dub.json نویسندگان (AUTHORS) Copyright (c) 1999-2026 by The D Language Foundation مستندات برخط (ONLINE DOCUMENTATION) http://code.dlang.org/docs/commandline همچنین ببینید (SEE ALSO) dub(1), dub-generate(1) The D Language Foundation 2026-08-16 DUB-DESCRIBE(1)