نام (NAME)

dub - سامانه مدیریت بسته و ساخت برای زبان D

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

dub [--version] [COMMAND] [OPTIONS...] -- [APPLICATION ARGUMENTS...]

توضیحات (DESCRIPTION)

پروژه DUB را در دایرکتوری جاری مدیریت می‌کند. DUB می‌تواند هم به عنوان یک سامانه ساخت و هم یک مدیر بسته عمل کند و به‌طور خودکار وابستگی‌های پروژه را پیگیری نماید - هم آن‌ها را دانلود کرده و هم به برنامه پیوند زند.

دستورها (COMMANDS)

init

یک بسته خالی از نوع مشخص‌شده در دایرکتوری داده‌شده ایجاد می‌کند. به‌طور پیش‌فرض، از دایرکتوری کاری جاری استفاده می‌شود.

الگوهای سفارشی را می‌توان توسط بسته‌ها با ارائه یک زیربسته به نام «init-exec» تعریف کرد. در این حالت هیچ فایل منبع پیش‌فرضی اضافه نمی‌شود. زیربسته «init-exec» پس از ایجاد دایرکتوری پایه پروژه، در داخل دایرکتوری مقصد کامپایل و اجرا می‌شود. آرگومان‌های آزاد «dub init -t custom -- free args» به عنوان آرگومان‌های برنامه به زیربسته «init-exec» ارسال می‌شوند.

run

یک بسته را می‌سازد و اجرا می‌کند (به‌طور پیش‌فرض از بسته اصلی در دایرکتوری کاری جاری استفاده می‌کند).

build

یک بسته را می‌سازد (به‌طور پیش‌فرض از بسته اصلی در دایرکتوری کاری جاری استفاده می‌کند).

test

بسته را می‌سازد و تمام آزمون‌های واحد (unit tests) موجود را اجرا می‌کند.

اگر هیچ پیکربندی صریحی مشخص نشده باشد، یک پیکربندی موجود به نام «unittest» برای آزمایش ترجیح داده می‌شود. اگر وجود نداشته باشد، اولین پیکربندی از نوع کتابخانه استفاده خواهد شد، و اگر آن هم وجود نداشته باشد، اولین پیکربندی اجرایی انتخاب می‌شود.

هنگامی که یک فایل اصلی سفارشی (--main-file) مشخص شود، فقط می‌توان از پیکربندی‌های نوع کتابخانه استفاده کرد. در غیر این صورت، بسته به نوع پیکربندی انتخاب‌شده، یا از یک فایل اصلی موجود استفاده می‌شود (که باید به درستی تنظیم شده باشد تا فقط آزمون‌های واحد را برای 'version(unittest)' اجرا کند)، یا DUB یک فایل اصلی برای پیکربندی‌های نوع کتابخانه تولید خواهد کرد.

در نهایت، اگر بسته شامل وابستگی به بسته «tested» باشد، فایل اصلی که به‌طور خودکار تولید شده است از آن برای اجرای آزمون‌های واحد استفاده خواهد کرد.

lint

بسته را می‌سازد و آزمون‌های لینتر D-Scanner را اجرا می‌کند.

generate

فایل‌های پروژه را با استفاده از یکی از مولدهای پشتیبانی‌شده تولید می‌کند:

visuald - فایل‌های پروژه VisualD

sublimetext - فایل پروژه SublimeText

cmake - اسکریپت‌های ساخت CMake

build - بسته را مستقیماً می‌سازد

یک نام بسته اختیاری می‌تواند مشخص شود تا بسته‌ای غیر از بسته ریشه/دایرکتوری جاری تولید گردد.

describe

یک توصیف ساخت 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

clean

این دستور هرگونه فایل ساخت ذخیره‌شده در حافظه پنهان بسته(های) مشخص‌شده را حذف می‌کند. فایل هدف نهایی و همچنین هرگونه copyFiles در حال حاضر حذف نمی‌شوند.

بدون آرگومان، بسته موجود در دایرکتوری کاری جاری پاک‌سازی خواهد شد.

