cargo-yank(1)

定义

cargo-yank - 从索引中删除推送的crate

概要

cargo yank [options] crate@version
cargo yank [options] --version version [crate]

说明

yank命令从服务器的索引中删除先前发布的crate的版本。 该命令不会删除任何数据，该crate仍可通过注册中心的下载链接进行下载。

请注意，crate的已锁死版本仍然能够下载使用。而Cargo将不允许新的crate使用锁死版本。

该命令要求使用 --token 选项或使用 cargo-login(1)进行认证。

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

选项

Yank 选项

--vers version
--version version
yank 或 un-yank 的版本。
--undo
撤消yank，将版本放回到索引中。
--token token
认证时要使用的 API token。这将覆盖存储在证书文件中的令牌(由 cargo-login(1))。

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

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

显示选项

-v
--verbose
详细输出。 可以指定两次以 "非常详细" 输出，包含附加内容，如依赖警告和构建脚本输出。 也可以用 term.verbose 配置。
-q
--quiet
不打印cargo日志信息。 也可以用 term.quiet 配置。
--color when
使用彩色输出。有效值:

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

也可以用 term.color 配置。

常规选项

+toolchain
如果Cargo已经和rustup一起安装，并且cargo的第一个参数为 +, 它将被解释为Rustup工具链的名称 (比如 +stable 或 +nightly). 见 rustup 文档 了解相关工具链覆盖的详细信息。
--config KEY=VALUE or PATH
覆盖Cargo配置值。参数应是TOML语法中的 KEY=VALUE, 或作为一个额外的配置文件的路径提供。这个标志可以被多次指定。 见 command-line 覆盖部分 了解详细信息。
-h
--help
打印帮助信息。
-Z flag
Cargo 不稳定 (每日构建) 的标志。 运行 cargo -Z help 获得详细信息。

ENVIRONMENT

见 参考 以了解Cargo所读取环境变量的详情。

退出状态

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

示例

  1. 在索引Yank crate:

    cargo yank foo@1.0.7

参阅

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