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

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

خلاصه دستور (SYNOPSIS)
       cargo locate-project [گزینه‌ها]

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

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

گزینه‌ها (OPTIONS)
       --workspace
           یافتن Cargo.toml در ریشه فضای کاری، به جای عضو جاری فضای کاری.

   گزینه‌های نمایش (Display Options)
       --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 Options)
       --manifest-path path
           مسیر فایل Cargo.toml. به طور پیش‌فرض، کارگو به دنبال فایل Cargo.toml
           در دایرکتوری جاری یا هر یک از دایرکتوری‌های والد می‌گردد.

   گزینه‌های عمومی (Common Options)
       +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 را اجرا کنید.

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

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

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

مثال‌ها (EXAMPLES)
        1. نمایش مسیر مانیفست بر اساس دایرکتوری جاری:

               cargo locate-project

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

                                                       CARGO-LOCATE-PROJECT(1)