CARGO-LOCATE-PROJECT(1) General Commands Manual CARGO-LOCATE-PROJECT(1)

cargo-locate-project - چاپ مسیر فایل Cargo.toml پروژه جاری

cargo locate-project [گزینه‌ها]

این دستور یک شیء JSON حاوی مسیر کامل مانیفست پروژه را در خروجی استاندارد چاپ می‌کند. مانیفست با جستجوی رو به بالا برای فایلی به نام Cargo.toml از دایرکتوری کاری جاری پیدا می‌شود.

اگر پروژه بخشی از یک فضای کاری (workspace) باشد، مانیفست خود پروژه به جای ریشه فضای کاری در خروجی قرار می‌گیرد. این رفتار با فلگ --workspace قابل تغییر است. فضای کاری ریشه با پیمایش بیشتر به سمت بالا یا با استفاده از فیلد package.workspace پس از یافتن مانیفست یکی از اعضای فضای کاری شناسایی می‌شود.

--workspace

یافتن Cargo.toml در ریشه فضای کاری، به جای عضو جاری فضای کاری.

--message-format fmt

قالب نمایش برای چاپ مکان پروژه. مقادیر مجاز:
•json (پیش‌فرض): شیء JSON شامل مسیر تحت کلید “root”.
•plain: تنها مسیر فایل.

-v, --verbose

استفاده از خروجی با جزئیات. می‌تواند دو بار برای خروجی “بسیار پرجزئیات” مشخص شود که شامل اطلاعات اضافی مانند هشدارهای وابستگی‌ها و خروجی اسکریپت ساخت است. همچنین می‌تواند از طریق مقدار پیکربندی term.verbose در https://doc.rust-lang.org/cargo/reference/config.html تنظیم شود.

-q, --quiet

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

+toolchain

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

--config KEY=VALUE یا PATH

یک مقدار پیکربندی کارگو را بازنویسی می‌کند. آرگومان باید در قالب نحو TOML به صورت KEY=VALUE باشد یا به عنوان مسیر یک فایل پیکربندی اضافی ارائه شود. این فلگ می‌تواند چندین بار تکرار شود. برای اطلاعات بیشتر به بخش بازنویسی‌های خط فرمان در https://doc.rust-lang.org/cargo/reference/config.html#command-line-overrides مراجعه کنید.

-C PATH

دایرکتوری کاری جاری را پیش از اجرای هر عملیات مشخص‌شده تغییر می‌دهد. این گزینه بر مواردی مانند محل پیش‌فرضی که کارگو برای مانیفست پروژه (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 -Z help را اجرا کنید.

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

•0: کارگو با موفقیت اجرا شد.
•101: اجرای کارگو با شکست مواجه شد.

1.نمایش مسیر مانیفست بر اساس دایرکتوری جاری: 
cargo locate-project

cargo(1), cargo-metadata(1)