CARGO-FETCH(1)              General Commands Manual             CARGO-FETCH(1)

نام (NAME)
       cargo-fetch - دریافت وابستگی‌های یک بسته از شبکه

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

توضیحات (DESCRIPTION)
       اگر فایل Cargo.lock در دسترس باشد، این دستور اطمینان حاصل می‌کند که تمام
       وابستگی‌های git و/یا وابستگی‌های رجیستری بارگیری شده و به صورت محلی در
       دسترس هستند. دستورات بعدی Cargo پس از اجرای یک cargo fetch قادر خواهند
       بود به صورت آفلاین اجرا شوند، مگر اینکه فایل قفل تغییر کند.

       اگر فایل قفل در دسترس نباشد، این دستور پیش از دریافت وابستگی‌ها، فایل
       قفل را ایجاد خواهد کرد.

       اگر --target مشخص نشده باشد، تمام وابستگی‌های هدف دریافت می‌شوند.

       همچنین افزونهٔ cargo-prefetch <https://crates.io/crates/cargo-prefetch>
       را ببینید که دستوری برای بارگیری crateهای پرکاربرد اضافه می‌کند. اگر قصد
       دارید از Cargo بدون شبکه با پرچم --offline استفاده کنید، این افزونه
       می‌تواند مفید باشد.

گزینه‌ها (OPTIONS)
   گزینه‌های واکشی (Fetch Options)
       --target triple
           دریافت برای معماری هدف مشخص‌شده. این پرچم می‌تواند چندین بار مشخص
           شود. مقدار پیش‌فرض، همهٔ معماری‌ها است. ساختار کلی triple به صورت
           <arch><sub>-<vendor>-<sys>-<abi> است.

           مقادیر ممکن:

           •   هر هدف پشتیبانی‌شده در rustc --print target-list.

           •   "host-tuple"، که در داخل با هدف سیستم میزبان جایگزین خواهد شد.
               این گزینه به‌ویژه هنگامی مفید است که در حال کامپایل متقابل برخی
               از crateها هستید و نمی‌خواهید ماشین میزبان خود را به عنوان یک
               هدف مشخص کنید (به عنوان مثال، یک xtask در یک پروژهٔ مشترک که
               ممکن است توسط چندین میزبان مختلف روی آن کار شود).

           •   مسیری به یک مشخصات سفارشی هدف. برای اطلاعات بیشتر Custom Target
               Lookup Path
               <https://doc.rust-lang.org/rustc/targets/custom.html#custom-target-lookup-path>
               را ببینید.

           این مورد را می‌توان با مقدار پیکربندی build.target
           <https://doc.rust-lang.org/cargo/reference/config.html> نیز مشخص
           کرد.

           توجه داشته باشید که تعیین این پرچم باعث می‌شود Cargo در حالت متفاوتی
           اجرا شود که در آن مصنوعات هدف در یک دایرکتوری جداگانه قرار می‌گیرند.
           برای جزئیات بیشتر به مستندات build cache
           <https://doc.rust-lang.org/cargo/reference/build-cache.html> مراجعه
           کنید.

   گزینه‌های نمایش (Display Options)
       -v, --verbose
           استفاده از خروجی پرگو (verbose). می‌تواند دو بار برای خروجی «بسیار
           پرگو» مشخص شود که شامل خروجی‌های اضافی مانند هشدارهای وابستگی و
           خروجی اسکریپت ساخت است.  همچنین می‌تواند با مقدار پیکربندی
           term.verbose
           <https://doc.rust-lang.org/cargo/reference/config.html> مشخص شود.

       -q, --quiet
           پیام‌های لاگ cargo را چاپ نمی‌کند.  همچنین می‌تواند با مقدار پیکربندی
           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 فایل Cargo.toml را در
           دایرکتوری جاری یا هر دایرکتوری والد جستجو می‌کند.

       --locked
           تأیید می‌کند که دقیقاً از همان وابستگی‌ها و نسخه‌هایی استفاده می‌شود که
           فایل Cargo.lock موجود در ابتدا با آن‌ها تولید شده است. Cargo در صورت
           بروز هر یک از شرایط زیر با یک خطا خارج خواهد شد:

           •   فایل قفل موجود نباشد.

           •   برنامه Cargo به دلیل تفکیک و حل وابستگی متفاوت، برای تغییر فایل
               قفل تلاش کند.

           می‌تواند در محیط‌هایی که ساخت‌های قطعی و تکرارپذیر مورد نظر است، مانند
           خطوط لوله CI، استفاده شود.

       --offline
           از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این پرچم،
           اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد،
           با یک خطا متوقف خواهد شد. با این پرچم، Cargo در صورت امکان تلاش
           خواهد کرد بدون شبکه پیش برود.

           توجه داشته باشید که این ممکن است به حل وابستگی متفاوتی نسبت به حالت
           آنلاین منجر شود. Cargo خود را به crateهایی که به صورت محلی بارگیری
           شده‌اند محدود می‌کند، حتی اگر نسخهٔ جدیدتری در رونوشت محلی نمایه وجود
           داشته باشد.

           همچنین می‌تواند با مقدار پیکربندی net.offline
           <https://doc.rust-lang.org/cargo/reference/config.html> مشخص شود.

       --frozen
           معادل مشخص کردن هم‌زمان --locked و --offline است.

   گزینه‌های عمومی (Common Options)
       +toolchain
           اگر Cargo با rustup نصب شده باشد و اولین آرگومان به cargo با + آغاز
           شود، به عنوان یک نام زنجیره ابزار rustup تفسیر خواهد شد (مانند
           +stable یا +nightly).  برای اطلاعات بیشتر در مورد چگونگی کارکرد
           بازنویسی‌های زنجیره ابزار، به مستندات rustup
           <https://rust-lang.github.io/rustup/overrides.html> مراجعه کنید.

       --config KEY=VALUE یا PATH
           یک مقدار پیکربندی Cargo را بازنویسی می‌کند. آرگومان باید در ساختار
           نحوی TOML به صورت KEY=VALUE باشد، یا به عنوان یک مسیر به یک فایل
           پیکربندی اضافی ارائه شود. این پرچم می‌تواند چندین بار مشخص شود.
           برای اطلاعات بیشتر بخش command-line overrides
           <https://doc.rust-lang.org/cargo/reference/config.html#command-line-overrides>
           را ببینید.

       -C PATH
           دایرکتوری کاری فعلی را قبل از اجرای هر عملیات مشخص‌شده تغییر می‌دهد.
           این مورد بر مواردی مانند محل پیش‌فرضی که cargo در آن به دنبال
           مانیفست پروژه (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. برای جزئیات
           دستور cargo -Z help را اجرا کنید.

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

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

       •   101: اجرای Cargo با خطا مواجه شد.

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

               cargo fetch

همچنین ببینید (SEE ALSO)
       cargo(1), cargo-update(1), cargo-generate-lockfile(1)

                                                                CARGO-FETCH(1)