2021-10-08 04:51:26 +02:00
|
|
|
# Fast `cargo install` action
|
|
|
|
|
|
|
|
|
|
This GitHub Action installs a Rust crate using precompiled signed binaries built
|
|
|
|
|
on GitHub and hosted as GitHub release artifacts.
|
|
|
|
|
|
|
|
|
|
## Example workflow
|
|
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
name: test suite
|
|
|
|
|
on: [push, pull_request]
|
|
|
|
|
|
|
|
|
|
jobs:
|
|
|
|
|
expand:
|
|
|
|
|
name: cargo expand
|
|
|
|
|
runs-on: ubuntu-latest
|
|
|
|
|
steps:
|
|
|
|
|
- uses: dtolnay/install@master
|
|
|
|
|
with:
|
|
|
|
|
crate: cargo-expand
|
|
|
|
|
- run: cargo expand --help
|
|
|
|
|
```
|
|
|
|
|
|
2021-10-08 05:33:39 +02:00
|
|
|
<img src="https://user-images.githubusercontent.com/1940490/136493915-2c3c6a6b-620c-46e1-be4b-3c96856ccd12.png">
|
|
|
|
|
|
2021-10-08 04:51:26 +02:00
|
|
|
## Inputs
|
|
|
|
|
|
|
|
|
|
| Name | Required | Description |
|
|
|
|
|
| ------- | :------: | -------------------------------------------- |
|
|
|
|
|
| `crate` | ✓ | Name of crate as published to crates.io |
|
|
|
|
|
| `bin` | | Name of binary; default = same as crate name |
|
|
|
|
|
|
|
|
|
|
## Security considerations
|
|
|
|
|
|
|
|
|
|
Check the `.github/workflows` directory of this repo for the GitHub Actions
|
|
|
|
|
logic which compiles, signs, and publishes each binary.
|
|
|
|
|
|
|
|
|
|
This Action downloads both the binary executable and its signature. The
|
|
|
|
|
signature is verified using gpg and the public key available in
|
|
|
|
|
`signing-key.asc`. The corresponding private key is provided to this repo's
|
|
|
|
|
build jobs as a GitHub secret.
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
The scripts and documentation in this project are released under the [MIT
|
|
|
|
|
License].
|
|
|
|
|
|
|
|
|
|
[MIT License]: LICENSE
|
