CARGO-REPORT-FUTURE-INCOMPATIBILITIES(1) General Commands Manual CARGO-REPORT-FUTURE-INCOMPATIBILITIES(1)

cargo-report-future-incompatibilities - گزارش بسته‌هایی که در آینده کامپایل آن‌ها متوقف خواهد شد

cargo report future-incompatibilities [گزینه‌ها]

گزارشی از هشدارهای ناسازگاری‌های آینده (future-incompatible) را که در طول ساخت‌های پیشین صادر شده‌اند، نمایش می‌دهد. این‌ها هشدارهایی برای تغییراتی هستند که ممکن است در آینده به خطاهای قطعی تبدیل شده و موجب عدم امکان ساخت وابستگی‌ها در نگارش‌های بعدی rustc شوند.

برای اطلاعات بیشتر، فصل Future incompat report https://doc.rust-lang.org/cargo/reference/future-incompat-report.html را ببینید.

--id id

گزارش را با شناسهٔ (id) مشخص‌شده که توسط Cargo تولید شده است نمایش می‌دهد. اگر مشخص نشود، تازه‌ترین گزارش را نشان می‌دهد.

به‌طور پیش‌فرض، بستهٔ موجود در دایرکتوری کاری فعلی انتخاب می‌شود. پرچم -p می‌تواند برای انتخاب بسته‌ای متفاوت در یک فضای کاری (workspace) استفاده شود.

-p spec, --package spec

بسته‌ای که گزارش برای آن نمایش داده می‌شود. برای قالب SPEC به cargo-pkgid(1) مراجعه کنید.

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

--locked

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

ممکن است در محیط‌هایی که ساخت‌های قطعی و بازتولیدپذیر مورد نیاز است، مانند خطوط لولهٔ CI، استفاده شود.

--offline

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

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

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

--frozen

معادل مشخص کردن هم‌زمان هر دو گزینهٔ --locked و --offline است.

+toolchain

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

--config KEY=VALUE یا PATH

یک مقدار پیکربندی Cargo را رونویسی (override) می‌کند. آرگومان باید در نحو 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.نمایش تازه‌ترین گزارش future-incompat: 
cargo report future-incompat
2.نمایش تازه‌ترین گزارش future-incompat برای یک بستهٔ خاص: 
cargo report future-incompat --package my-dep@0.0.1

cargo(1), cargo-report(1), cargo-build(1)