kanpai

🍻 Use Kanpai to publish a new version of your module!

Usage no npm install needed!

<script type="module">
  import kanpai from 'https://cdn.skypack.dev/kanpai';
</script>

README

NPM version NPM downloads Build Status

How it works

No black magic. In semantic-release you don't have full control of project publish, semantic-release smartly analyze your commits and publish the corresponding new version.

While using kanpai (shortened to kp), you specify the version to publish instead. By running kp [patch|minor|major|x.y.z], it does following things:

  • Check git status, see if you have committed the changes and if the remote history differs.
  • Run tests, npm test by default.
  • Update package version, CHANGELOG.md, create git tag as well.
  • Push to remote git server

After that, you can publish the npm package and create GitHub Release with the kp release command. And this step can be automated via CI like GitHub Actions and CircleCI.

Install

$ npm install -g kanpai

# or use yarn
$ yarn global add kanpai

Usage

$ kp [patch|minor|major|$version|pre$type]

# custom test command, equal to npm run test:other
$ kp --test test:other

# skip test script
$ kp --skip-test

# more usages
$ kp -h

A common workflow:

# after hack something...
$ git commit -am "change the world"
$ kp

# On CI
$ kp release

Config

You can use command-line to set and get config globally:

$ kp get
$ kp get test

# update test
$ kp set test custom-test-script

# update the commit message when running `npm version `
# %s will be replaced by version number, eg: 0.1.0
$ kp set commitMessage "Release version %s"

You can config these properties in package.json for a single project:

{
  "kanpai": {
    "test": "lint", // custom test script => npm run lint
    "commitMessage": "Release version %s"
  }
}

Keep a CHANGELOG.md

Running kp will also generate a CHANGELOG.md file, which will include the changes since last release:

## Unreleased

No unreleased changes.

## 0.1.0

- Some commit message

As you can see this file also includes an "Unreleased" section, and upon running kp the content will be automatically replaced by the commit messages since last release, and the heading ## Unreleased will be updated to the actual version number.

You can also write the "Unreleased" section manually, the content will only be replaced by commit messages if the heading is followed by nothing or another h2 heading. In this case only the heading will be replaced.

FAQ

fatal: no upstream configured for branch 'master'

Two options:

a) git branch --set-upstream-to=origin/master master and then run git push
b) git push -u origin master

License

MIT © EGOIST