cargo-owner(1)

名称

cargo-owner — 管理注册表上 crate 的所有者

概要

cargo owner [选项] --add 登录名 [crate]
cargo owner [选项] --remove 登录名 [crate]
cargo owner [选项] --list [crate]

描述

此命令将修改注册表上 crate 的所有者。crate 的所有者可以上传新版本和撤回旧版本。非团队所有者也可以修改所有者集合，因此请小心！

此命令要求您使用 --token 选项或使用 cargo-login(1) 进行身份验证。

如果未指定 crate 名称，它将使用当前目录中的包名称。

有关所有者和发布的更多信息，请参阅参考文档。

选项

所有者选项

-a
--add 登录名…
邀请给定的用户或团队作为所有者。
-r
--remove 登录名…
删除给定的用户或团队作为所有者。
-l
--list
列出 crate 的所有者。
--token token
身份验证时使用的 API 令牌。这会覆盖存储在凭据文件中的令牌（该文件由 cargo-login(1) 创建）。

可以使用 Cargo 配置环境变量来覆盖存储在凭据文件中的令牌。crates.io 的令牌可以使用 CARGO_REGISTRY_TOKEN 环境变量指定。其他注册表的令牌可以使用 CARGO_REGISTRIES_NAME_TOKEN 形式的环境变量指定，其中 NAME 是注册表的名称，全部大写。

--index 索引
要使用的注册表索引的 URL。
--registry 注册表
要使用的注册表的名称。注册表名称在 Cargo 配置文件中定义。如果未指定，则使用默认注册表，该注册表由 registry.default 配置键定义，默认值为 crates-io。

显示选项

-v
--verbose
使用详细输出。可以指定两次以获得“非常详细”的输出，其中包括额外的输出，例如依赖项警告和构建脚本输出。也可以使用 term.verbose 配置值指定。
-q
--quiet
不打印 cargo 日志消息。也可以使用 term.quiet 配置值指定。
--color when
控制何时使用彩色输出。有效值

  • auto (默认): 自动检测终端上是否可用颜色支持。
  • always: 始终显示颜色。
  • never: 从不显示颜色。

也可以使用 term.color 配置值指定。

通用选项

+工具链
如果 Cargo 已使用 rustup 安装，并且 cargo 的第一个参数以 + 开头，则它将被解释为 rustup 工具链名称（例如 +stable 或 +nightly）。有关工具链覆盖如何工作的更多信息，请参阅 rustup 文档。
--config KEY=VALUE 或 PATH
覆盖 Cargo 配置值。参数应采用 KEY=VALUE 的 TOML 语法，或作为额外配置文件的路径提供。此标志可以指定多次。有关更多信息，请参阅命令行覆盖部分。
-C PATH
在执行任何指定操作之前更改当前工作目录。这会影响诸如 cargo 默认查找项目清单 (Cargo.toml) 的位置，以及搜索以发现 .cargo/config.toml 的目录等。此选项必须出现在命令名称之前，例如 cargo -C path/to/my-project build。

此选项仅在 nightly channel 上可用，并且需要 -Z unstable-options 标志才能启用（请参阅 #10098）。

-h
--help
打印帮助信息。
-Z flag
Cargo 的不稳定（仅限 nightly）标志。运行 cargo -Z help 以获取详细信息。

环境变量

有关 Cargo 读取的环境变量的详细信息，请参阅参考文档。

退出状态

  • 0：Cargo 成功。
  • 101：Cargo 未能完成。

示例

  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)