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

cargo-remove - حذف وابستگی‌ها از فایل مانیفست Cargo.toml

cargo remove [گزینه‌ها] وابستگی…

یک یا چند وابستگی را از یک مانیفست Cargo.toml حذف می‌کند.

--dev

به عنوان یک وابستگی توسعه https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#development-dependencies حذف می‌کند.

--build

به عنوان یک وابستگی ساخت https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#build-dependencies حذف می‌کند.

--target target

به عنوان وابستگی برای بستر هدف مشخص‌شده https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#platform-specific-dependencies حذف می‌کند.

برای جلوگیری از بسط ناخواسته توسط پوسته، می‌توانید هدف را در علامت نقل‌قول قرار دهید، مثلاً --target 'cfg(unix)'.

--dry-run

در عمل تغییری در فایل مانیفست اعمال نمی‌کند.

-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 تعیین شود.

--manifest-path path

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

--locked

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

می‌تواند در محیط‌هایی که ساخت‌های قطعی و معین (deterministic) مورد نیاز است، مانند خطوط لوله CI، استفاده شود.

--offline

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

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

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

--frozen

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

-p spec…, --package spec…

بسته‌ای که وابستگی باید از آن حذف شود.

+toolchain

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

--config KEY=VALUE or 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.حذف regex به عنوان یک وابستگی 
cargo remove regex
2.حذف trybuild به عنوان یک وابستگی توسعه (dev-dependency) 
cargo remove --dev trybuild
3.حذف nom از جدول وابستگی‌های wasm32-unknown-unknown 
cargo remove --target wasm32-unknown-unknown nom

cargo(1), cargo-add(1)