dustmite

این دستور از ابزار Dustmite برای جداسازی علت خطاهای ساخت در یک پروژه DUB استفاده می‌کند.

یک رونوشت از تمام بسته‌های درگیر ایجاد کرده و dustmite را روی این رونوشت اجرا می‌کند و یک نمونه آزمایشی کاهش‌یافته بر جای می‌گذارد.

تعیین شرایط خطای مورد نظر با بررسی کد وضعیت کامپایلر/پیونددهنده و همچنین خروجی آن‌ها (ترکیب stdout و stderr) انجام می‌شود. اگر --program-status یا --program-regex مشخص شده باشد و باینری تولیدشده یک فایل اجرایی باشد، اجرا شده و خروجی آن نیز در تصمیم نهایی لحاظ خواهد شد.

fetch

هنگامی که با یک یا چند آرگومان اجرا شود، بدون توجه به مکانی که در آن اجرا می‌شود، بسته‌های منطبق با آرگومان(ها) را دریافت می‌کند.

مثال‌ها:

$ dub fetch vibe-d

$ dub fetch vibe-d@v0.9.0 --cache=local --recursive

هنگامی که در یک پروژه بدون هیچ آرگومانی اجرا شود، تمام وابستگی‌های آن پروژه را دریافت می‌کند. اگر پروژه دارای وابستگی‌های تعیین‌شده نباشد (نبود «dub.selections.json»)، فرآیند حل وابستگی را نیز انجام می‌دهد.

مثال:

$ cd myProject && dub fetch

توجه داشته باشید که دستورهای «build» و «run» و هر دستور دیگری که به بسته‌ها نیاز دارد، به‌طور خودکار fetch را انجام می‌دهند؛ بنابراین به‌طور کلی نیازی به اجرای این دستور قبل از سایر دستورها نیست.

add

بسته‌های <packages> را به عنوان وابستگی اضافه می‌کند.

اجرای «dub add <package>» معادل اضافه کردن <package> به بخش «dependencies» در dub.json/dub.sdl است. اگر نسخه‌ای برای یکی از بسته‌ها مشخص نشده باشد، dub مخزن را برای یافتن آخرین نسخه بررسی می‌کند.

remove

بسته‌ای را که در سامانه محلی ذخیره شده است حذف می‌کند.

upgrade

تمام وابستگی‌های بسته را با پرس‌وجو از مخزن(های) بسته برای دریافت نسخه‌های جدید ارتقا می‌دهد.

این کار نسخه‌های ذخیره‌شده در فایل انتخاب‌ها (dub.selections.json) را به همین ترتیب به‌روزرسانی می‌کند.

اگر یک یا چند نام بسته مشخص شود، فقط همان وابستگی‌ها ارتقا خواهند یافت. در غیر این صورت، تمام وابستگی‌های مستقیم و غیرمستقیم بسته ریشه ارتقا می‌یابند.

add-path

یک مسیر جستجوی پیش‌فرض برای بسته‌ها اضافه می‌کند. تمام زیرپوشه‌های مستقیم این مسیر برای توصیف‌های بسته جستجو شده و به عنوان بسته در دسترس قرار خواهند گرفت. استفاده از این دستور اثری معادل فراخوانی دستی «dub add-local» روی تک‌تک زیرپوشه‌ها دارد.

هر بسته‌ای که با استفاده از add-path ثبت شود، هنگام جستجوی وابستگی‌ها در حین عملیات ساخت نسبت به بسته‌های دانلودشده از مخزن بسته در اولویت قرار خواهد گرفت.

نسخه بسته‌ها بر اساس یکی از موارد زیر تعیین می‌شود:

- برای نسخه‌های کاری GIT، آخرین برچسب (git describe) جهت تعیین نسخه به کار می‌رود

- اگر بسته شامل فیلد «version» در توصیف بسته باشد، از آن استفاده می‌شود

- اگر هیچ‌کدام اعمال نشود، «~master» فرض می‌شود

remove-path

