نام (NAME)

janet-pm - مدیر پروژه و ابزار ساخت برای زبان Janet

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

janet-pm [--flag ...] [--option=value ...] command args...

توضیحات (DESCRIPTION)

جهت انجام عملیات روی یک پروژه، این دستور را از داخل پوشه‌ای که حاوی فایل project.janet است اجرا کنید؛ یا برای انجام عملیات روی حافظه پنهان سراسری ماژول‌ها (modpath)، آن را از هر کجای سیستم فراخوانی نمایید. دستوراتی که به مجوز نوشتن روی modpath نیاز دارند، دستورات ممتاز (دارای دسترسی ویژه) محسوب می‌شوند و در برخی محیط‌ها ممکن است به دسترسی‌های مدیر سیستم (کاربر ارشد) نیاز داشته باشند. سایر دستورات در سطح پروژه نیازمند وجود فایل ./project.janet در دایرکتوری جاری هستند.

مستندات (DOCUMENTATION)

دستورات سراسری (GLOBAL COMMANDS)

help: نمایش این متن راهنما.
install [repo...]: نصب بسته‌های راه دور و تمامی وابستگی‌های مورد نیاز.
clear-cache: پاک‌سازی حافظه پنهان وابستگی‌های ذخیره‌شده راه دور.
list-pkgs [search]: فهرست کردن بسته‌ها در فهرست بسته‌های راه دور که شامل رشته جستجو هستند. اگر هیچ الگوی جستجویی داده نشود، کل فهرست بسته‌ها چاپ می‌شود.
env name: ایجاد یک محیط ایزوله که با آن می‌توان وابستگی‌ها و اسکریپت‌های Janet را به‌صورت تفکیک‌شده و مستقل نصب کرد.
new-project [name]: ایجاد یک پروژه جدید Janet در دایرکتوری name.
new-simple-project [name]: ایجاد یک پروژه ساده جدید Janet در پوشه name که می‌تواند بدون نیاز به spork نصب و توزیع شود.
new-c-project [name]: ایجاد یک پروژه جدید ترکیبی C و Janet در دایرکتوری name.
new-exe-project [name]: ایجاد یک پروژه جدید برای یک فایل اجرایی در دایرکتوری name.

دستورات ویژه پروژه (PER-PROJECT COMMANDS)

deps: نصب وابستگی‌های پروژه جاری.
install [repos...]: نصب آرتیفکت‌های پروژه جاری. معادل میان‌بر برای janet --install .
uninstall [repos...]: حذف نصب آرتیفکت‌های پروژه جاری. معادل میان‌بر برای janet --uninstall {current-project-name}
prune: حذف تمام بسته‌هایی که هیچ وابسته‌ای به آن‌ها وجود ندارد و برای حذف خودکار نشانه‌گذاری شده‌اند.
build: ساخت تمام آرتیفکت‌های پروژه. پیکربندی ساخت توسط JANET_BUILD_TYPE تعیین می‌شود و محل قرارگیری آرتیفکت‌ها در دایرکتوری JANET_BUILD_DIR خواهد بود.
clean: حذف تمام فایل‌ها یا آرتیفکت‌های تولیدشده. این دستور قلاب (clean) را فراخوانی می‌کند.
test: اجرای آزمون‌ها. آزمون‌ها باید فایل‌های .janet در دایرکتوری test/ نسبت به project.janet باشند. این دستور مسیرهای ماژول را بازنویسی می‌کند تا کدهای بومی کامپایل‌شده بدون نیاز به نصب، بارگذاری شوند. معادل میان‌بر برای run check.
quickbin [entry] [output]: ایجاد یک فایل اجرایی از یک اسکریپت، به همراه پیوند ایستا (static linking) تمام وابستگی‌های یافت‌شده هنگام کامپایل اسکریپت. اسکریپت باید حاوی یک تابع main باشد که به عنوان تابع اصلی برای فایل اجرایی تولیدشده عمل کند.
save-lockfile [destination]: ذخیره تمام بسته‌های نصب‌شده فعلی در یک فایل قفل (lockfile).
load-lockfile [source]: نصب تمام بسته‌های موجود در فایل قفل داده‌شده.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

دستور janet-pm تمام متغیرهای محیطی مورد استفاده توسط janet و همچنین برخی از متغیرهای اختصاصی خود را به ارث می‌برد. بسیاری از این متغیرها تنها برای پشتیبانی از ساخت بسته‌هایی استفاده می‌شوند که از project.janet بهره می‌برند.

JANET_BUILD_DIR

محل ایجاد خروجی‌های ساخت هنگام ساخت بسته‌ای که دارای project.janet است. مقدار پیش‌فرض آن _build است.

JANET_BUILD_TYPE

نوع ساختی که هنگام ساخت یک بسته حاوی project.janet انجام می‌شود. باید یکی از مقادیر "develop"، "release" یا "debug" باشد.

JANET_CURL

محل دریافت دستور curl هنگام پردازش project.janet. مقدار پیش‌فرض "curl" است.

JANET_GIT

محل دریافت دستور git هنگام پردازش project.janet. مقدار پیش‌فرض "git" است.

JANET_OFFLINE

اگر روی 1، true، on و غیره تنظیم شود، فقط بسته‌های موجود در حافظه پنهان محلی بررسی خواهند شد.

JANET_PKGLIST

مخزن فهرست بسته‌ها که برای یافتن نام‌های مستعار بسته‌ها به کار می‌رود. مقدار پیش‌فرض آن https://github.com/janet-lang/pkgs.git است.

JANET_PREFIX

مسیری که زنجیره ابزار POSIX در آن به دنبال هدرهای Janet و فایل libjanet.a می‌گردد. به‌طور پیش‌فرض، با جستجو در syspath، متغیر محیطی PREFIX، مسیر /usr/ و /usr/local به‌صورت خودکار شناسایی می‌شود. در اکثر موارد نیازی به تنظیم این متغیر نیست، اما در غیر این صورت باید برابر با همان مقداری قرار گیرد که PREFIX هنگام نصب janet روی آن تنظیم شده بود.

JANET_TAR

محل دریافت دستور tar. مقدار پیش‌فرض "tar" است.

JANET_TOOLCHAIN

نام زنجیره ابزار (toolchain) مورد استفاده برای کامپایل کدهای بومی مبتنی بر project.janet. باید یکی از مقادیر "gcc"، "clang"، "msvc" یا "cc" باشد. به‌طور پیش‌فرض بر اساس حضور سایر متغیرهای محیطی MSVC، GCC، CLANG و CC به‌صورت خودکار شناسایی می‌شود. در نهایت، پیش‌فرض آن همان کامپایلری خواهد بود که برای کامپایل فایل اجرایی janet مجری این اسکریپت استفاده شده است؛ یعنی همان خروجی دستور janet -e '(print (os/compiler))'.

VERBOSE

چاپ خروجی کامل حاصل از اجرای دستورات.

WORKERS

تعداد پردازش‌هایی که هنگام کامپایل کدهای منبع C و ++C به‌صورت موازی اجرا می‌شوند.