just(1) General Commands Manual just(1)

just - ابزاری کارآمد برای اجرای دستورها - https://github.com/casey/just

just [--alias-style] [--allow-missing] [--ceiling] [--check] [--chooser] [--clear-shell-args] [--color] [--command-color] [--complete-aliases] [--cygpath] [--default-list] [--dotenv-command] [-F|--dotenv-filename] [-E|--dotenv-path] [-n|--dry-run] [--dump-format] [--evaluate-format] [--explain] [-g|--global-justfile] [--group] [--highlight] [--indentation] [--jobs] [-f|--justfile] [--justfile-name] [--list-heading] [--list-prefix] [--list-submodules] [--no-aliases] [--no-cache] [--no-deps] [--no-dotenv] [--no-highlight] [--one] [-q|--quiet] [--set] [--shell] [--shell-arg] [--shell-command] [--changelog] [--choose] [--clean] [-c|--command] [--completions] [--dump] [-e|--edit] [--evaluate] [--fmt] [--groups] [--init] [--json] [-l|--list] [--man] [-s|--show] [--summary] [--usage] [--variables] [--tempdir] [--time] [--timestamp] [--timestamp-format] [-u|--unsorted] [--unstable] [-v|--verbose]... [-d|--working-directory] [--yes] [-h|--help] [-V|--version] [ARGUMENTS]

ابزاری ساده و کارآمد برای اجرای دستورها - https://github.com/casey/just

تعیین شیوه نمایش نام‌های مستعار (alias) در دستور list

مقادیر ممکن:

  • left
  • right
  • separate
نادیده گرفتن خطاهای ناشی از نبود دستورالعمل (recipe) یا ماژول
هنگام جستجو برای justfile از دایرکتوری <CEILING> بالاتر نرود.
اجرای `--fmt` در حالت 'check'. اگر justfile به درستی قالب‌بندی شده باشد با کد 0 خارج می‌شود. در صورت نیاز به قالب‌بندی، با کد 1 خارج شده و تغییرات (diff) را چاپ می‌کند.
بازنویسی و جایگزینی فایل باینری فراخوانی‌شده توسط `--choose`
پاک‌سازی آرگومان‌های شل (shell)
چاپ خروجی رنگی

مقادیر ممکن:

  • always
  • auto
  • never
نمایش خطوط دستورالعمل با رنگ <COMMAND-COLOR>

مقادیر ممکن:

  • black
  • blue
  • cyan
  • green
  • purple
  • red
  • yellow
تکمیل خودکار نام‌های مستعار دستورالعمل‌ها
استفاده از فایل باینری موجود در <CYGPATH> برای تبدیل مسیرها بین یونیکس و ویندوز
فهرست کردن دستورالعمل‌ها در صورت مشخص نشدن آرگومان
اجرای <COMMAND> و بارگذاری خروجی آن به عنوان یک فایل متغیرهای محیطی
جستجو برای فایل متغیرهای محیطی با نام <DOTENV-FILENAME> به جای `.env`
بارگذاری مستقیم <DOTENV-PATH> به عنوان فایل متغیرهای محیطی به جای جستجو به دنبال آن
چاپ کارهایی که just انجام خواهد داد بدون اجرای واقعی آن‌ها
خروجی گرفتن از justfile در قالب <FORMAT>

مقادیر ممکن:

  • json
  • just
چاپ متغیرهای ارزیابی‌شده در قالب <FORMAT>

مقادیر ممکن:

  • just
  • shell
