cargo-owner(1)

名称

cargo-owner - 管理一个 crate 在 registry 上的所有者

概要

cargo owner [options] --add login [crate]
cargo owner [options] --remove login [crate]
cargo owner [options] --list [crate]

描述

该命令会修改一个 crate 在 registry 上的所有者。crate 的所有者可以上传新版本和 yank 旧的版本。非团队成员的所有者(non-team owners)也可以修改所有者，所以授权时要小心。

这个命令需要你经过身份验证，要么通过提供 --token 选项，要么使用 cargo-login(1) 命令。

如果没有指定 crate 的名称，则会使用当前目录下的包的名字。

从 the reference 中获取更多关于所有者和发布的知识。

选项

所有者选项

-a

--add login...

添加指定的用户或团队为所有者。

-r

--remove login...

在所有者中移除所指定的用户或团队。

-l

--list

展示一个 crate 的全部所有者。

--token token

用于身份验证的 API token 。这会覆盖保存在 credentials file (由 cargo-login(1) 命令创建) 中的 token。

Cargo config 环境变量也可以覆盖 credentials file 中的 token。crates.io 的 token 可以用 CARGO_REGISTRY_TOKEN 环境变量来指定。其他 registry 的 token 可以用 CARGO_REGISTRIES_NAME_TOKEN 环境变量指定，其中 NAME 是 registry 名字的全大写字母表示。

--index index

使用的注册机构的 index 地址。

--registry registry

使用的注册机构 (registry) 的名字。注册机构定义在 Cargo config 文件 中. 如果没有指定就使用默认的注册机构，其定义在 registry.default 字段中，该值的默认值为 crates-io 。

显示选项

-v

--verbose

进行 verbose 输出。可以指定两遍来开启 "very verbose" 模式，输出更多的额外信息，像是依赖项的警告和构建脚本的输出信息。 也可以通过 term.verbose 配置选项 来指定。

-q

--quiet

不打印 cargo log 信息。 也可以通过 term.quiet 配置选项来指定。

--color when

控制*何时*使用彩色输出。可选值有:

• auto (默认值): 自动检测终端是否支持彩色输出。
• always: 总是显示彩色。
• never: 从不显示彩色。

也可以在 term.color 配置选项中设置。

通用选项

+toolchain

如果 Cargo 由 rustup 安装，那么 cargo 后第一个以 + 开头的参数会被认为是 rustup toolchain 名字(例如 +stable 或 +nightly)。 查看 rustup documentation 了解 toolchain overrides 如何工作。

--config KEY=VALUE or PATH

覆盖一个 Cargo 配置的值。参数应该是一个 TOML 语法的 KEY=VALUE，或者提供一个路径来指向一个额外的配置文件 (configuration file)。 这个标记可以指定多次。 参考 command-line overrides 一节 获取更多信息。

-h

--help

打印帮助信息。

-Z flag

不稳定 (nightly-only) 的标志。 执行 cargo -Z help 获取详细信息。

环境

查看 the reference 获取 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)