نام (NAME)

dub-describe - چاپ توصیف JSON از پروژه و وابستگی‌های آن

خلاصه دستور (SYNOPSIS)

dub describe [<package>[@<version-spec>]] 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=<dependency>/<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 قابل استفاده است.