@@ -52,24 +52,24 @@ To use this action in your GitHub workflow, add the following step:
5252
5353## Inputs
5454
55- | Input | Description | Required | Default |
56- | ------------------------ | ----------------------------------------------------------------------------- | -------- | -------------------- |
57- | ` rust-project-path` | Path to the Rust project | No | `'.'` |
58- | `rust-toolchain` | Rust toolchain to use for building and testing (e.g., stable, nightly) | No | `'stable'` |
59- | `target` | The target platform for the Rust compiler | No | `''` |
60- | `install-rust-toolchain` | Whether to install the specified Rust toolchain | No | `true` |
61- | `setup-rust-cache` | Whether to set up Rust caching | No | `true` |
62- | `use-tarpaulin` | Whether to use Tarpaulin for code coverage. If false, only runs tests. | No | `true` |
63- | `use-binstall` | Use `cargo-binstall` for installing tarpaulin. Else uses cargo install. | No | `true` |
64- | `install-binstall` | Installs `cargo-binstall`. If false, assumes it is already available. | No | `true` |
65- | `upload-coverage` | Whether to upload coverage to Codecov (only when using `cargo` and Tarpaulin) | No | `true` |
66- | `codecov-token` | Codecov token for uploading coverage | No | N/A |
67- | `codecov-flags` | Flags to pass to Codecov | No | `'unittests'` |
68- | `codecov-name` | Custom defined name for the upload | No | `'codecov-umbrella'` |
69- | `features` | Space-separated list of features to enable during testing | No | `''` |
70- | `no-default-features` | Disable default features during testing | No | `false` |
71- | `use-cross` | Use cross-rs for testing. If false, use cargo. | No | `false` |
72- | `additional-test-args` | Additional arguments to pass to the cargo test command | No | `''` |
55+ | Input | Description | Required | Default |
56+ | ------------------------ | -------------------------------------------------------------------------------------------------- | -------- | -------------------- |
57+ | ` rust-project-path` | Path to the Rust project | No | `'.'` |
58+ | `rust-toolchain` | Rust toolchain to use for building and testing (e.g., stable, nightly, 1.75.0, nightly-2024-02-08) | No | `'stable'` |
59+ | `target` | The target platform for the Rust compiler | No | `''` |
60+ | `install-rust-toolchain` | Whether to install the specified Rust toolchain | No | `true` |
61+ | `setup-rust-cache` | Whether to set up Rust caching | No | `true` |
62+ | `use-tarpaulin` | Whether to use Tarpaulin for code coverage. If false, only runs tests. | No | `true` |
63+ | `use-binstall` | Use `cargo-binstall` for installing tarpaulin. Else uses cargo install. | No | `true` |
64+ | `install-binstall` | Installs `cargo-binstall`. If false, assumes it is already available. | No | `true` |
65+ | `upload-coverage` | Whether to upload coverage to Codecov (only when using `cargo` and Tarpaulin) | No | `true` |
66+ | `codecov-token` | Codecov token for uploading coverage | No | N/A |
67+ | `codecov-flags` | Flags to pass to Codecov | No | `'unittests'` |
68+ | `codecov-name` | Custom defined name for the upload | No | `'codecov-umbrella'` |
69+ | `features` | Space-separated list of features to enable during testing | No | `''` |
70+ | `no-default-features` | Disable default features during testing | No | `false` |
71+ | `use-cross` | Use cross-rs for testing. If false, use cargo. | No | `false` |
72+ | `additional-test-args` | Additional arguments to pass to the cargo test command | No | `''` |
7373
7474# # Example Workflow
7575
@@ -174,6 +174,27 @@ This action is designed for Rust libraries without binary artifacts.
174174If you're working on a project with binary artifacts, consider using [devops-rust-lightweight-binary][rust-lw-binary],
175175instead, which will invoke this action as part of its workflow if tests are enabled.
176176
177+ # ## Rust Toolchain Examples
178+
179+ You can specify various Rust toolchain versions :
180+
181+ ` ` ` yaml
182+ # Use stable channel
183+ rust-toolchain: 'stable'
184+
185+ # Use nightly channel
186+ rust-toolchain: 'nightly'
187+
188+ # Use specific version
189+ rust-toolchain: '1.75.0'
190+
191+ # Use specific nightly date
192+ rust-toolchain: 'nightly-2024-02-08'
193+
194+ # Use beta channel
195+ rust-toolchain: 'beta'
196+ ` ` `
197+
177198# # License
178199
179200This GitHub Action is released under the [MIT License](LICENSE).
0 commit comments