3
0
Fork 0
mirror of https://github.com/dtolnay/install.git synced 2024-11-25 17:39:33 +01:00
cargo-install/README.md
2021-10-07 23:33:56 -04:00

1.3 KiB

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

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

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.