'\" t
.TH "CARGO\-LOCATE\-PROJECT" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-locate\-project \- چاپ مسیر فایل Cargo.toml پروژه جاری
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo locate\-project\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
این دستور یک شیء JSON حاوی مسیر کامل مانیفست پروژه را در خروجی استاندارد چاپ می‌کند.
مانیفست با جستجوی رو به بالا برای فایلی به نام \fBCargo.toml\fR از دایرکتوری کاری جاری
پیدا می‌شود.
.sp
اگر پروژه بخشی از یک فضای کاری (workspace) باشد، مانیفست خود پروژه به جای ریشه
فضای کاری در خروجی قرار می‌گیرد. این رفتار با فلگ \fB\-\-workspace\fR قابل تغییر است.
فضای کاری ریشه با پیمایش بیشتر به سمت بالا یا با استفاده از فیلد \fBpackage.workspace\fR
پس از یافتن مانیفست یکی از اعضای فضای کاری شناسایی می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-workspace\fR
.RS 4
یافتن \fBCargo.toml\fR در ریشه فضای کاری، به جای عضو جاری فضای کاری.
.RE
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-\-message\-format\fR \fIfmt\fR
.RS 4
قالب نمایش برای چاپ مکان پروژه. مقادیر مجاز:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBjson\fR (پیش‌فرض): شیء JSON شامل مسیر تحت کلید \[lq]root\[rq]\&.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBplain\fR: تنها مسیر فایل.
.RE
.RE
.sp
\fB\-v\fR,
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی با جزئیات. می‌تواند دو بار برای خروجی \[lq]بسیار پرجزئیات\[rq]
مشخص شود که شامل اطلاعات اضافی مانند هشدارهای وابستگی‌ها و خروجی اسکریپت ساخت است.
همچنین می‌تواند از طریق مقدار پیکربندی \fBterm.verbose\fR
در <https://doc.rust\-lang.org/cargo/reference/config.html> تنظیم شود.
.RE
.sp
\fB\-q\fR,
\fB\-\-quiet\fR
.RS 4
عدم چاپ پیام‌های گزارش (لاگ) کارگو.
همچنین می‌تواند با مقدار پیکربندی \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
همچنین می‌تواند با مقدار پیکربندی \fBterm.color\fR
در <https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.SS "گزینه‌های مانیفست (Manifest Options)"
.sp
\fB\-\-manifest\-path\fR \fIpath\fR
.RS 4
مسیر فایل \fBCargo.toml\fR\&. به طور پیش‌فرض، کارگو به دنبال فایل
\fBCargo.toml\fR در دایرکتوری جاری یا هر یک از دایرکتوری‌های والد می‌گردد.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر کارگو با rustup نصب شده باشد و اولین آرگومان داده شده به \fBcargo\fR
با \fB+\fR آغاز شود، به عنوان نام زنجیره ابزار (toolchain) در rustup (مانند
\fB+stable\fR یا \fB+nightly\fR) تفسیر می‌شود.
برای اطلاعات بیشتر درباره نحوه کارکرد بازنویسی زنجیره ابزار به
مستندات rustup در <https://rust\-lang.github.io/rustup/overrides.html> مراجعه کنید.
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR یا \fIPATH\fR
.RS 4
یک مقدار پیکربندی کارگو را بازنویسی می‌کند. آرگومان باید در قالب نحو TOML به صورت \fBKEY=VALUE\fR
باشد یا به عنوان مسیر یک فایل پیکربندی اضافی ارائه شود. این فلگ می‌تواند چندین بار تکرار شود.
برای اطلاعات بیشتر به بخش بازنویسی‌های خط فرمان در
<https://doc.rust\-lang.org/cargo/reference/config.html#command\-line\-overrides> مراجعه کنید.
.RE
.sp
\fB\-C\fR \fIPATH\fR
.RS 4
دایرکتوری کاری جاری را پیش از اجرای هر عملیات مشخص‌شده تغییر می‌دهد. این گزینه بر
مواردی مانند محل پیش‌فرضی که کارگو برای مانیفست پروژه (\fBCargo.toml\fR) جستجو می‌کند
و همچنین دایرکتوری‌های جستجو برای یافتن \fB\&.cargo/config.toml\fR تأثیر می‌گذارد.
این گزینه باید قبل از نام دستور قرار گیرد، برای مثال \fBcargo \-C path/to/my\-project build\fR\&.
.sp
این گزینه فقط در کانال \fInightly\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) کارگو. برای جزئیات دستور \fBcargo \-Z help\fR را اجرا کنید.
.RE
.SH "محیط (ENVIRONMENT)"
برای جزئیات مربوط به متغیرهای محیطی که کارگو می‌خواند به مرجع در
<https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB0\fR: کارگو با موفقیت اجرا شد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: اجرای کارگو با شکست مواجه شد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'نمایش مسیر مانیفست بر اساس دایرکتوری جاری:
.sp
.RS 4
.nf
cargo locate\-project
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-metadata\fR(1)