'\" t
.TH "CARGO\-REMOVE" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-remove \- حذف وابستگی‌ها از فایل مانیفست Cargo.toml
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo remove\fR [\fIگزینه‌ها\fR] \fIوابستگی\fR\[u2026]
.SH "توضیحات (DESCRIPTION)"
یک یا چند وابستگی را از یک مانیفست \fBCargo.toml\fR حذف می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های بخش"
.sp
\fB\-\-dev\fR
.RS 4
به عنوان یک \fIوابستگی توسعه\fR <https://doc.rust\-lang.org/cargo/reference/specifying\-dependencies.html#development\-dependencies> حذف می‌کند.\&
.RE
.sp
\fB\-\-build\fR
.RS 4
به عنوان یک \fIوابستگی ساخت\fR <https://doc.rust\-lang.org/cargo/reference/specifying\-dependencies.html#build\-dependencies> حذف می‌کند.\&
.RE
.sp
\fB\-\-target\fR \fItarget\fR
.RS 4
به عنوان وابستگی برای \fIبستر هدف مشخص‌شده\fR <https://doc.rust\-lang.org/cargo/reference/specifying\-dependencies.html#platform\-specific\-dependencies> حذف می‌کند.\&
.sp
برای جلوگیری از بسط ناخواسته توسط پوسته، می‌توانید هدف را در علامت نقل‌قول قرار دهید، مثلاً \fB\-\-target 'cfg(unix)'\fR\&.
.RE
.SS "گزینه‌های متفرقه"
.sp
\fB\-\-dry\-run\fR
.RS 4
در عمل تغییری در فایل مانیفست اعمال نمی‌کند.\&
.RE
.SS "گزینه‌های نمایش"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرجزئیات. برای خروجی «بسیار پرجزئیات» که شامل اطلاعات بیشتری مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است، می‌تواند دو بار مشخص شود.
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR \fBterm.verbose\fR <https://doc.rust\-lang.org/cargo/reference/config.html> تعیین شود.\&
.RE
.sp
\fB\-q\fR, 
\fB\-\-quiet\fR
.RS 4
پیام‌های گزارش لاگ cargo را چاپ نمی‌کند.
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR \fBterm.quiet\fR <https://doc.rust\-lang.org/cargo/reference/config.html> تعیین شود.\&
.RE
.sp
\fB\-\-color\fR \fIwhen\fR
.RS 4
زمان استفاده از خروجی رنگی را کنترل می‌کند. مقادیر معتبر:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBauto\fR (پیش‌فرض): به صورت خودکار پشتیبانی از رنگ در ترمینال را تشخیص می‌دهد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBalways\fR: همیشه رنگ‌ها را نمایش می‌دهد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBnever\fR: هرگز رنگ‌ها را نمایش نمی‌دهد.
.RE
.sp
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR \fBterm.color\fR <https://doc.rust\-lang.org/cargo/reference/config.html> تعیین شود.\&
.RE
.SS "گزینه‌های مانیفست"
.sp
\fB\-\-manifest\-path\fR \fIpath\fR
.RS 4
مسیر فایل \fBCargo.toml\fR. به صورت پیش‌فرض، Cargo فایل \fBCargo.toml\fR را در دایرکتوری فعلی یا هر یک از دایرکتوری‌های والد جستجو می‌کند.\&
.RE
.sp
\fB\-\-locked\fR
.RS 4
اطمینان حاصل می‌کند که دقیقاً از همان وابستگی‌ها و نسخه‌هایی استفاده شود که هنگام تولید اولیه فایل \fBCargo.lock\fR فعلی استفاده شده بود. در صورت وقوع هر یک از موارد زیر، Cargo با خطا متوقف خواهد شد:
.sp
.RS 4
\h'-04'\(bu\h'+03'فایل lock وجود نداشته باشد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'Cargo به دلیل تفکیک متفاوت وابستگی‌ها، برای تغییر فایل lock تلاش کند.
.RE
.sp
می‌تواند در محیط‌هایی که ساخت‌های قطعی و معین (deterministic) مورد نیاز است، مانند خطوط لوله CI، استفاده شود.\&
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این پرچم، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با خطا متوقف می‌شود. با این پرچم، Cargo در صورت امکان تلاش می‌کند بدون شبکه پیش برود.
.sp
توجه داشته باشید که این ممکن است به تحلیل متفاوتی از وابستگی‌ها نسبت به حالت آنلاین منجر شود. Cargo خود را به کریت‌هایی محدود می‌کند که به صورت محلی دانلود شده‌اند، حتی اگر طبق نسخه محلی ایندکس، نسخه جدیدتری موجود باشد. برای دانلود وابستگی‌ها پیش از رفتن به حالت آفلاین، دستور \fBcargo\-fetch\fR(1) را ببینید.
.sp
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR \fBnet.offline\fR <https://doc.rust\-lang.org/cargo/reference/config.html> تعیین شود.\&
.RE
.sp
\fB\-\-frozen\fR
.RS 4
معادل تعیین هم‌زمان هر دو گزینه \fB\-\-locked\fR و \fB\-\-offline\fR است.\&
.RE
.SS "انتخاب بسته"
.sp
\fB\-p\fR \fIspec\fR\[u2026], 
\fB\-\-package\fR \fIspec\fR\[u2026]
.RS 4
بسته‌ای که وابستگی باید از آن حذف شود.\&
.RE
.SS "گزینه‌های عمومی"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر Cargo با rustup نصب شده باشد و نخستین آرگومان \fBcargo\fR با \fB+\fR آغاز شود، به عنوان نام زنجیره‌ابزار rustup تفسیر خواهد شد (مانند \fB+stable\fR یا \fB+nightly\fR).
برای اطلاعات بیشتر در مورد چگونگی کارکرد بازنویسی زنجیره‌ابزار، \fIمستندات rustup\fR <https://rust\-lang.github.io/rustup/overrides.html> را ببینید.\&
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR or \fIPATH\fR
.RS 4
یک مقدار پیکربندی Cargo را بازنویسی می‌کند. آرگومان باید در ساختار نحوی TOML به صورت \fBKEY=VALUE\fR باشد، یا به عنوان مسیر یک فایل پیکربندی اضافی ارائه شود. این پرچم می‌تواند چندین بار مشخص شود.
برای اطلاعات بیشتر، \fIبخش بازنویسی‌های خط فرمان\fR <https://doc.rust\-lang.org/cargo/reference/config.html#command\-line\-overrides> را ببینید.\&
.RE
.sp
\fB\-C\fR \fIPATH\fR
.RS 4
دایرکتوری کاری فعلی را قبل از اجرای هرگونه عملیات مشخص‌شده تغییر می‌دهد. این امر مواردی مانند محل پیش‌فرضی که cargo برای مانیفست پروژه (\fBCargo.toml\fR) جستجو می‌کند، و همچنین دایرکتوری‌های مورد جستجو برای یافتن \fB\&.cargo/config.toml\fR را تحت تأثیر قرار می‌دهد. این گزینه باید پیش از نام دستور قرار گیرد، برای مثال: \fBcargo \-C path/to/my\-project build\fR\&.
.sp
این گزینه تنها روی \fIکانال nightly\fR <https://doc.rust\-lang.org/book/appendix\-07\-nightly\-rust.html> در دسترس است و برای فعال شدن به پرچم \fB\-Z unstable\-options\fR نیاز دارد (مشاهده کنید \fI#10098\fR <https://github.com/rust\-lang/cargo/issues/10098>).\&
.RE
.sp
\fB\-h\fR, 
\fB\-\-help\fR
.RS 4
اطلاعات راهنما را نمایش می‌دهد.\&
.RE
.sp
\fB\-Z\fR \fIflag\fR
.RS 4
پرچم‌های ناپایدار (فقط nightly) برای Cargo. برای جزئیات، دستور \fBcargo \-Z help\fR را اجرا کنید.\&
.RE
.SH "محیط (ENVIRONMENT)"
برای جزئیات درباره متغیرهای محیطی که Cargo می‌خواند، \fIمرجع\fR <https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> را ببینید.\&
.SH "وضعیت خروج (EXIT STATUS)"
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB0\fR: دستور Cargo با موفقیت اجرا شد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: دستور Cargo با شکست مواجه شد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'حذف \fBregex\fR به عنوان یک وابستگی
.sp
.RS 4
.nf
cargo remove regex
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'حذف \fBtrybuild\fR به عنوان یک وابستگی توسعه (dev\-dependency)
.sp
.RS 4
.nf
cargo remove \-\-dev trybuild
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'حذف \fBnom\fR از جدول وابستگی‌های \fBwasm32\-unknown\-unknown\fR
.sp
.RS 4
.nf
cargo remove \-\-target wasm32\-unknown\-unknown nom
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-add\fR(1)