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

cargo-login - ورود به یک رجیستری

cargo login [گزینه‌ها] [-- آرگومان‌ها]

این دستور یک ارائه‌دهندهٔ اعتبارنامه (credential provider) را برای ذخیرهٔ یک توکن اجرا می‌کند، به‌طوری که دستورهای نیازمند احراز هویت، مانند cargo-publish(1)، به‌صورت خودکار احراز هویت شوند.

تمام آرگومان‌های پس از دو خط تیره (--) به ارائه‌دهندهٔ اعتبارنامه ارسال می‌شوند.

برای ارائه‌دهندهٔ اعتبارنامهٔ پیش‌فرض cargo:token، توکن در $CARGO_HOME/credentials.toml ذخیره می‌شود. مقدار پیش‌فرض CARGO_HOME دایرکتوری .cargo در دایرکتوری خانگی شما است.

اگر برای یک رجیستری ارائه‌دهندهٔ اعتبارنامه‌ای مشخص شده باشد، از آن استفاده خواهد شد. در غیر این صورت، ارائه‌دهنده‌های مشخص‌شده در مقدار پیکربندی registry.global-credential-providers به‌ترتیب از انتهای فهرست بررسی و امتحان خواهند شد.

مقدار token از ورودی استاندارد (stdin) خوانده خواهد شد.

توکن API برای crates.io را می‌توان از https://crates.io/me دریافت کرد.

در حفظ و محرمانگی توکن دقت کنید؛ این توکن نباید با هیچ‌کس دیگری به اشتراک گذاشته شود.

--registry registry

نام رجیستری مورد استفاده. نام‌های رجیستری در فایل‌های پیکربندی Cargo https://doc.rust-lang.org/cargo/reference/config.html تعریف می‌شوند. در صورت عدم تعیین، از رجیستری پیش‌فرض استفاده می‌شود که توسط کلید پیکربندی registry.default مشخص شده و مقدار پیش‌فرض آن crates-io است.

-v, --verbose

استفاده از خروجی پرجزئیات. برای خروجی “بسیار پرجزئیات” که شامل اطلاعات اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است، می‌تواند دو بار مشخص شود. همچنین می‌توان آن را با مقدار پیکربندی term.verbose https://doc.rust-lang.org/cargo/reference/config.html نیز تنظیم کرد.

-q, --quiet

پیام‌های لاگ کارگو را چاپ نمی‌کند. همچنین می‌تواند با مقدار پیکربندی 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 نیز تعیین کرد.

+toolchain

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

--config KEY=VALUE or PATH

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

-C PATH

دایرکتوری کاری جاری را پیش از اجرای هرگونه عملیات مشخص‌شده تغییر می‌دهد. این امر مواردی چون محل جستجوی پیش‌فرض کارگو برای مانیفست پروژه (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 را اجرا کنید.

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

•0: کارگو با موفقیت اجرا شد.
•101: کارگو نتوانست عملیات را تکمیل کند.

1.ذخیرهٔ توکن برای رجیستری پیش‌فرض: 
cargo login
2.ذخیرهٔ توکن برای یک رجیستری خاص: 
cargo login --registry my-registry

cargo(1), cargo-logout(1), cargo-publish(1)