#automatic #update #subcommand #version #updating #tool #command-line-tool

app cargo-toolchainer

A simple cli tool for automatically updating your rust-toolchain.toml file

1 unstable release

0.2.0 Jul 6, 2024
0.1.0 Jul 1, 2024

#256 in Cargo plugins

MIT/Apache

20KB
223 lines

cargo-toolchainer

Crates.io Version Crates.io MSRV GitHub Actions Workflow Status

cargo-toolchainer is a simple CLI tool to update the channel in your rust-toolchain.toml file.

Motivation

Rust's rust-toolchain.toml file is used widely to lock down the Rust version for projects, however, often these projects will want to upgrade their rust version eventually. In most cases, this is a manual process, and manual processess are subject to error. What this process needs is to be triggered automatically and have manual oversight. This tool aims to be a component in the automatic portion of that workflow.

Installation

Install with cargo install --locked cargo-toolchainer. This tool requires at least rustc 1.74.1 to build and install.

Usage

Once installed, run with cargo toolchainer update to automatically detect the channel in your rust-toolchain.toml file and update it to the newest version.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~7–19MB
~259K SLoC