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

cargo-owner - مدیریت مالکان یک کریت در رجیستری Crates.io

cargo owner [گزینه‌ها] --add login [کریت]
cargo owner [گزینه‌ها] --remove login [کریت]
cargo owner [گزینه‌ها] --list [کریت]

این دستور مالکان یک کریت در رجیستری را ویرایش می‌کند. مالکان یک کریت می‌توانند نسخه‌های جدید را بارگذاری کرده و نسخه‌های قدیمی را غیرفعال (yank) کنند. مالکان غیرتیمی نیز می‌توانند فهرست مالکان را تغییر دهند، بنابراین احتیاط کنید!

برای اجرای این دستور باید با گزینه --token یا با استفاده از cargo-login(1) احراز هویت شده باشید.

اگر نام کریت مشخص نشود، از نام بسته در دایرکتوری جاری استفاده خواهد شد.

برای اطلاعات بیشتر درباره مالکان و انتشار، مرجع کارگو https://doc.rust-lang.org/cargo/reference/publishing.html#cargo-owner را ببینید.

-a, --add login…

دعوت از کاربر یا تیم مشخص‌شده به عنوان مالک.

-r, --remove login…

حذف کاربر یا تیم مشخص‌شده از فهرست مالکان.

-l, --list

فهرست کردن مالکان یک کریت.

--token token

توکن API مورد استفاده هنگام احراز هویت. این مقدار توکن ذخیره‌شده در فایل اطلاعات کاربری (credentials که توسط cargo-login(1) ایجاد می‌شود) را لغو و جایگزین می‌کند.

متغیرهای محیطی پیکربندی کارگو https://doc.rust-lang.org/cargo/reference/config.html را می‌توان برای لغو توکن‌های ذخیره‌شده در فایل اطلاعات کاربری استفاده کرد. توکن برای crates.io را می‌توان با متغیر محیطی CARGO_REGISTRY_TOKEN مشخص کرد. توکن‌های سایر رجیستری‌ها را می‌توان با متغیرهای محیطی به شکل CARGO_REGISTRIES_NAME_TOKEN مشخص نمود که در آن NAME نام رجیستری با حروف بزرگ است.

--index index

نشانی اینترنتی (URL) ایندکس رجیستری مورد استفاده.

--registry registry

نام رجیستری مورد استفاده. نام‌های رجیستری در فایل‌های پیکربندی کارگو 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

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

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

--config KEY=VALUE or PATH

بازنویسی مقدار پیکربندی کارگو. آرگومان باید در ساختار نحوی 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 -Z help را اجرا کنید.

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

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

1.فهرست کردن مالکان یک بسته: 
cargo owner --list foo
2.دعوت از یک مالک برای بسته: 
cargo owner --add username foo
3.حذف یک مالک از بسته: 
cargo owner --remove username foo

cargo(1), cargo-login(1), cargo-publish(1)