toolchain/README.md

2.0 KiB

rust-toolchain Action

MIT licensed Gitter

This GitHub Action installs Rust toolchain.

Optionally it can set installed toolchain as a default and as an override for current directory.

Example workflow

on: [push]

name: build

jobs:
  check:
    name: Rust project
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@master
      - name: Install nightly
        uses: actions-rs/toolchain@v1
        with:
            toolchain: nightly
            override: true

      # `cargo check` command here will use installed `nightly`
      # as it set as an "override" for current directory

      - name: Run cargo check
        uses: actions-rs/cargo@v1
        with:
          command: check

See additional recipes here.

Inputs

  • toolchain (required): Toolchain name, see rustup page for details.
    Examples: stable, nightly, nightly-2019-04-20
  • target: Additionally install specific target for this toolchain (ex. x86_64-apple-darwin)
  • default: Set installed toolchain as default (executes rustup toolchain default {toolchain})
  • override: Set installed toolchain as an override for current directory

Components

If you are going to install clippy, rustfmt or any other rustup component, it might not be available in latest nightly build; check out the actions-rs/components-nightly Action, which makes this process much easier.

Notes

As rustup is not installed by default for macOS environments at the moment (2019-09-13), this Action will try its best to install it before any other operations.