نام (NAME)

dune-init - گروه دستورها برای مقداردهی اولیه مؤلفه‌های Dune

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

dune init project NAME [PATH] [OPTION]...

dune init executable NAME [PATH] [OPTION]...

dune init library NAME [PATH] [OPTION]...

dune init test NAME [PATH] [OPTION]...

dune init start-file [PATH]

توضیحات (DESCRIPTION)

دستور dune init COMPONENT NAME [PATH] [OPTION]... یک پیکربندی dune جدید را برای مؤلفه‌ای از نوع مشخص‌شده توسط زیردستور COMPONENT، با نام NAME و فیلدهایی که توسط OPTIONهای ارائه‌شده تعیین می‌شوند، مقداردهی اولیه می‌کند.

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

اگر آرگومان اختیاری PATH ارائه شود، باید مسیر یک دایرکتوری باشد و مؤلفه در آنجا ایجاد خواهد شد. در غیر این صورت، در دایرکتوری زیرمجموعه‌ای از دایرکتوری کاری فعلی به نام NAME ایجاد می‌شود. برای مقداردهی اولیه یک مؤلفه در دایرکتوری کاری فعلی، از `.` به عنوان PATH استفاده کنید.

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

برای اطلاعات بیشتر، ببینید: https://dune.readthedocs.io/en/stable/usage.html#initializing-components

دستورها (COMMANDS)

executable [OPTION]… NAME [PATH]: یک فایل اجرایی باینری.
library [OPTION]… NAME [PATH]: یک کتابخانه OCaml.
project [OPTION]… NAME [PATH]: یک پروژه ترکیبی از پیش تعریف‌شده از مؤلفه‌ها است که در یک ساختار دایرکتوری استاندارد چیده شده‌اند. نوع پروژهٔ مقداردهی‌شده توسط مقدار پرچم --kind تعیین می‌شود و به طور پیش‌فرض یک پروژه اجرایی است که از یک کتابخانه، یک فایل اجرایی و یک مؤلفه آزمون تشکیل شده است.
start-file [OPTION]… [PATH]: نوشتن فایل استاندارد start/dune.
test [OPTION]… NAME [PATH]: یک بستار آزمون (test harness). (برای آزمون‌های درون‌خطی، از پرچم --inline-tests در کنار سایر انواع مؤلفه‌ها استفاده کنید.)

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

--help[=FMT] (پیش‌فرض=auto): نمایش این راهنما در قالب FMT. مقدار FMT باید یکی از auto، pager، groff یا plain باشد. با انتخاب auto، هرگاه متغیر محیطی TERM برابر با dumb یا تعریف‌نشده باشد، قالب به صورت pager یا plain خواهد بود.
--version: نمایش اطلاعات نسخه.

وضعیت خروج (EXIT STATUS)

dune init با این مقادیر خارج می‌شود:

0: در صورت موفقیت.
1: در صورت بروز خطا.
130: اگر توسط یک سیگنال متوقف شود.

مثال‌ها (EXAMPLES)

1.: تولید ساختار اولیه یک پروژه برای یک فایل اجرایی به نام `myproj` در دایرکتوری جدیدی با نام `myproj`، وابسته به کتابخانه bos و با استفاده از آزمون‌های درون‌خطی همراه با ppx_inline_test:

dune init project myproj --libs bos --ppx ppx_inline_test --inline-tests

2.: پیکربندی یک مؤلفه اجرایی به نام `myexe` در یک فایل dune در دایرکتوری فعلی:

dune init executable myexe

3.: پیکربندی یک مؤلفه کتابخانه به نام `mylib` در یک فایل dune در دایرکتوری ./src وابسته به کتابخانه‌های core و cmdliner، پیش‌پردازنده‌های ppx_let و ppx_inline_test، و تعریف‌شده برای استفاده از آزمون‌های درون‌خطی:

dune init library mylib src --libs core,cmdliner --ppx ppx_let,ppx_inline_test --inline-tests

4.: پیکربندی یک مؤلفه آزمون به نام `mytest` در یک فایل dune در دایرکتوری ./test که به `mylib` وابسته است:

dune init test mytest test --libs mylib

5.: نوشتن فایل کمکی استاندارد `start/dune`:

dune init start-file

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

dune(1)