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

cargo-search - جستجوی بسته‌ها در رجیستری. رجیستری پیش‌فرض crates.io است

cargo search [options] [query…]

این دستور یک جستجوی متنی برای کریت‌ها (crates) در https://crates.io انجام می‌دهد. کریت‌های منطبق به همراه توضیحاتشان در قالب TOML مناسب برای کپی کردن درون مانیفست Cargo.toml نمایش داده می‌شوند.

--limit limit

محدود کردن تعداد نتایج (پیش‌فرض: 10، حداکثر: 100).

--index index

نشانی وب (URL) اندیس رجیستری مورد استفاده.

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

عدم چاپ پیام‌های لاگ cargo. همچنین می‌تواند با مقدار پیکربندی 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 تعیین شود.

+toolchain

اگر Cargo توسط rustup نصب شده باشد و اولین آرگومان cargo با + آغاز شود، به عنوان نام زنجیره‌ابزار (toolchain) در 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: عملیات Cargo با موفقیت به پایان رسید.
•101: اجرای Cargo با خطا مواجه شد.

1.جستجوی یک بسته از crates.io: 
cargo search serde

cargo(1), cargo-install(1), cargo-publish(1)