'\" t
.TH "CARGO\-NEW" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-new \- ایجاد یک بسته جدید Cargo
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo new\fR [\fIگزینه‌ها\fR] \fIمسیر\fR
.SH "توضیحات (DESCRIPTION)"
این دستور یک بسته جدید Cargo در دایرکتوری داده‌شده ایجاد می‌کند. این
شامل یک الگوی ساده با مانیفست \fBCargo.toml\fR، فایل منبع نمونه،
و یک فایل نادیده‌گرفتن (ignore) سامانهٔ کنترل نسخه (VCS) است. اگر دایرکتوری از پیش در یک مخزن VCS نباشد،
یک مخزن جدید ایجاد می‌شود (به \fB\-\-vcs\fR در زیر مراجعه کنید).
.sp
برای دستور مشابهی که مانیفست جدیدی در یک دایرکتوری موجود ایجاد می‌کند،
\fBcargo\-init\fR(1) را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های new (New Options)"
.sp
\fB\-\-bin\fR
.RS 4
ایجاد یک بسته با هدف دودویی (binary target) (\fBsrc/main.rs\fR).
این رفتار پیش‌فرض است.
.RE
.sp
\fB\-\-lib\fR
.RS 4
ایجاد یک بسته با هدف کتابخانه‌ای (library target) (\fBsrc/lib.rs\fR).
.RE
.sp
\fB\-\-edition\fR \fIedition\fR
.RS 4
تعیین ویرایش (edition) زبان Rust برای استفاده. پیش‌فرض 2024 است.
مقادیر ممکن: 2015، 2018، 2021، 2024
.RE
.sp
\fB\-\-name\fR \fIname\fR
.RS 4
تنظیم نام بسته. به‌طور پیش‌فرض همان نام دایرکتوری در نظر گرفته می‌شود.
.RE
.sp
\fB\-\-vcs\fR \fIvcs\fR
.RS 4
راه‌اندازی اولیه یک مخزن VCS جدید برای سامانه کنترل نسخه مشخص‌شده (git،
hg، pijul یا fossil) یا راه‌اندازی نکردن هیچ سامانه کنترل نسخه‌ای
(none). در صورت مشخص نشدن، مقدار پیش‌فرض \fBgit\fR یا مقدار پیکربندی
\fBcargo\-new.vcs\fR خواهد بود، یا اگر از پیش درون یک مخزن VCS باشد، به \fBnone\fR تنظیم می‌شود.
.RE
.sp
\fB\-\-registry\fR \fIregistry\fR
.RS 4
فیلد \fBpublish\fR را در \fBCargo.toml\fR روی نام رجیستری مشخص‌شده تنظیم می‌کند
که انتشار را تنها به همان رجیستری محدود خواهد ساخت.
.sp
نام‌های رجیستری در \fIفایل‌های پیکربندی Cargo\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعریف می‌شوند.
در صورت مشخص نشدن، رجیستری پیش‌فرضی که توسط کلید پیکربندی \fBregistry.default\fR
تعریف شده استفاده می‌شود. اگر رجیستری پیش‌فرض تنظیم نشده باشد و از \fB\-\-registry\fR نیز
استفاده نشود، فیلد \fBpublish\fR مقداردهی نخواهد شد؛ به این معنی که انتشار محدود نخواهد شد.
.RE
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرگو (verbose). ممکن است برای دریافت خروجی «بسیار پرگو» دو بار مشخص شود که
شامل اطلاعات خروجی اضافی از جمله هشدارهای وابستگی‌ها و خروجی اسکریپت ساخت خواهد بود.
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR \fBterm.verbose\fR
<https://doc.rust\-lang.org/cargo/reference/config.html>\& تعیین شود.
.RE
.sp
\fB\-q\fR, 
\fB\-\-quiet\fR
.RS 4
پیام‌های لاگ cargo را چاپ نمی‌کند.
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR \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
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR \fBterm.color\fR
<https://doc.rust\-lang.org/cargo/reference/config.html>\& تعیین شود.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر Cargo به‌وسیلهٔ rustup نصب شده باشد و نخستین آرگومان \fBcargo\fR
با \fB+\fR آغاز شود، به عنوان نام زنجیره ابزار (toolchain) rustup تفسیر خواهد شد (مانند
\fB+stable\fR یا \fB+nightly\fR).
برای اطلاعات بیشتر درباره نحوه کار بازنویسی‌های زنجیره ابزار، \fIمستندات rustup\fR
<https://rust\-lang.github.io/rustup/overrides.html> را ببینید.
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR یا \fIPATH\fR
.RS 4
یک مقدار پیکربندی Cargo را بازنویسی می‌کند. آرگومان باید در ساختار نحو TOML به صورت \fBKEY=VALUE\fR
باشد، یا به صورت مسیر یک فایل پیکربندی اضافه فراهم شود. این پرچم می‌تواند چندین بار مشخص شود.
برای اطلاعات بیشتر، \fIبخش بازنویسی‌های خط فرمان\fR <https://doc.rust\-lang.org/cargo/reference/config.html#command\-line\-overrides> را ببینید.
.RE
.sp
\fB\-C\fR \fIPATH\fR
.RS 4
دایرکتوری کاری فعلی را قبل از اجرای هر عملیات مشخص‌شده تغییر می‌دهد. این گزینه بر مواردی
چون محلی که cargo به‌طور پیش‌فرض برای مانیفست پروژه (\fBCargo.toml\fR) جستجو می‌کند، و همچنین
دایرکتوری‌هایی که برای یافتن \fB\&.cargo/config.toml\fR جستجو می‌شوند، تأثیر می‌گذارد. این گزینه باید
قبل از نام دستور مشخص شود، برای نمونه: \fBcargo \-C path/to/my\-project build\fR\&.
.sp
این گزینه تنها در \fIکانال nightly\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) برای Cargo. برای جزئیات دستور \fBcargo \-Z help\fR را اجرا کنید.
.RE
.SH "محیط (ENVIRONMENT)"
برای جزئیات بیشتر درباره متغیرهای محیطی که Cargo می‌خواند، \fIمرجع متغیرهای محیطی\fR
<https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> را ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB0\fR: اجرای Cargo موفقیت‌آمیز بود.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: اجرای Cargo با شکست مواجه شد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'ایجاد یک بسته دودویی (binary) Cargo در دایرکتوری مشخص‌شده:
.sp
.RS 4
.nf
cargo new foo
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-init\fR(1)