'\" t
.TH "CARGO\-FETCH" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-fetch \- دریافت وابستگی‌های یک بسته از شبکه
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo fetch\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
اگر فایل \fBCargo.lock\fR در دسترس باشد، این دستور اطمینان حاصل می‌کند که تمام وابستگی‌های git و/یا وابستگی‌های رجیستری بارگیری شده و به صورت محلی در دسترس هستند. دستورات بعدی Cargo پس از اجرای یک \fBcargo fetch\fR قادر خواهند بود به صورت آفلاین اجرا شوند، مگر اینکه فایل قفل تغییر کند.
.sp
اگر فایل قفل در دسترس نباشد، این دستور پیش از دریافت وابستگی‌ها، فایل قفل را ایجاد خواهد کرد.
.sp
اگر \fB\-\-target\fR مشخص نشده باشد، تمام وابستگی‌های هدف دریافت می‌شوند.
.sp
همچنین افزونهٔ \fIcargo\-prefetch\fR <https://crates.io/crates/cargo\-prefetch> را ببینید که دستوری برای بارگیری crateهای پرکاربرد اضافه می‌کند. اگر قصد دارید از Cargo بدون شبکه با پرچم \fB\-\-offline\fR استفاده کنید، این افزونه می‌تواند مفید باشد.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های واکشی (Fetch Options)"
.sp
\fB\-\-target\fR \fItriple\fR
.RS 4
دریافت برای معماری هدف مشخص‌شده. این پرچم می‌تواند چندین بار مشخص شود. مقدار پیش‌فرض، همهٔ معماری‌ها است. ساختار کلی triple به صورت \fB<arch><sub>\-<vendor>\-<sys>\-<abi>\fR است.
.sp
مقادیر ممکن:
.sp
.RS 4
\h'-04'\(bu\h'+03'هر هدف پشتیبانی‌شده در \fBrustc \-\-print target\-list\fR\&.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB"host\-tuple"\fR، که در داخل با هدف سیستم میزبان جایگزین خواهد شد. این گزینه به‌ویژه هنگامی مفید است که در حال کامپایل متقابل برخی از crateها هستید و نمی‌خواهید ماشین میزبان خود را به عنوان یک هدف مشخص کنید (به عنوان مثال، یک \fBxtask\fR در یک پروژهٔ مشترک که ممکن است توسط چندین میزبان مختلف روی آن کار شود).
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'مسیری به یک مشخصات سفارشی هدف. برای اطلاعات بیشتر \fICustom Target Lookup Path\fR <https://doc.rust\-lang.org/rustc/targets/custom.html#custom\-target\-lookup\-path> را ببینید.
.RE
.sp
این مورد را می‌توان با \fIمقدار پیکربندی\fR \fBbuild.target\fR <https://doc.rust\-lang.org/cargo/reference/config.html> نیز مشخص کرد.
.sp
توجه داشته باشید که تعیین این پرچم باعث می‌شود Cargo در حالت متفاوتی اجرا شود که در آن مصنوعات هدف در یک دایرکتوری جداگانه قرار می‌گیرند. برای جزئیات بیشتر به مستندات \fIbuild cache\fR <https://doc.rust\-lang.org/cargo/reference/build\-cache.html> مراجعه کنید.
.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 "گزینه‌های مانیفست (Manifest Options)"
.sp
\fB\-\-manifest\-path\fR \fIpath\fR
.RS 4
مسیر فایل \fBCargo.toml\fR. به صورت پیش‌فرض، Cargo فایل \fBCargo.toml\fR را در دایرکتوری جاری یا هر دایرکتوری والد جستجو می‌کند.
.RE
.sp
\fB\-\-locked\fR
.RS 4
تأیید می‌کند که دقیقاً از همان وابستگی‌ها و نسخه‌هایی استفاده می‌شود که فایل \fBCargo.lock\fR موجود در ابتدا با آن‌ها تولید شده است. Cargo در صورت بروز هر یک از شرایط زیر با یک خطا خارج خواهد شد:
.sp
.RS 4
\h'-04'\(bu\h'+03'فایل قفل موجود نباشد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'برنامه Cargo به دلیل تفکیک و حل وابستگی متفاوت، برای تغییر فایل قفل تلاش کند.
.RE
.sp
می‌تواند در محیط‌هایی که ساخت‌های قطعی و تکرارپذیر مورد نظر است، مانند خطوط لوله CI، استفاده شود.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این پرچم، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با یک خطا متوقف خواهد شد. با این پرچم، Cargo در صورت امکان تلاش خواهد کرد بدون شبکه پیش برود.
.sp
توجه داشته باشید که این ممکن است به حل وابستگی متفاوتی نسبت به حالت آنلاین منجر شود. Cargo خود را به crateهایی که به صورت محلی بارگیری شده‌اند محدود می‌کند، حتی اگر نسخهٔ جدیدتری در رونوشت محلی نمایه وجود داشته باشد.
.sp
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBnet.offline\fR <https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.sp
\fB\-\-frozen\fR
.RS 4
معادل مشخص کردن هم‌زمان \fB\-\-locked\fR و \fB\-\-offline\fR است.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر Cargo با rustup نصب شده باشد و اولین آرگومان به \fBcargo\fR با \fB+\fR آغاز شود، به عنوان یک نام زنجیره ابزار 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 باشد، یا به عنوان یک مسیر به یک فایل پیکربندی اضافی ارائه شود. این پرچم می‌تواند چندین بار مشخص شود.
برای اطلاعات بیشتر بخش \fIcommand\-line overrides\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'دریافت تمام وابستگی‌ها:
.sp
.RS 4
.nf
cargo fetch
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-update\fR(1), \fBcargo\-generate\-lockfile\fR(1)