3
0
Fork 0
mirror of https://github.com/dtolnay/install.git synced 2024-11-22 08:29:30 +01:00

Add readme

This commit is contained in:
David Tolnay 2021-10-07 22:51:26 -04:00
parent d875af3684
commit 059550de26
No known key found for this signature in database
GPG key ID: F9BA143B95FF6D82

46
README.md Normal file
View file

@ -0,0 +1,46 @@
# 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: actions/checkout@v2
- uses: dtolnay/install@master
with:
crate: cargo-expand
- run: cargo expand --help
```
## 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