semver-action
A Github Action that wil parse, validate and then provide data back on a SemVer version number.
This includes parsing out the major
, minor
, patch
and the pre release aspects as well as providing next
version numbers for the major, minor and patch for the provided version number.
Parameters
-
version
: The version number to be parsed as a SemVer
Outputs
-
version
: The parsed SemVer value -
major
: The major part of the parsed SemVer, e.g. for version1.2.3
it would return1
-
minor
: The minor part of the parsed SemVer, e.g. for version1.2.3
it would return2
-
patch
: The major part of the parsed SemVer, e.g. for version1.2.3
it would return3
-
isPreRelease
: A boolean as a string indicating if the parsed SemVer is a pre release version, e.g. for version1.2.3
it would returnfalse
, but for1.2.3-alpha
it would return `true -
preRelease
: The pre release part of the parsed SemVer as a JSON array, e.g. for version1.2.3-alpha.1
it would return["alpha", 1]
-
preReleaseString
: The pre release part of the parsed SemVer as a string, e.g. for version1.2.3-alpha.1
it would returnalpha.1
-
nextMajor
: The next major version number as a string, e.g. for version1.2.3
it would return2.0.0
-
nextMinor
: The next minor version number as a string, e.g. for version1.2.3
it would return1.3.0
-
nextPatch
: The next patch version number as a string, e.g. for version1.2.3
it would return1.2.4
-
semeverData
: The full JSON data structure of the parsed SemverData type
Usage
- name: Parse SemVer
id: version
uses: peter-murray/semver-action@v1
with:
version: 1.2.3-alpha.1
- name: Print next major
run: echo ${{ steps.version.outputs.nextMajor }}