A GitHub Action for running cargo-semver-checks
Find a file
Predrag Gruevski a1d8af322f
Merge pull request #5 from obi1kenobi/improved_docs
Improve examples for the various modes of using the action.
2022-08-12 12:30:13 -04:00
.github chore(gh): Allow contributors to update repo settings 2022-08-09 11:50:33 -05:00
action.yml Add branding info to action. 2022-08-10 01:28:06 -04:00
find_comparison_version.sh Ensure scripts are executable. 2022-07-20 20:09:41 -04:00
find_workspace_crates.sh Ensure scripts are executable. 2022-07-20 20:09:41 -04:00
LICENSE Initial commit 2022-07-20 18:45:54 -04:00
README.md Improve examples for the various modes of using the action. 2022-08-12 12:26:01 -04:00

cargo-semver-checks-action

Lint your crate API changes for semver violations.

By default, this action assumes that:

  • Your cargo workspace contains a single crate which contains a library target.
  • Your releases are tagged in git as v{major}.{minor}.{patch}, for example v1.2.3.

Single-crate workspaces can use it as:

- name: Check semver
  uses: obi1kenobi/cargo-semver-checks-action@v1
- name: Publish to crates.io
  run: # your `cargo publish` code here

Use with a different version tag format

Change the version-tag-prefix setting to reflect the prefix used to create the version tag. The setting's default value 'v' creates version tags like v1.2.3.

For example, if your versions are tagged as 1.2.3, you can set version-tag-prefix to be the empty string:

- name: Check semver
  uses: obi1kenobi/cargo-semver-checks-action@v1
  with:
    version-tag-prefix: ''
- name: Publish my-crate to crates.io
  run: # your `cargo publish` code here

Use in workspaces with more than one crate

You'll need to specify which crate should be checked, and the format used for version tags for that crate:

  • crate-name specifies the crate to check, and
  • version-tag-prefix sets the text prepended to the version number to create the git tag for that release.

For example, this will check my-crate whose releases are tagged as my-crate-v1.2.3:

- name: Check semver
  uses: obi1kenobi/cargo-semver-checks-action@v1
  with:
    crate-name: my-crate
    version-tag-prefix: my-crate-v
- name: Publish my-crate to crates.io
  run: # your `cargo publish` code here

Use with binary crates or crates with more than one target

To check a different (non-library) target in a crate, use the crate-target setting:

- name: Check semver for my_binary
  uses: obi1kenobi/cargo-semver-checks-action@v1
  with:
    crate-target: --bin my_binary
- name: Publish my-crate to crates.io
  run: # your `cargo publish` code here