cargo-msrv

此软件包可以帮助您找到软件包的最小支持的 Rust 版本。

在本说明中，您将找到所有入门信息。您可以在 cargo-msrv 书籍 中找到更详细的解释。

安装

cargo (crates.io 源)

cargo (git 源)

cargo-binstall

Arch Linux 额外仓库

• pacman -S cargo-msrv

Docker

您可以使用以下命令通过 Docker 构建 和 运行

• $docker build -tcargo-msrv .
• $docker run -t -v "$(pwd)/Cargo.toml":/app/Cargo.toml cargo-msrv

Docker镜像也可在Docker Hub上找到。

先决条件

使用Rustup是运行cargo msrv (find)和cargo msrv verify命令所必需的。

预览

用法

• cargo msrv find或cargo msrv find --linear以找到当前工作目录中Cargo项目的MSRV。
• cargo msrv --path <dir> find以找到指定目录<dir>中Cargo项目的MSRV。
• cargo msrv find -- <command>将<command>用作兼容性检查，以判断Rust版本是否兼容。此命令应可以通过rustup作为rustup run <toolchain> <command>运行。
  • 示例：cargo msrv find -- cargo check --tests。
• cargo msrv verify以验证由crate作者指定的MSRV
  • crate作者可以使用'Cargo.toml'清单中的package.rust-version（Rust >=1.56）或package.metadata.msrv键来指定MSRV。有关更详细的说明，请参阅书籍。
• cargo msrv list以列出由其作者指定的依赖项的MSRV
• cargo msrv show以显示当前指定的MSRV

有关支持的（子）命令的更详细说明，请参阅cargo-msrv书籍中的命令章节。

选项

Find your Minimum Supported Rust Version!

Usage: cargo msrv [OPTIONS] <COMMAND>

Commands:
  find    Find the MSRV
  list    Display the MSRV's of dependencies
  set     Set the MSRV of the current crate to a given Rust version
  show    Show the MSRV of your crate, as specified in the Cargo manifest
  verify  Verify whether the MSRV is satisfiable
  help    Print this message or the help of the given subcommand(s)

Options:
      --path <Crate Directory>
          Path to cargo project directory

      --manifest-path <Cargo Manifest>
          Path to cargo manifest file

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

User output options:
      --output-format <FORMAT>
          Set the format of user output

          [default: human]

          Possible values:
          - human:   Progress bar rendered to stderr
          - json:    Json status updates printed to stdout
          - minimal: Minimal output, usually just the result, such as the MSRV or whether verify succeeded or failed

      --no-user-output
          Disable user output

Debug output options:
      --no-log
          Disable logging

      --log-target <LOG TARGET>
          Specify where the program should output its logs

          [default: file]
          [possible values: file, stdout]

      --log-level <LEVEL>
          Specify the severity of logs which should be

          [default: info]
          [possible values: trace, debug, info, warn, error]


            You may provide a custom compatibility `check` command as the last argument (only
            when this argument is provided via the double dash syntax, e.g. `$ cargo msrv -- custom
            command`.
            This custom check command will then be used to validate whether a Rust version is
            compatible.
            A custom `check` command should be runnable by rustup, as they will be passed on to
            rustup like so: `rustup run <toolchain> <COMMAND...>`. NB: You only need to provide the
            <COMMAND...> part.

            By default, the custom check command is `cargo check`.

JSON格式

通过提供 --output-format 标志可以启用 JSON 输出：cargo msrv find --output-format. 事件以 JSON 行的形式打印。事件类型由 type 键指示。