easytag

easytag simplifies Versioning & Tagging when you need to deliver multiple versioning depending on your GIT branch.

While using easytag tagging through npx easytag [patch|minor|major] commands will trigger a custom procedures that will sequentially perform:

• update of your package.json version depending on the release type (patch, minor, major)
• add package.json to GIT changes, tag & create commit with tag name in the message (see below for default naming convention)
• push both your changes and your tags (git push && git push --tags)

Default Naming Convention

Master/Main Branch

• master => vX.Y.Z
• main => vX.Y.Z

Other Branches

• feauture/example => feauture-example-vX.Y.Z
• test => test-vX.Y.Z
• mybranch => mybranch-vX.Y.Z

Setup

Inside your NPM project execute:

install it

$ npm i -D [ --force ] @macchie7/easytag@latest

add --force in case of legacy dependancy inside the project.

Then init easytag

$ npx @macchie7/easytag --init

easytag replaces your preversion and preversion script inside package.json to be able to intercept and disable them.

Usage

easytag relicates npm version * commands:

• npx easytag [ patch | minor | major ]

Parameters

Edit your config inside package.json to add extra parameters:

Example

{
  "config": {
    "easytag": {
      // disable push after tagging
      "noPush": true,
      // master/main branch format (default: v1.2.3)
      "masterFormat": "{{version}}",
      // others branch format (default: branchname-v1.2.3)
      "branchFormat": "{{branchName}}-{{version}}"
    }
    ...
  }
  ...
}