CARGO-INFO(1) General Commands Manual CARGO-INFO(1)

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

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

-q, --quiet

عدم چاپ پیام‌های گزارش (log) کارگو. همچنین می‌تواند از طریق مقدار پیکربندی 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 تعیین شود.

--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

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

-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 را اجرا کنید.

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

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

1.بررسی بستهٔ serde از crates.io:
cargo info serde
2.بررسی بستهٔ serde با نگارش 1.0.0:
cargo info serde@1.0.0
3.بررسی بستهٔ serde از یک مخزن محلی:
cargo info serde --registry my-registry

cargo(1), cargo-search(1)