Custom prefix, optional versioning based on multiple commit messages

README.md

@@ -30,6 +30,7 @@ jobs:
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         WITH_V: true
+        PREFIX: prefix
 ```
 
 _NOTE: set the fetch-depth for `actions/checkout@v2` to be sure you retrieve all commits to look for the semver commit message._
@@ -38,23 +39,27 @@ _NOTE: set the fetch-depth for `actions/checkout@v2` to be sure you retrieve all
 
 **Environment Variables**
 
-- **GITHUB_TOKEN** **_(required)_** - Required for permission to tag the repo.
-- **DEFAULT_BUMP** _(optional)_ - Which type of bump to use when none explicitly provided (default: `minor`).
-- **WITH_V** _(optional)_ - Tag version with `v` character.
-- **RELEASE_BRANCHES** _(optional)_ - Comma separated list of branches (bash reg exp accepted) that will generate the release tags. Other branches and pull-requests generate versions postfixed with the commit hash and do not generate any tag. Examples: `master` or `.*` or `release.*,hotfix.*,master` ...
-- **CUSTOM_TAG** _(optional)_ - Set a custom tag, useful when generating tag based on f.ex FROM image in a docker image. **Setting this tag will invalidate any other settings set!**
-- **SOURCE** _(optional)_ - Operate on a relative path under $GITHUB_WORKSPACE.
-- **DRY_RUN** _(optional)_ - Determine the next version without tagging the branch. The workflow can use the outputs `new_tag` and `tag` in subsequent steps. Possible values are `true` and `false` (default).
-- **INITIAL_VERSION** _(optional)_ - Set initial version before bump. Default `0.0.0`.
-- **TAG_CONTEXT** _(optional)_ - Set the context of the previous tag. Possible values are `repo` (default) or `branch`.
-- **PRERELEASE_SUFFIX** _(optional)_ - Suffix for your prerelease versions, `beta` by default. Note this will only be used if a prerelease branch.
-- **VERBOSE** _(optional)_ - Print git logs. For some projects these logs may be very large. Possible values are `true` (default) and `false`.
+- **GITHUB_TOKEN** ***(required)*** - Required for permission to tag the repo.
+- **DEFAULT_BUMP** *(optional)* - Which type of bump to use when none explicitly provided (default: `minor`).
+- **WITH_V** **(deprecated)** *(optional)* - Tag version with `v` character. Deprecated variable - use `PREFIX` instead.
+- **PREFIX** *(optional)* - Adds a prefix before version number.
+- **RELEASE_BRANCHES** *(optional)* - Comma separated list of branches (bash reg exp accepted) that will generate the release tags. Other branches and pull-requests generate versions postfixed with the commit hash and do not generate any tag. Examples: `master` or `.*` or `release.*,hotfix.*,master` ...
+- **CUSTOM_TAG** *(optional)* - Set a custom tag, useful when generating tag based on f.ex FROM image in a docker image. **Setting this tag will invalidate any other settings set!**
+- **SOURCE** *(optional)* - Operate on a relative path under $GITHUB_WORKSPACE.
+- **DRY_RUN** *(optional)* - Determine the next version without tagging the branch. The workflow can use the outputs `new_tag` and `tag` in subsequent steps. Possible values are ```true``` and ```false``` (default).
+- **INITIAL_VERSION** *(optional)* - Set initial version before bump. Default `0.0.0`.
+- **TAG_CONTEXT** *(optional)* - Set the context of the previous tag. Possible values are `repo` (default) or `branch`.
+- **PRERELEASE_SUFFIX** *(optional)* - Suffix for your prerelease versions, `beta` by default. Note this will only be used if a prerelease branch.
+- **VERBOSE** *(optional)* - Print git logs. For some projects these logs may be very large. Possible values are ```true``` (default) and ```false```. 
+- **BRANCH_LATEST_COMMIT** *(optional)* - Commit messages for commits of a given branch will be taken into account while calculating a new tag. Specifying bramch is useful when using this action for pull requests - one can set environment variable as follows: `BRANCH_LATEST_COMMIT: ${{ github.event.pull_request.head.sha }}` to calculate a new version basing on commits from a given PR.  If not specified the current commit is used.
+- **USE_LAST_COMMIT_ONLY** *(optional)* - True by default. If true only last commit is taken into account while bumping the version, otherwise all commits from the commit with the latest tag contribute to new tag calculation
 
 #### Outputs
 
-- **new_tag** - The value of the newly created tag.
-- **tag** - The value of the latest tag after running this action.
-- **part** - The part of version which was bumped.
+- **new_tag** - The value of the newly created tag, e.g. my-prefix-1.2.3
+- **new_tag_without_prefix** - The value of the newly created tag without specified prefix, e.g 1.2.3
+- **tag** - The value of the latest tag before bumping it by running this action, e.g. my-prefix-1.2.2
+- **part** - The part of version which was bumped, e.g. minor
 
 > **_Note:_** This action creates a [lightweight tag](https://developer.github.com/v3/git/refs/#create-a-reference).
 

action.yml

@@ -7,8 +7,10 @@ runs:
 outputs:
   new_tag:
     description: 'Generated tag'
+  new_tag_without_prefix:
+    description: 'Generated tag without specified prefix'
   tag:
-    description: 'The latest tag after running this action'
+    description: 'The latest tag before running this action'
   part:
     description: 'The part of version which was bumped'
 branding: