.TH JANET-PM 1
.SH "نام (NAME)"
janet-pm \- مدیر پروژه و ابزار ساخت برای زبان Janet
.SH "خلاصه دستور (SYNOPSIS)"
.B janet-pm
[\fB\-\-flag ...\fR]
[\fB\-\-option=value ...\fR]
.IR command
.IR args ...

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

.SH "مستندات (DOCUMENTATION)"

.SH "دستورات سراسری (GLOBAL COMMANDS)"

.TP
.BR help
نمایش این متن راهنما.

.TP
.BR install\ [\fBrepo...\fR]
نصب بسته‌های راه دور و تمامی وابستگی‌های مورد نیاز.

.TP
.BR clear-cache
پاک‌سازی حافظه پنهان وابستگی‌های ذخیره‌شده راه دور.

.TP
.BR list-pkgs\ [\fBsearch\fR]
فهرست کردن بسته‌ها در فهرست بسته‌های راه دور که شامل رشته جستجو هستند. اگر هیچ الگوی جستجویی داده نشود، کل فهرست بسته‌ها چاپ می‌شود.

.TP
.BR env\ name
ایجاد یک محیط ایزوله که با آن می‌توان وابستگی‌ها و اسکریپت‌های Janet را به‌صورت تفکیک‌شده و مستقل نصب کرد.

.TP
.BR new-project\ [\fBname\fR]
ایجاد یک پروژه جدید Janet در دایرکتوری
.IR name .

.TP
.BR new-simple-project\ [\fBname\fR]
ایجاد یک پروژه ساده جدید Janet در پوشه
.I name
که می‌تواند بدون نیاز به spork نصب و توزیع شود.

.TP
.BR new-c-project\ [\fBname\fR]
ایجاد یک پروژه جدید ترکیبی C و Janet در دایرکتوری
.IR name .

.TP
.BR new-exe-project\ [\fBname\fR]
ایجاد یک پروژه جدید برای یک فایل اجرایی در دایرکتوری
.IR name .

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

.TP
.BR deps
نصب وابستگی‌های پروژه جاری.

.TP
.BR install\ [\fBrepos...\fR]
نصب آرتیفکت‌های پروژه جاری. معادل میان‌بر برای
.BR "janet \-\-install ."

.TP
.BR uninstall\ [\fBrepos...\fR]
حذف نصب آرتیفکت‌های پروژه جاری. معادل میان‌بر برای
.BR "janet \-\-uninstall {current-project-name}"

.TP
.BR prune
حذف تمام بسته‌هایی که هیچ وابسته‌ای به آن‌ها وجود ندارد و برای حذف خودکار نشانه‌گذاری شده‌اند.

.TP
.BR build
ساخت تمام آرتیفکت‌های پروژه. پیکربندی ساخت توسط
.B JANET_BUILD_TYPE
تعیین می‌شود و محل قرارگیری آرتیفکت‌ها در دایرکتوری
.B JANET_BUILD_DIR
خواهد بود.

.TP
.BR clean
حذف تمام فایل‌ها یا آرتیفکت‌های تولیدشده. این دستور قلاب
.B (clean)
را فراخوانی می‌کند.

.TP
.BR test
اجرای آزمون‌ها. آزمون‌ها باید فایل‌های
.I .janet
در دایرکتوری
.I test/
نسبت به
.I project.janet
باشند. این دستور مسیرهای ماژول را بازنویسی می‌کند تا کدهای بومی کامپایل‌شده بدون نیاز به نصب، بارگذاری شوند. معادل میان‌بر برای
.BR "run check" .

.TP
.BR quickbin\ [\fBentry\fR]\ [\fBoutput\fR]
ایجاد یک فایل اجرایی از یک اسکریپت، به همراه پیوند ایستا (static linking) تمام وابستگی‌های یافت‌شده هنگام کامپایل اسکریپت. اسکریپت باید حاوی یک تابع
.B main
باشد که به عنوان تابع اصلی برای فایل اجرایی تولیدشده عمل کند.

.TP
.BR save-lockfile\ [\fBdestination\fR]
ذخیره تمام بسته‌های نصب‌شده فعلی در یک فایل قفل (lockfile).

.TP
.BR load-lockfile\ [\fBsource\fR]
نصب تمام بسته‌های موجود در فایل قفل داده‌شده.

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

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

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

.B JANET_BUILD_TYPE
.RS
نوع ساختی که هنگام ساخت یک بسته حاوی
.I project.janet
انجام می‌شود. باید یکی از مقادیر
\fB"develop"\fR، \fB"release"\fR یا \fB"debug"\fR
باشد.
.RE

.B JANET_CURL
.RS
محل دریافت دستور
.B curl
هنگام پردازش
.IR project.janet .
مقدار پیش‌فرض
\fB"curl"\fR
است.
.RE

.B JANET_GIT
.RS
محل دریافت دستور
.B git
هنگام پردازش
.IR project.janet .
مقدار پیش‌فرض
\fB"git"\fR
است.
.RE

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

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

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

.B JANET_TAR
.RS
محل دریافت دستور
.BR tar .
مقدار پیش‌فرض
\fB"tar"\fR
است.
.RE

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

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

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