mapped/mapped/action-semver

Establishes a common SEMVER in enviornment variables and version.txt file

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None

Inputs

namedescriptionrequireddefault
baseVersionThe base version of this repo. The first version of release. Applied if there is no any release yet. "v" prefix is optional.yes—
dockerImageThe name of the docker image to produce tags for. If omitted, no docker tags will be produced.no""
gitHubTokenThe GITHUB_TOKEN value. Required to produce latest tags.no""
branchMappingsUsed for mapping untagged branches to tag names, such as main:edge.nomain:edge
prereleasePrefixThe <pre-release> prefix on an untagged run.noprerelease
tagPrefixPrefix GitHub tag names with a string of your choiceno""
versionFileA filename where the full SEMVER and commit SHA will be written. Set to empty string if you do not want a version file to be created.noVERSION
releasesBranchBranch where automatic releases should be created. Set to empty string to deactivate releases creationnomain
forcePatchIncrementIfNoChangesForces to increment patch if no changes were made since the last releasenofalse
dockerPlatformSuffixAdds a suffix to the docker tag to identify the platform that can be referenced by a composit manifestno""

Outputs

namedescription
ver_majorMajor version portion of the SEMVER
ver_minorMinor version portion of the SEMVER
ver_patchPatch version portion of the SEMVER
ver_preReleasePre-release portion of the SEMVER
ver_metadataMetadata portion of the SEMVER
ver_buildNumberThe current build number
ver_createdISO8601 datetime stamp of when the build was run
ver_tagThe version tag
ver_semVerThe full SEMVER (including any pre-release info and all metadata)
ver_semVerNoMetaThe SEMVER without any metadata (including any pre-release info)
ver_semVerNoMetaPyPAThe version in PEP 440 format for Python packages (e.g., 1.2.3rc23 instead of 1.2.3-rc.23)
ver_semVerFourTupleNumericThe version as a four-tuple numeric format (e.g., 1.2.3.23)
docker_tagsA list of docker tags that can be passed to docker/build-push-action@v2
docker_pushA true/false flag that can be passed to docker/build-push-action@v2
docker_dtagThe most deterministic of the tags in docker_tags.
oci_titleThe org.opencontainers.image.title label
oci_descriptionThe org.opencontainers.image.description label
oci_urlThe org.opencontainers.image.url label
oci_sourceThe org.opencontainers.image.source label
oci_versionThe org.opencontainers.image.version label
oci_createdThe org.opencontainers.image.created label
oci_revisionThe org.opencontainers.image.revision label
oci_licensesThe org.opencontainers.image.licenses label
oci_labelsThe new-line separated list of OCI labels that can be passed to docker/build-push-action@v2
release_tagRelease tag. Contains version or empty value if release was not created.
release_previousTagThe previous release tag version (e.g., v3.5.9)