Skip to content
package

GitHub Action

Bump Action Workflow

v1.5.0 Latest version

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.5.0
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

user name
default: the user of the current push

email

user email
default: current user email

branch

branch to work against
default: master

unrelated

use --allow-unrelated-histories deafult: false

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 use this action by referencing any branch or git tag:

bump:
  runs-on: ubuntu-latest
  steps:
    - uses: tool3/bump@master #latest
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        user: "First Last"
        email: "user.email@gmail.com"

⚠️ 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: "user.email@gmail.com"
  • this action pushes the package.json version update back to the repo (defaults to master).

See the actions tab for runs of this action! 🚀

Example

name: release

on:
  push:
    branches:
      - release

jobs:
  tag:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@master
      - uses: tool3/bump@master
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          unrelated: true

  publisher:
    needs: tag
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: tool3/publisher@master
        with:
          npm_token: ${{ secrets.NPM_TOKEN }}
          github_token: ${{ secrets.GITHUB_TOKEN }}
          scope: "@tool3"