مسیر جستجوی بسته‌ای را که قبلاً با add-path اضافه شده بود حذف می‌کند.

add-local

یک دایرکتوری بسته محلی را برای استفاده در هنگام حل وابستگی اضافه می‌کند. این دستور برای ثبت بسته‌های محلی مفید است، مانند نسخه‌های کاری GIT که در مخزن بسته موجود نیستند یا قرار است بازنویسی شوند.

نسخه بسته یا به‌طور خودکار تعیین می‌شود (دستور «add-path» را ببینید) یا می‌توان با مشخص کردن نسخه در خط فرمان آن را به صراحت بازنویسی کرد.

برای روشی جهت ثبت هم‌زمان چندین بسته محلی، «dub add-path -h» را ببینید.

remove-local

یک دایرکتوری بسته محلی را حذف می‌کند.

list

فهرستی از تمام بسته‌های محلی یا بسته‌های انتخاب‌شده را چاپ می‌کند. این شامل تمام بسته‌های ذخیره‌شده در حافظه پنهان (در سطح کاربر یا کل سامانه)، تمام بسته‌های موجود در مسیرهای جستجوی بسته («dub add-path») و تمام بسته‌های ثبت‌شده به صورت دستی («dub add-local») است. اگر یک بسته (و به صورت اختیاری مشخصه نسخه) تعیین شود، فقط بسته‌های منطبق نمایش داده می‌شوند.

search

تمام ارائه‌دهندگان مشخص‌شده را برای یافتن بسته‌های منطبق جستجو می‌کند.

add-override

این دستور منسوخ شده است. برای دستیابی به همان نتیجه، از وابستگی مبتنی بر مسیر (path based dependency)، مسیر حافظه پنهان سفارشی، یا ویرایش «dub.selections.json» استفاده کنید.

remove-override

این دستور منسوخ شده است. برای دستیابی به همان نتیجه، از وابستگی مبتنی بر مسیر، مسیر حافظه پنهان سفارشی، یا ویرایش «dub.selections.json» استفاده کنید.

list-overrides

این دستور منسوخ شده است. برای دستیابی به همان نتیجه، از وابستگی مبتنی بر مسیر، مسیر حافظه پنهان سفارشی، یا ویرایش «dub.selections.json» استفاده کنید.

clean-caches

این دستور هرگونه فراداده ذخیره‌شده در حافظه پنهان مانند فهرست بسته‌های موجود و آخرین نسخه آن‌ها را حذف می‌کند.

convert

این دستور فایل‌های دستورالعمل ساخت بسته با قالب JSON و SDLang را به یکدیگر تبدیل می‌کند.

هشدار: توجه داشته باشید که هرگونه قالب‌بندی و کامنت درون دستورالعمل ساخت بسته در طی فرآیند تبدیل از بین خواهد رفت.

گزینه‌های عمومی (COMMON OPTIONS)

-h, --help

--root=VALUE

--recipe=VALUE

--registry=VALUE

--skip-registry=VALUE

--annotate

--bare

-v, --verbose

--vverbose

-q, --quiet

--verror

--vquiet

--color=VALUE

--cache=VALUE

فایل‌ها (FILES)

dub.sdl, dub.json

نویسندگان (AUTHORS)

حق نشر (c) ۱۹۹۹-۲۰۲۶ متعلق به The D Language Foundation است.

مستندات برخط (ONLINE DOCUMENTATION)

http://code.dlang.org/docs/commandline

همچنین ببینید (SEE ALSO)

dmd(1), rdmd(1), dub-init(1), dub-run(1), dub-build(1), dub-test(1), dub-lint(1), dub-generate(1), dub-describe(1), dub-clean(1), dub-dustmite(1), dub-fetch(1), dub-add(1), dub-remove(1), dub-upgrade(1), dub-add-path(1), dub-remove-path(1), dub-add-local(1), dub-remove-local(1), dub-list(1), dub-search(1), dub-add-override(1), dub-remove-override(1), dub-list-overrides(1), dub-clean-caches(1), dub-convert(1)