mirror of
https://github.com/actions-rs/cargo.git
synced 2024-12-21 23:25:51 +02:00
Describe why this Action should be used instead of run step (closes #72)
This commit is contained in:
parent
6c501d70cc
commit
bcbe7625d8
1 changed files with 29 additions and 1 deletions
30
README.md
30
README.md
|
@ -12,8 +12,9 @@ command on a Rust language project.
|
||||||
**Table of Contents**
|
**Table of Contents**
|
||||||
|
|
||||||
* [Example workflow](#example-workflow)
|
* [Example workflow](#example-workflow)
|
||||||
|
* [Use cases](#use-cases)
|
||||||
* [Inputs](#inputs)
|
* [Inputs](#inputs)
|
||||||
* [Virtual environments](#virtual-environments)
|
* [Toolchain](#toolchain)
|
||||||
* [Cross-compilation](#cross-compilation)
|
* [Cross-compilation](#cross-compilation)
|
||||||
* [License](#license)
|
* [License](#license)
|
||||||
* [Contribute and support](#contribute-and-support)
|
* [Contribute and support](#contribute-and-support)
|
||||||
|
@ -31,6 +32,9 @@ jobs:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions-rs/toolchain@v1
|
||||||
|
with:
|
||||||
|
toolchain: stable
|
||||||
- uses: actions-rs/cargo@v1
|
- uses: actions-rs/cargo@v1
|
||||||
with:
|
with:
|
||||||
command: build
|
command: build
|
||||||
|
@ -39,6 +43,30 @@ jobs:
|
||||||
|
|
||||||
See [additional recipes here](https://github.com/actions-rs/meta).
|
See [additional recipes here](https://github.com/actions-rs/meta).
|
||||||
|
|
||||||
|
## Use cases
|
||||||
|
|
||||||
|
Note that this Action is not required usually
|
||||||
|
and you can just use [`run`](https://help.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)
|
||||||
|
step instead as in example below:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
jobs:
|
||||||
|
build_and_test:
|
||||||
|
name: Rust project
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions-rs/toolchain@v1
|
||||||
|
with:
|
||||||
|
toolchain: stable
|
||||||
|
- run: cargo build --release --all-features
|
||||||
|
```
|
||||||
|
|
||||||
|
Why would you want to use this Action instead:
|
||||||
|
|
||||||
|
1. Transparent `cross` installation and execution with `use-cross: true` input enabled
|
||||||
|
2. Warnings and errors issued by `cargo` will be displayed in GitHub UI
|
||||||
|
|
||||||
## Inputs
|
## Inputs
|
||||||
|
|
||||||
| Name | Required | Description | Type | Default |
|
| Name | Required | Description | Type | Default |
|
||||||
|
|
Loading…
Reference in a new issue