Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
package

GitHub Action

Bump Action Workflow

v1

Bump Action Workflow

package

Bump Action Workflow

Bump a version based on commit message, tag it, and push package.json update to repository

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Bump Action Workflow

uses: tool3/bump@v1

Learn more about this action in tool3/bump

Choose a version

Bump Action

Bump allows you to..well...bump an npm package version using a commit message, and push the package.json update back to the repository.

Create an action from this template

Click the Use this Template and provide the new repo details for your action

Options

inputs:

  • github_token (required) - github access token.
  • user (optional) - user name (default: the user of the current push).
  • email (optional) - user email. (default: current user email).
  • branch (optional) - branch to work against. (default: master).

outputs:

  • version - the version being tagged and pushed.

Bump strategy

If your head (latest) commit has the keywords #patch, #minor or #major - this action will use that to perform the bump. Defaults to patch.

Usage

You can consume the action by referencing the v1 branch

bump:
  runs-on: ubuntu-latest
  steps:
  - uses: tool3/bump@master
    with:
      github_token: ${{ secrets.GITHUB_TOKEN }}
      user: 'First Last'
      email: '[email protected]'

⚠️ Important usage notes

  • this action requires @actions/checkout to be defined in a previous step. e.g:
bump:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@master
  - uses: tool3/bump@master
    with:
      github_token: ${{ secrets.GITHUB_TOKEN }}
      user: 'First Last'
      email: '[email protected]'
  • this action pushes the package.json version update back to the repo (defaults to master). There is a safeguard in place which checks for the existance of a version in the commit message. If so, this action will not run - to avoid build loop.

See the actions tab for runs of this action! 🚀