CARGO-GENERATE-LOCKFILE(1) General Commands Manual CARGO-GENERATE-LOCKFILE(1)

cargo-generate-lockfile - تولید فایل قفل برای یک بسته

cargo generate-lockfile [گزینه‌ها]

این دستور فایل قفل Cargo.lock را برای بسته یا فضای‌کاری (workspace) فعلی ایجاد می‌کند. اگر فایل قفل از قبل وجود داشته باشد، با آخرین نسخهٔ در دسترس از هر بسته بازسازی خواهد شد.

همچنین cargo-update(1) را ببینید که قادر به ایجاد فایل قفل Cargo.lock است و گزینه‌های بیشتری برای کنترل رفتار به‌روزرسانی دارد.

-v, --verbose

استفاده از خروجی پرحرّاف. می‌تواند دو بار مشخص شود تا خروجی «بسیار پرحرّاف» تولید شود که شامل موارد اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است. همچنین می‌تواند با مقدار پیکربندی term.verbose در https://doc.rust-lang.org/cargo/reference/config.html مشخص شود.

-q, --quiet

عدم چاپ پیام‌های گزارش کارگو. همچنین می‌تواند با مقدار پیکربندی term.quiet در https://doc.rust-lang.org/cargo/reference/config.html مشخص شود.

--color when

کنترل زمان استفاده از خروجی رنگی. مقادیر معتبر:
•auto (پیش‌فرض): تشخیص خودکار در دسترس بودن پشتیبانی از رنگ در ترمینال.
•always: همیشه رنگ‌ها نمایش داده شوند.
•never: هرگز رنگ‌ها نمایش داده نشوند.

همچنین می‌تواند با مقدار پیکربندی term.color در https://doc.rust-lang.org/cargo/reference/config.html مشخص شود.

--manifest-path path

مسیر فایل Cargo.toml. به صورت پیش‌فرض، Cargo به دنبال فایل Cargo.toml در دایرکتوری فعلی یا هر یک از دایرکتوری‌های والد می‌گردد.

--ignore-rust-version

نادیده گرفتن مشخصهٔ rust-version در بسته‌ها.

--publish-time yyyy-mm-ddThh:mm:ssZ

آخرین زمان انتشار مجاز برای بسته‌های رجیستری (ناپایدار)

این یک فیلتر با نهایت تلاش (best-effort) روی بسته‌های مجاز است، از جمله:

•بسته‌های متعلق به رجیستری‌های پشتیبانی‌نشده همیشه پذیرفته می‌شوند
•تنها وضعیت yank فعلی مد نظر قرار می‌گیرد، نه وضعیت آن در زمان --publish-time
•دقت زمان انتشار

--locked

اطمینان حاصل می‌کند که دقیقاً همان وابستگی‌ها و نسخه‌های استفاده‌شده در زمان ایجاد اولیهٔ فایل Cargo.lock موجود، به کار روند. کارگو در صورت بروز هر یک از سناریوهای زیر با خطا خارج خواهد شد:
•فایل قفل وجود نداشته باشد.
•کارگو به دلیل تفکیک متفاوت وابستگی‌ها تلاش کند فایل قفل را تغییر دهد.

این گزینه می‌تواند در محیط‌هایی که ساخت‌های قطعی و تکرارپذیر مورد نظر است، مانند خطوط لوله CI، استفاده شود.

--offline

جلوگیری از دسترسی کارگو به شبکه به هر دلیلی. بدون این پرچم، اگر کارگو نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با خطا متوقف خواهد شد. با این پرچم، کارگو تلاش خواهد کرد در صورت امکان بدون شبکه به کار خود ادامه دهد.

توجه داشته باشید که این کار ممکن است منجر به تفکیک وابستگی متفاوتی نسبت به حالت آنلاین شود. کارگو خود را به crateهایی که به صورت محلی بارگیری شده‌اند محدود می‌کند، حتی اگر طبق نسخهٔ محلی نمایه (index)، نسخهٔ جدیدتری وجود داشته باشد. دستور cargo-fetch(1) را برای بارگیری وابستگی‌ها پیش از رفتن به حالت آفلاین ببینید.

همچنین می‌تواند با مقدار پیکربندی net.offline در https://doc.rust-lang.org/cargo/reference/config.html مشخص شود.

--frozen

معادل با تعیین هر دو گزینهٔ --locked و --offline به‌طور هم‌زمان.

+toolchain

اگر کارگو از طریق rustup نصب شده باشد و آرگومان نخست cargo با + آغاز شود، به عنوان نام زنجیره‌ابزار (toolchain) متعلق به rustup تفسیر خواهد شد (مانند +stable یا +nightly). برای اطلاعات بیشتر در مورد چگونگی کارکرد بازنویسی زنجیره‌ابزارها، مستندات rustup در https://rust-lang.github.io/rustup/overrides.html را ببینید.

--config KEY=VALUE or PATH

یک مقدار پیکربندی کارگو را بازنویسی می‌کند. این آرگومان باید در ساختار نحو TOML به صورت KEY=VALUE باشد، یا به عنوان مسیری به یک فایل پیکربندی اضافی ارائه شود. این پرچم می‌تواند چندین بار مشخص شود. برای اطلاعات بیشتر، بخش بازنویسی‌های خط فرمان در https://doc.rust-lang.org/cargo/reference/config.html#command-line-overrides را ببینید.

-C PATH

دایرکتوری کاری فعلی را پیش از اجرای هرگونه عملیات مشخص‌شده تغییر می‌دهد. این امر مواردی چون محل پیش‌فرضی که کارگو در آن به دنبال مانیفست پروژه (Cargo.toml) می‌گردد، و همچنین دایرکتوری‌هایی که برای یافتن .cargo/config.toml جستجو می‌شوند را تحت تأثیر قرار می‌دهد. این گزینه باید پیش از نام دستور بیاید، برای مثال cargo -C path/to/my-project build.

این گزینه تنها در کانال nightly در https://doc.rust-lang.org/book/appendix-07-nightly-rust.html در دسترس است و برای فعال‌سازی به پرچم -Z unstable-options نیاز دارد (مشاهدهٔ #10098 در https://github.com/rust-lang/cargo/issues/10098).

-h, --help

اطلاعات راهنما را چاپ می‌کند.

-Z flag

پرچم‌های ناپایدار (فقط nightly) برای کارگو. برای جزئیات، دستور cargo -Z help را اجرا کنید.

برای جزئیات دربارهٔ متغیرهای محیطی که کارگو می‌خواند، مرجع در https://doc.rust-lang.org/cargo/reference/environment-variables.html را ببینید.

•0: کارگو با موفقیت پایان یافت.
•101: کارگو در تکمیل عملیات ناموفق بود.

1.ایجاد یا به‌روزرسانی فایل قفل برای بسته یا فضای‌کاری فعلی: 
cargo generate-lockfile

cargo(1), cargo-update(1)