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

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

خلاصه دستور (SYNOPSIS)
       cargo remove [گزینه‌ها] وابستگی…

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

گزینه‌ها (OPTIONS)
   گزینه‌های بخش
       --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 را اجرا کنید.

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

وضعیت خروج (EXIT STATUS)
       •   0: دستور Cargo با موفقیت اجرا شد.

       •   101: دستور Cargo با شکست مواجه شد.

مثال‌ها (EXAMPLES)
        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

همچنین ببینید (SEE ALSO)
       cargo(1), cargo-add(1)

                                                               CARGO-REMOVE(1)