3
0
Fork 0
mirror of https://github.com/dtolnay/rust-toolchain.git synced 2024-11-22 00:39:31 +01:00
Concise GitHub Action for installing a Rust toolchain
Find a file
2022-07-14 11:29:46 -07:00
.github Add a funding file 2022-06-24 12:05:25 -07:00
scripts Fix default components for miri 2022-06-29 10:35:00 -07:00
action.yml Add icon+color branding for Action 2022-06-24 11:48:26 -07:00
LICENSE Add MIT license 2021-10-09 02:41:20 +01:00
README.md Mention what rev to use when passing toolchain 2022-07-14 11:29:46 -07:00

Install Rust Toolchain

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

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.

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.
target Additional target support to install e.g. wasm32-unknown-unknown
components Comma-separated string of additional components to install e.g. clippy, rustfmt

License

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