'\" t
.TH "CARGO\-VENDOR" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-vendor \- وندور کردن و ذخیره محلی تمام وابستگی‌ها
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo vendor\fR [\fIگزینه‌ها\fR] [\fIpath\fR]
.SH "توضیحات (DESCRIPTION)"
این زیردستور cargo تمام وابستگی‌های crates.io و git یک پروژه را در دایرکتوری مشخص‌شده در \fB<path>\fR به‌صورت محلی ذخیره (vendor) می‌کند. پس از پایان کار این دستور، دایرکتوری وندور مشخص‌شده با \fB<path>\fR شامل تمام سورس‌های ریموت از وابستگی‌های تعیین‌شده خواهد بود. مانیفست‌های اضافی فراتر از مانیفست پیش‌فرض را می‌توان با گزینهٔ \fB\-s\fR مشخص کرد.
.sp
پیکربندی لازم برای استفاده از سورس‌های وندورشده، پس از اتمام فرایند وندور توسط \fBcargo vendor\fR در stdout چاپ خواهد شد.
شما باید آن را به فایل پیکربندی Cargo خود، که معمولاً به‌صورت محلی برای بستهٔ فعلی \fB\&.cargo/config.toml\fR است، اضافه کرده یا به آن هدایت (redirect) کنید.
.sp
‏Cargo با سورس‌های وندورشده همانند سورس‌های registry و git به‌صورت فقط‌خواندنی (read\-only) برخورد می‌کند.
اگر قصد دارید یک crate را از یک منبع ریموت تغییر دهید،
از \fB[patch]\fR یا یک وابستگی \fBpath\fR که به رونوشت محلی آن crate اشاره دارد استفاده کنید.
سپس Cargo در ساخت‌های مجدد افزایشی (incremental rebuilds) آن crate را به‌درستی مدیریت خواهد کرد،
چرا که می‌داند دیگر یک وابستگی فقط‌خواندنی نیست.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های وندور (Vendor Options)"
.sp
\fB\-s\fR \fImanifest\fR, 
\fB\-\-sync\fR \fImanifest\fR
.RS 4
یک مانیفست \fBCargo.toml\fR اضافی را برای فضاهای کاری مشخص می‌کند که باید وندور شده و با خروجی همگام‌سازی شوند. این گزینه می‌تواند چندین بار مشخص شود.
.RE
.sp
\fB\-\-no\-delete\fR
.RS 4
هنگام وندور کردن، دایرکتوری \[lq]vendor\[rq] را حذف نمی‌کند، بلکه تمام محتویات موجود در دایرکتوری وندور را نگه می‌دارد.
.RE
.sp
\fB\-\-respect\-source\-config\fR
.RS 4
به‌جای نادیده گرفتن پیش‌فرض پیکربندی \fB[source]\fR در \fB\&.cargo/config.toml\fR، آن را می‌خواند و برای مثال هنگام بارگیری crateها از crates.io از آن استفاده می‌کند.
.RE
.sp
\fB\-\-versioned\-dirs\fR
.RS 4
به‌طور معمول، شمارهٔ نسخه‌ها تنها برای رفع ابهام میان چند نسخه از یک بسته اضافه می‌شوند. این گزینه باعث می‌شود تمامی دایرکتوری‌های موجود در دایرکتوری \[lq]vendor\[rq] دارای شماره نسخه باشند؛ این کار پیگیری تاریخچهٔ بسته‌های وندورشده را در طول زمان آسان‌تر کرده و در صورت تغییر تنها بخشی از بسته‌ها، می‌تواند به کارایی وندور مجدد کمک کند.
.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'فایل lock وجود نداشته باشد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'‏Cargo تلاش کند فایل lock را به دلیل حل وابستگی متفاوت تغییر دهد.
.RE
.sp
این گزینه می‌تواند در محیط‌هایی که در آن‌ها ساخت‌های تکرارپذیر و قطعی (deterministic builds) مورد نیاز است، مانند خطوط لولهٔ CI، استفاده شود.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این پرچم، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با خطا متوقف خواهد شد. با این پرچم، Cargo تلاش می‌کند در صورت امکان بدون شبکه عملیات را ادامه دهد.
.sp
توجه داشته باشید که این ممکن است به حل وابستگی متفاوتی نسبت به حالت برخط منجر شود. Cargo خود را به crateهایی که به‌صورت محلی بارگیری شده‌اند محدود می‌کند، حتی اگر نسخهٔ جدیدتری طبق رونوشت محلی نمایه (index) موجود باشد. دستور \fBcargo\-fetch\fR(1) را برای بارگیری وابستگی‌ها پیش از آفلاین شدن ببینید.
.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 "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرگو. می‌تواند دو بار برای خروجی \[lq]بسیار پرگو\[rq] مشخص شود که شامل اطلاعات اضافه‌تری مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است.
همچنین می‌تواند از طریق \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 را بازنویسی (override) می‌کند. آرگومان باید در ساختار نحوی 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: دستور با موفقیت پایان یافت.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: اجرای Cargo با شکست مواجه شد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'وندور کردن تمام وابستگی‌ها در پوشهٔ محلی \[lq]vendor\[rq]
.sp
.RS 4
.nf
cargo vendor
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'وندور کردن تمام وابستگی‌ها در پوشهٔ محلی \[lq]third\-party/vendor\[rq]
.sp
.RS 4
.nf
cargo vendor third\-party/vendor
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'وندور کردن فضای کاری فعلی و همچنین یک فضای کاری دیگر در \[lq]vendor\[rq]
.sp
.RS 4
.nf
cargo vendor \-s ../path/to/Cargo.toml
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 4.\h'+01'وندور کردن و هدایت پیکربندی‌های لازمِ وندور به یک فایل پیکربندی
.sp
.RS 4
.nf
cargo vendor > path/to/my/cargo/config.toml
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1)