Install Rust Toolchain

This GitHub Action installs a Rust toolchain using rustup. It is designed for one-line concise usage and good defaults.

Example workflow

name: test suite
on: [push, pull_request]

jobs:
  test:
    name: cargo test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: dtolnay/rust-toolchain@stable
      - run: cargo test --all-features

The selection of Rust toolchain is made based on the particular @rev of this Action being requested. For example "dtolnay/rust-toolchain@nightly" pulls in the nightly Rust toolchain, while "dtolnay/rust-toolchain@1.42.0" pulls in 1.42.0.

Toolchain File

The Rust toolchain file is supported. If present it will be used to populate toolchain, components and targets parameters. If those parameters are explicitly set as inputs to the action, they will take precedence over the values in the toolchain file. To use only the toolchain file for parameters, pass no inputs and set the @rev to @master.

Inputs

All inputs are optional.

Name	Description
`toolchain`	Rustup toolchain specifier e.g. `stable`, `nightly`, `1.42.0`, `nightly-2022-01-01`. Important: the default is to match the @rev as described above. When passing an explicit `toolchain` as an input instead of @rev, you'll want to use "dtolnay/rust-toolchain@master" as the revision of the action.
`targets`	Comma-separated string of additional targets to install e.g. `wasm32-unknown-unknown`
`components`	Comma-separated string of additional components to install e.g. `clippy, rustfmt`

Outputs

Name	Description
`toolchain`	Rustup's name for the selected version of the toolchain. "1.62.0"
`cachekey`	A short hash of the rustc version, appropriate for use as a cache key. ex "20220627a831"

Toolchain expressions

The following forms are available for projects that use a sliding window of compiler support.

     # Installs the most recent stable toolchain as of the specified time
     # offset, which may be written in years, months, weeks, or days.
  - uses: dtolnay/rust-toolchain@master
    with:
      toolchain: stable 18 months ago

     # Installs the stable toolchain which preceded the most recent one by
     # the specified number of minor versions.
  - uses: dtolnay/rust-toolchain@master
    with:
      toolchain: stable minus 8 releases

License

The scripts and documentation in this project are released under the MIT License.

3 KiB Raw Blame History