Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rickstaa/action-get-semver
Outputs the current/next major, minor, and patch version based on the given semver version.
https://github.com/rickstaa/action-get-semver
composite continuous-integration gh-action github-action-composite github-actions semver semver-parser versioning
Last synced: 11 days ago
JSON representation
Outputs the current/next major, minor, and patch version based on the given semver version.
- Host: GitHub
- URL: https://github.com/rickstaa/action-get-semver
- Owner: rickstaa
- License: mit
- Created: 2020-12-22T16:29:30.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-07T19:24:07.000Z (about 1 month ago)
- Last Synced: 2024-10-12T18:49:17.798Z (26 days ago)
- Topics: composite, continuous-integration, gh-action, github-action-composite, github-actions, semver, semver-parser, versioning
- Language: Shell
- Homepage: https://github.com/marketplace/actions/get-semver
- Size: 63.5 KB
- Stars: 10
- Watchers: 2
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# action-get-semver
A simple action that returns the current/next major, minor, and patch version based on the given semver
version.
[](https://github.com/rickstaa/action-get-semver/actions?query=workflow%3A%22Action+test%22)
[](https://github.com/rickstaa/action-get-semver/actions?query=workflow%3ADepup)
[](https://github.com/rickstaa/action-get-semver/actions?query=workflow%3ARelease)
[](https://github.com/rickstaa/action-get-semver/actions?query=workflow%3A%22Docker+Image+CI%22)
[](https://github.com/rickstaa/action-get-semver/releases)
## Inputs
```yaml
inputs:
bump_level:
description: "Version bump level [major, minor, patch]."
required: False
default: "patch"
verbose:
description: "Print current and next version."
required: False
default: "false"
frail:
description: "Return exit code of 1 when no version tag is found."
required: False
default: "false"
```
## Outputs
```yaml
outputs:
current_version:
description: "The current version."
next_version:
description: "The next major version."
error:
descriptor: "Whether an error was encountered when retrieving the current semver."
```
## Usage
```yaml
name: release
on:
push:
branches:
- main
jobs:
check-version:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
with:
fetch-depth: 0
- uses: rickstaa/action-get-semver@v1
id: get_semver
with:
bump_level: "minor"
- name: Print current and next version
run: |
echo "Current version: ${{ steps.get_semver.outputs.current_version }}"
echo "Next version: ${{ steps.get_semver.outputs.next_version }}"
```
❗ **NOTE:** This action requires the `fetch-depth: 0` argument to be set in the [actions/checkout@v3](https://github.com/actions/checkout) step (see [actions/checkout#fetch-all-history-for-all-tags-and-branches
](https://github.com/actions/checkout#fetch-all-history-for-all-tags-and-branches)).
## Contributing
Feel free to open an issue if you have ideas on how to make this GitHub action better or if you want to report a bug! All contributions are welcome. :rocket: Please consult the [contribution guidelines](CONTRIBUTING.md) for more information.
### Acknowledgement
This action serves as a wrapper around the [bump](https://github.com/haya14busa/bump) package of [@haya14busa](https://github.com/haya14busa/bump/commits?author=haya14busa).