CARGO-OWNER(1) General Commands Manual CARGO-OWNER(1) نام (NAME) cargo-owner - مدیریت مالکان یک کریت در رجیستری Crates.io خلاصه دستور (SYNOPSIS) cargo owner [گزینه‌ها] --add login [کریت] cargo owner [گزینه‌ها] --remove login [کریت] cargo owner [گزینه‌ها] --list [کریت] توضیحات (DESCRIPTION) این دستور مالکان یک کریت در رجیستری را ویرایش می‌کند. مالکان یک کریت می‌توانند نسخه‌های جدید را بارگذاری کرده و نسخه‌های قدیمی را غیرفعال (yank) کنند. مالکان غیرتیمی نیز می‌توانند فهرست مالکان را تغییر دهند، بنابراین احتیاط کنید! برای اجرای این دستور باید با گزینه --token یا با استفاده از cargo-login(1) احراز هویت شده باشید. اگر نام کریت مشخص نشود، از نام بسته در دایرکتوری جاری استفاده خواهد شد. برای اطلاعات بیشتر درباره مالکان و انتشار، مرجع کارگو را ببینید. گزینه‌ها (OPTIONS) گزینه‌های مالک (Owner Options) -a, --add login… دعوت از کاربر یا تیم مشخص‌شده به عنوان مالک. -r, --remove login… حذف کاربر یا تیم مشخص‌شده از فهرست مالکان. -l, --list فهرست کردن مالکان یک کریت. --token token توکن API مورد استفاده هنگام احراز هویت. این مقدار توکن ذخیره‌شده در فایل اطلاعات کاربری (credentials که توسط cargo-login(1) ایجاد می‌شود) را لغو و جایگزین می‌کند. متغیرهای محیطی پیکربندی کارگو را می‌توان برای لغو توکن‌های ذخیره‌شده در فایل اطلاعات کاربری استفاده کرد. توکن برای crates.io را می‌توان با متغیر محیطی CARGO_REGISTRY_TOKEN مشخص کرد. توکن‌های سایر رجیستری‌ها را می‌توان با متغیرهای محیطی به شکل CARGO_REGISTRIES_NAME_TOKEN مشخص نمود که در آن NAME نام رجیستری با حروف بزرگ است. --index index نشانی اینترنتی (URL) ایندکس رجیستری مورد استفاده. --registry registry نام رجیستری مورد استفاده. نام‌های رجیستری در فایل‌های پیکربندی کارگو تعریف می‌شوند. اگر مشخص نشود، از رجیستری پیش‌فرض استفاده می‌شود که توسط کلید پیکربندی registry.default تعریف شده و مقدار پیش‌فرض آن crates-io است. گزینه‌های نمایش (Display Options) -v, --verbose استفاده از خروجی با جزئیات. برای خروجی بسیار پرجزئیات می‌توان دو بار مشخص کرد که شامل خروجی‌های اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت می‌شود. همچنین می‌توان آن را با مقدار پیکربندی term.verbose در تنظیمات کارگو مشخص نمود. -q, --quiet عدم چاپ پیام‌های گزارش (log) کارگو. همچنین می‌توان آن را با مقدار پیکربندی term.quiet در تنظیمات کارگو مشخص نمود. --color when کنترل زمان استفاده از خروجی رنگی. مقادیر معتبر: • auto (پیش‌فرض): تشخیص خودکار پشتیبانی از رنگ در ترمینال. • always: نمایش همیشگی رنگ‌ها. • never: عدم نمایش رنگ‌ها در هیچ حالتی. همچنین می‌توان آن را با مقدار پیکربندی term.color در تنظیمات کارگو مشخص نمود. گزینه‌های عمومی (Common Options) +toolchain اگر کارگو با rustup نصب شده باشد و نخستین آرگومان cargo با + شروع شود، به عنوان نام زنجیره ابزار (toolchain) در rustup تفسیر می‌شود (مانند +stable یا +nightly). برای اطلاعات بیشتر درباره نحوه کار بازنویسی زنجیره ابزار، مستندات rustup را ببینید. --config KEY=VALUE or PATH بازنویسی مقدار پیکربندی کارگو. آرگومان باید در ساختار نحوی TOML به صورت KEY=VALUE یا به عنوان مسیر یک فایل پیکربندی اضافی ارائه شود. این گزینه را می‌توان چندین بار مشخص کرد. برای اطلاعات بیشتر بخش لغوهای خط فرمان را ببینید. -C PATH تغییر دایرکتوری کاری جاری قبل از اجرای هرگونه عملیات مشخص‌شده. این گزینه بر مواردی مانند محل جستجوی پیش‌فرض کارگو برای مانیفست پروژه (Cargo.toml) و دایرکتوری‌های جستجو برای یافتن .cargo/config.toml تأثیر می‌گذارد. این گزینه باید قبل از نام دستور قرار گیرد، به عنوان مثال cargo -C path/to/my-project build. این گزینه فقط در کانال nightly در دسترس است و برای فعال‌سازی به پرچم -Z unstable-options نیاز دارد (به #10098 مراجعه کنید). -h, --help چاپ اطلاعات راهنما. -Z flag پرچم‌های ناپایدار (فقط nightly) برای کارگو. برای جزئیات cargo -Z help را اجرا کنید. محیط (ENVIRONMENT) برای جزئیات درباره متغیرهای محیطی که کارگو می‌خواند، مرجع کارگو را ببینید. وضعیت خروج (EXIT STATUS) • 0: کارگو با موفقیت اجرا شد. • 101: کارگو در تکمیل عملیات ناموفق بود. مثال‌ها (EXAMPLES) 1. فهرست کردن مالکان یک بسته: cargo owner --list foo 2. دعوت از یک مالک برای بسته: cargo owner --add username foo 3. حذف یک مالک از بسته: cargo owner --remove username foo همچنین ببینید (SEE ALSO) cargo(1), cargo-login(1), cargo-publish(1) CARGO-OWNER(1)