چاپ توضیحات مستنداتی دستورالعمل پیش از اجرای آن
استفاده از justfile سراسری
تنها فهرست کردن دستورالعمل‌های موجود در <GROUP>
برجسته‌سازی خطوط چاپ‌شده‌ی دستورالعمل به صورت پررنگ (bold)
ایجاد تورفتگی در بدنه دستورالعمل‌ها با <INDENTATION>
اجرای حداکثر <N> دستورالعمل دارای مشخصه [parallel] به صورت هم‌زمان
استفاده از <JUSTFILE> به عنوان justfile یا `-` برای خواندن از ورودی استاندارد
جستجو برای justfile با نام <NAME>؛ مقادیر متعددی که با `,` جدا شده باشند را می‌پذیرد و می‌تواند تکرار شود
] چاپ <TEXT> پیش از فهرست
چاپ <TEXT> پیش از هر مورد در فهرست
فهرست کردن دستورالعمل‌های موجود در زیرماژول‌ها
عدم نمایش نام‌های مستعار در فهرست
نادیده گرفتن حافظه موقت (cache) دستورالعمل‌ها
اجرا نکردن وابستگی‌های دستورالعمل
بارگذاری نکردن فایل `.env`
عدم نمایش پررنگ (bold) خطوط چاپ‌شده‌ی دستورالعمل
ممنوع کردن فراخوانی بیش از یک دستورالعمل در خط فرمان
بی‌صدا کردن تمامی خروجی‌ها
بازنویسی مقدار <VARIABLE> با <VALUE>
فراخوانی <SHELL> برای اجرای دستورالعمل‌ها
فراخوانی شل با آرگومان <SHELL-ARG>
فراخوانی <COMMAND> با شلی که برای اجرای خطوط دستورالعمل و backtickها استفاده می‌شود
ذخیره فایل‌های موقت در <TEMPDIR>.
چاپ مدت زمان اجرای دستورالعمل
چاپ برچسب زمانی (timestamp) دستورات در دستورالعمل
رشته قالب‌بندی برچسب زمانی
بازگرداندن موارد فهرست و خلاصه بر اساس ترتیب فایل مبدأ
فعال‌سازی ویژگی‌های ناپایدار (unstable)
استفاده از خروجی پرجزئیات
استفاده از <WORKING-DIRECTORY> به عنوان دایرکتوری کاری. --justfile نیز باید تنظیم شود
تأیید خودکار تمامی دستورالعمل‌ها.
چاپ راهنما
چاپ نسخه
[ARGUMENTS]
مقادیر جایگزین و دستورالعمل(هایی) که باید اجرا شوند؛ در حالت پیش‌فرض اولین دستورالعمل موجود در justfile اجرا می‌شود

چاپ تاریخچه تغییرات (changelog)
انتخاب یک یا چند دستورالعمل برای اجرا با استفاده از یک انتخاب‌گر باینری. در صورت مشخص نشدن `--chooser`، انتخاب‌گر به مقدار $JUST_CHOOSER و در غیر این صورت به `fzf` بازمی‌گردد
پاک‌سازی حافظه موقت (cache) دستورالعمل‌ها، با قابلیت محدودسازی به دستورالعمل‌هایی که مسیر آن‌ها با <RECIPE_PATH> آغاز می‌شود
اجرای یک دستور دلخواه با اعمال دایرکتوری کاری، فایل `.env`، مقادیر جایگزین و متغیرهای export شده
چاپ اسکریپت تکمیل خودکار شل برای <SHELL>

مقادیر ممکن:

  • bash
  • elvish
  • fish
  • nushell
  • powershell
  • zsh
چاپ محتوای justfile
ویرایش justfile با ویرایشگری که توسط $VISUAL یا $EDITOR مشخص شده است، و در صورت عدم تعیین با استفاده از `vim`
ارزیابی و چاپ تمامی متغیرها. اگر نام یک متغیر به عنوان آرگومان داده شود، تنها مقدار همان متغیر چاپ می‌شود.
قالب‌بندی و بازنویسی justfile
فهرست کردن گروه‌های دستورالعمل
ایجاد یک justfile جدید در ریشه پروژه
چاپ justfile در قالب JSON
فهرست کردن دستورالعمل‌های در دسترس در <MODULE>، یا ریشه در صورت مشخص نشدن آن
چاپ صفحه راهنما (man page)
نمایش دستورالعمل در مسیر <RECIPE_PATH>
فهرست کردن نام‌های دستورالعمل‌های در دسترس
چاپ اطلاعات نحوه استفاده از دستورالعمل در مسیر <RECIPE_PATH>
فهرست کردن نام‌های متغیرها

v1.58.0

Casey Rodarmor <casey@rodarmor.com>

just 1.58.0