https://github.com/tool3/bump
⪮ github action for bumping npm package versions
https://github.com/tool3/bump
github-action javascript-action npm release
Last synced: 9 months ago
JSON representation
⪮ github action for bumping npm package versions
- Host: GitHub
- URL: https://github.com/tool3/bump
- Owner: tool3
- License: mit
- Created: 2019-12-30T15:23:40.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-12T05:54:40.000Z (11 months ago)
- Last Synced: 2025-03-27T21:11:52.475Z (10 months ago)
- Topics: github-action, javascript-action, npm, release
- Language: JavaScript
- Homepage:
- Size: 15.9 MB
- Stars: 6
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.
[](https://github.com/tool3/bump/actions)
# 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:
```yaml
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"
```
## :warning: Important usage notes
- this action requires `@actions/checkout` to be defined in a previous step. e.g:
```yaml
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](https://github.com/tool3/bump/actions) for runs of this action! :rocket:
# Example
```yaml
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"
```