| NIMBLE(1) | User Commands | NIMBLE(1) |
نام (NAME)
nimble - نصب‌کننده بسته‌های Nim
خلاصه دستور (SYNOPSIS)
nimble [nimbleopts] COMMAND [cmdopts]
توضیحات (DESCRIPTION)
دستورها (Commands):
- install
- [pkgname, ...] فهرستی از بسته‌ها را نصب می‌کند. [-d, --depsOnly] تنها وابستگی‌ها را نصب می‌کند. برای نصب وابستگی‌های
- یک بسته محلی nimble، از ذکر pkgname صرف‌نظر کنید.
- [-p, --passNim]
- پرچم مشخص‌شده را به کامپایلر ارسال می‌کند.
- [--noRebuild ]
- در صورتی که باینری‌ها به‌روز باشند، آن‌ها را دوباره بازسازی نمی‌کند.
- develop
- [pkgname, ...] فهرستی از بسته‌ها را برای توسعه کلون می‌کند.
- در صورت مشخص شدن، آن‌ها را به یک فایل develop و در صورت
- مشخص نشدن و اجرا در دایرکتوری بسته، به `nimble.develop` اضافه می‌کند.
- [--withDependencies]
- وابستگی‌های بسته‌های موجود در فهرست، یا در صورت خالی بودن فهرست، وابستگی‌های بسته دایرکتوری جاری را نیز در حالت توسعه قرار می‌دهد.
- [-p, --path path]
- مسیری را که بسته‌ها باید در آن کلون شوند مشخص می‌کند.
- [-a, --add path]
- بسته‌ای در مسیر ارائه‌شده را به فایل develop مشخص، یا در صورت مشخص نشدن و اجرا در دایرکتوری بسته، به `nimble.develop` اضافه می‌کند.
- [-r, --removePath path]
- بسته‌ای در مسیر ارائه‌شده را از فایل develop مشخص، یا در صورت مشخص نشدن و اجرا در دایرکتوری بسته، از `nimble.develop` حذف می‌کند.
- [-n, --removeName name]
- بسته‌ای با نام ارائه‌شده را از فایل develop مشخص، یا در صورت مشخص نشدن و اجرا در دایرکتوری بسته، از `nimble.develop` حذف می‌کند.
- [-i, --include file]
- یک فایل develop را در فایل develop مشخص، یا در صورت مشخص نشدن و اجرا در دایرکتوری بسته، درون `nimble.develop` می‌گنجاند.
- [-e, --exclude file]
- یک فایل develop را از فایل develop مشخص، یا در صورت مشخص نشدن و اجرا در دایرکتوری بسته، از `nimble.develop` مستثنی می‌کند.
- [-g, --global]
- یک فایل پیوند به سبک قدیمی در دایرکتوری ویژه `links` ایجاد می‌کند. این فایل توسط Nim خوانده می‌شود تا امکان استفاده از بسته‌های حالت توسعه سراسری فراهم گردد. در صورت نبود فایل محلی، Nimble از آن به‌عنوان یک فایل develop سراسری استفاده می‌کند.
- check
- اعتبار بسته موجود در دایرکتوری کاری جاری را بررسی و تأیید می‌کند.
- init
- [pkgname] یک پروژه جدید Nimble را در دایرکتوری جاری مقداردهی
- اولیه می‌کند، یا در صورت ارائه نام، در دایرکتوری جدیدی با همان نام
- ایجاد می‌نماید.
- [--git, --hg]
- یک مخزن git/hg در پروژه جدید nimble ایجاد می‌کند.
- publish
- بسته‌ای را در nim-lang/packages منتشر می‌کند. دایرکتوری کاری جاری باید دایرکتوری سطح بالا (ریشه) بسته Nimble باشد.
- uninstall
- [pkgname, ...] فهرستی از بسته‌ها را حذف می‌کند. [-i, --inclDeps] بسته و بسته(های) وابسته به آن را حذف می‌کند.
- build
- [opts, ...] [bin] بسته‌ای را می‌سازد. گزینه‌ها را به کامپایلر
- Nim ارسال می‌کند.
- clean
- آثار حاصل از ساخت (build artifacts) را پاک‌سازی می‌کند.
- guide
- راهنمای کاربر Nimble را در مرورگر برگزیده شما باز می‌کند.
- add
- بسته‌ها را به وابستگی‌های پروژه شما می‌افزاید.
- run
- [opts, ...] [bin] بسته‌ای را ساخته و اجرا می‌کند.
- اگر چندین باینری تعریف شده باشد، باینری باید پس از هرگونه
- گزینه کامپایل مشخص شود. هرگونه پرچمی پس از باینری یا آرگومان --، هنگام اجرا به باینری ارسال می‌شود.
- c, cc, js
- [opts, ...] f.nim فایلی را در درون یک بسته می‌سازد. گزینه‌ها را
- به کامپایلر Nim ارسال می‌کند.
- test
- آزمون‌ها را کامپایل و اجرا می‌کند.
- [-c, --continue]
- با شکست یک آزمون، اجرای فرایند را متوقف نمی‌کند.
- [opts, ...]
- گزینه‌ها را به کامپایلر Nim ارسال می‌کند.
- doc, doc2
- [opts, ...] f.nim مستندات یک فایل را در درون بسته می‌سازد.
- گزینه‌ها را به کامپایلر Nim ارسال می‌کند.
- refresh
- [url] فهرست بسته‌ها را بازآوری می‌کند. نشانی (URL) فهرست
- بسته‌ها می‌تواند به‌صورت اختیاری مشخص شود.
- search
- pkg/tag بسته مشخص‌شده را جستجو می‌کند. جستجو بر اساس
- برچسب و نام انجام می‌شود.
- [--ver, --version] نگارش بسته را از کارساز دوردست جویا می‌شود.
- list
- همه بسته‌ها را فهرست می‌کند.
- [-i, --installed]
- تمام بسته‌های نصب‌شده را فهرست می‌کند.
- [--ver, --version] نگارش‌های بسته‌ها را نیز نمایش می‌دهد. [-n, --nimbinaries] تمام بسته‌های نصب‌شده را فهرست می‌کند.
- tasks
- وظایف (tasks) مشخص‌شده در فایل Nimble بسته را فهرست می‌کند.
- path
- pkgname ... مسیر مطلق بسته‌های نصب‌شده مشخص‌شده را
- نمایش می‌دهد.
- dump
- [pkgname] اطلاعات بسته Nimble را برای ابزارهای خارجی
- در خروجی نمایش می‌دهد. این آرگومان می‌تواند یک فایل
- .nimble، یک دایرکتوری پروژه یا نام یک بسته نصب‌شده باشد.
- [--ini, --json]
- قالب خروجی را انتخاب می‌کند (پیش‌فرض --ini است). تنها برای اطلاعات بسته اعمال‌پذیر است.
- [--collect]
- تمام بسته‌های موجود در درخت وابستگی بسته داده‌شده را گردآوری کرده و نتیجه را در کنسول نمایش می‌دهد.
- [--solve]
- درخت وابستگی بسته داده‌شده را حل کرده و نتیجه را در کنسول نمایش می‌دهد..TP lock یک فایل قفل (lock file) بسته را تولید کرده یا به‌روزرسانی می‌کند.
- upgrade
- [pkgname, ...] فهرستی از بسته‌ها را در فایل قفل ارتقا می‌دهد.
- deps
- وابستگی‌های بستهٔ جاری را در خروجی نمایش می‌دهد.
- [--tree]
- درخت وابستگی را در خروجی نمایش می‌دهد.
- [--inverted]
- درخت وابستگی معکوس را در خروجی نمایش می‌دهد.
- [--format type]
- قالب خروجی را مشخص می‌کند. تنها قالب پشتیبانی‌شده Json است. تنها برخی از دستورات از آن پشتیبانی می‌کنند.
- sync
- وابستگی‌های حالت develop را با محتوای فایل قفل همگام‌سازی می‌کند.
- [-l, --listOnly]
- تنها بسته‌هایی را که همگام‌سازی نشده‌اند فهرست می‌کند، بدون اینکه واقعاً عملیات همگام‌سازی را انجام دهد.
- setup
- فایل `nimble.paths` شامل مسیرهای فایل‌سیستمی وابستگی‌ها را ایجاد می‌کند. همچنین این فایل مسیرها را در فایل `config.nims` می‌گنجاند تا برای کامپایلر در دسترس قرار گیرند.
- shell
- یک پوسته جدید ایجاد می‌کند که متغیر PATH آن برای در برگرفتن پوشه‌های bin وابستگی‌ها تغییر یافته است.
- shellenv
- مشابه دستور shell، اما اسکریپتی را برای اجرا جهت تغییر متغیرهای محیطی برمی‌گرداند. این گزینه برای استفاده در اسکریپت‌ها در نظر گرفته شده است.
گزینه‌های Nimble (Nimble Options):
- -h, --help
- چاپ این پیام راهنما.
- -v, --version
- چاپ اطلاعات نسخه.
- -y, --accept
- پذیرش تمام اعلان‌های تعاملی.
- -n, --reject
- رد کردن تمام اعلان‌های تعاملی.
- -l, --localdeps
- اجرا در حالت وابستگی‌های محلی پروژه.
- -g, --global
- اجرا در حالت وابستگی‌های سراسری.
- -p, --package
- مشخص می‌کند دستور برای کدام بسته در درخت وابستگی باید اجرا شود. در صورت عدم تعیین، به‌طور پیش‌فرض بر بستهٔ دایرکتوری جاری اعمال می‌شود. در حال حاضر، تنها توسط دستور run استفاده می‌شود و توسط سایرین نادیده گرفته می‌شود.
- -t, --tarballs
- فعال‌سازی بارگیری بسته‌ها به‌صورت تاربال (tarball) هنگام کار با مخازن GitHub.
- --ver
- پرس‌وجو از سرور راه دور برای دریافت اطلاعات نسخهٔ بسته هنگام جستجو یا فهرست کردن بسته‌ها.
- --nimbleDir:dirname
- تنظیم دایرکتوری Nimble.
- --nim:path
- استفاده از مسیر مشخص‌شده برای کامپایلر Nim.
- --silent
- پنهان کردن تمام خروجی‌های Nimble و Nim.
- --info
- نمایش برخی خروجی‌های اطلاعاتی.
- --verbose
- نمایش خروجی‌های اضافی غیر دیباگ.
- --debug
- نمایش تمام خروجی‌ها از جمله پیام‌های اشکال‌زدایی.
- --offline
- عدم استفاده از شبکه.
- --noColor
- عدم استفاده از رنگ در خروجی.
- --noSslCheck
- عدم بررسی گواهی‌های SSL.
- --lockFile
- بازنویسی نام فایل قفل.
- --noLockfile
- نادیده گرفتن فایل قفل در صورت وجود.
- --developFile
- نام فایل develop که باید تغییر داده شود را مشخص می‌کند. در صورت عدم وجود، آن را ایجاد می‌کند.
- --useSystemNim
- استفاده از nim سیستم و نادیده گرفتن nim ذکرشده در فایل قفل (در صورت وجود).
- --solver:sat|legacy
- استفاده از حل‌کنندهٔ SAT (پیش‌فرض) یا legacy برای حل وابستگی‌ها.
- --requires
- افزودن بسته‌های بیشتر به حل وابستگی‌ها. از همان نحو فایل Nimble استفاده می‌کند. مثال: nimble install --requires "pkg1; pkg2 >= 1.2".
- --disableNimBinaries
- غیرفعال کردن استفاده از باینری‌های از پیش کامپایل‌شدهٔ nim. توجه داشته باشید که در برخی سیستم‌ها باینری‌های از پیش کامپایل‌شده در دسترس نیستند، اما همچنان می‌توان از این پرچم برای جلوگیری از یک‌بار کامپایل نسخهٔ Nim و استفادهٔ مجدد از آن بهره برد.
- --maximumTaggedVersions
- حداکثر تعداد تگ‌ها برای بررسی یک بسته هنگام کشف نسخه‌ها برای حل‌کنندهٔ SAT. مقدار 0 به معنای همه است.
- --parser:declarative|nimvm
- استفاده از تجزیه‌کنندهٔ declarative یا nimvm (پیش‌فرض).
- --features
- فعال‌سازی قابلیت‌ها (features). تنها هنگام استفاده از تجزیه‌کنندهٔ declarative کاربرد دارد.
- --ignoreSubmodules
- نادیده گرفتن زیرپیمانه‌ها (submodules) هنگام کلون کردن یک مخزن.
- --legacy
- استفاده از مسیر کد قدیمی (پیش از nimble 1.0.0).
- --asyncdownloads
- استفاده از async برای بارگیری بسته‌ها. (پرچم موقت).SS "برای اطلاعات بیشتر، readme گیت‌هاب را بخوانید:"
| April 2026 | nimble 2.2.10 |