cargo-info - نمایش
اطلاعات
درباره یک
بسته
cargo info
[گزینهها]
spec
این دستور
اطلاعات
مربوط به یک
بسته را
نمایش
میدهد. این
فرمان
دادهها را
از فایل Cargo.toml
بسته واکشی
کرده و در
قالبی
خوانا برای
انسان
ارائه
میدهد.
spec
واکشی
اطلاعات
درباره
بسته
مشخصشده.
spec
میتواند
یک شناسه
بسته (package ID)
باشد؛ برای
ساختار SPEC،
cargo-pkgid(1) را
ببینید. اگر
بسته
مشخصشده
بخشی از
فضای کاری (workspace)
فعلی باشد،
اطلاعات از
فایل محلی Cargo.toml
نمایش داده
خواهد شد.
اگر فایل
Cargo.lock
وجود
نداشته
باشد،
ایجاد
خواهد شد.
اگر نگارشی
مشخص نشده
باشد،
نگارش
مناسب بر
اساس حداقل
نگارش
پشتیبانیشدهٔ
راست (MSRV)
انتخاب
خواهد شد.
--index index
نشانی
اینترنتی (URL)
نمایه مخزن
مورد
استفاده.
--registry registry
نام مخزن
(registry) مورد
استفاده.
نامهای
مخزن در
فایلهای
پیکربندی Cargo
https://doc.rust-lang.org/cargo/reference/config.html
تعریف
شدهاند.
اگر مشخص
نشود، مخزن
پیشفرض
استفاده
میشود که
توسط کلید
پیکربندی
registry.default تعیین
شده و مقدار
پیشفرض آن
crates-io است.
-v, --verbose
-q, --quiet
--color when
کنترل
زمان
استفاده از
خروجی رنگی.
مقادیر
معتبر:
•auto
(پیشفرض):
تشخیص
خودکار در
دسترس بودن
پشتیبانی
از رنگ در
ترمینال.
•always:
نمایش
همیشگی
رنگها.
•never: عدم
نمایش
رنگها در
هیچ حالتی.
همچنین
میتواند
از طریق
مقدار
پیکربندی
term.color
https://doc.rust-lang.org/cargo/reference/config.html
تعیین شود.
--locked
اطمینان
حاصل
میکند که
دقیقاً
همان
وابستگیها
و
نگارشهایی
استفاده
شوند که
هنگام
ایجاد
اولیهٔ
فایل
Cargo.lock
استفاده
شده بودند.
در صورت
وقوع هر یک
از موارد
زیر، Cargo با
خطا خارج
خواهد شد:
•فایل
قفل وجود
نداشته
باشد.
•کارگو
به دلیل
برطرفسازی
متفاوت
وابستگیها،
برای تغییر
فایل قفل
تلاش کند.
میتوان
از این
گزینه در
محیطهایی
که نیاز به
ساختهای
قطعی و
تکرارپذیر
دارند
(مانند
پایپلاینهای
CI) استفاده
کرد.
--offline
از
دسترسی Cargo به
شبکه به هر
دلیلی
جلوگیری
میکند.
بدون این
پرچم، اگر Cargo
نیاز به
دسترسی به
شبکه داشته
باشد و شبکه
در دسترس
نباشد، با
خطا متوقف
خواهد شد. با
این پرچم، Cargo
در صورت
امکان تلاش
میکند
بدون اتصال
به شبکه به
کار خود
ادامه دهد.
توجه
داشته
باشید که
این کار
ممکن است
منجر به
برطرفسازی
متفاوتی از
وابستگیها
نسبت به
حالت
آنلاین شود.
کارگو خود
را به
کریتهایی
محدود
میکند که
به صورت
محلی
دانلود
شدهاند،
حتی اگر طبق
نسخه محلی
نمایه،
نگارش
جدیدتری
وجود داشته
باشد. برای
بارگیری
وابستگیها
پیش از رفتن
به حالت
آفلاین،
دستور cargo-fetch(1)
را ببینید.
همچنین
میتواند
از طریق
مقدار
پیکربندی
net.offline
https://doc.rust-lang.org/cargo/reference/config.html
تعیین شود.
--frozen
معادل
مشخص کردن
همزمان هر
دو گزینهٔ
--locked و --offline است.
+toolchain
اگر Cargo
توسط rustup نصب
شده باشد و
نخستین
آرگومان
cargo
با
+ آغاز
شود، به
عنوان نام
زنجیره
ابزار rustup
تفسیر
خواهد شد
(مانند
+stable یا
+nightly). برای
اطلاعات
بیشتر
درباره
نحوه
عملکرد
جایگزینی
زنجیره
ابزار، به
مستندات rustup
https://rust-lang.github.io/rustup/overrides.html
مراجعه
کنید.
--config KEY=VALUE یا PATH
-C PATH
دایرکتوری
کاری فعلی
را پیش از
اجرای
هرگونه
عملیات
مشخصشده
تغییر
میدهد. این
تغییر بر
مواردی چون
محل جستجوی
پیشفرض Cargo
برای
مانیفست
پروژه (
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. برای
جزئیات،
دستور cargo -Z help را
اجرا کنید.
•0:
کارگو با
موفقیت
پایان
یافت.
•101:
کارگو در
تکمیل
عملیات
ناموفق
بود.
1.بررسی
بستهٔ
serde از
crates.io:
2.بررسی
بستهٔ
serde با
نگارش
1.0.0:
3.بررسی
بستهٔ
serde از
یک مخزن
محلی:
cargo info serde --registry my-registry