A CLI to help with git-flow releases and other version related functions
npm install entro-versionentro-version
=============
It's a bit annoying when you use git-flow and commit-and-tag-version in the same project because you want to know the version before you create the release branch. So you need to run commit-and-tag-version as a dry run to get that to make the release. You also need to ensure that the release itself has the correct changes and tag so that the changelog gets generated correctly.
This CLI was made with the intention to combine them both together so that you can have proper git-flow releases while using commit-and-tag-version to generate the version and changelog. You can use it in it's simplest form by running entro-version on the develop branch, or you can make it more complicated by adding release hooks. For instance, if you need to generate some .yaml files with the new version number or something like that, then you'd run a post-hook where it'll create the .yaml files and commit them before completing the release. I'm using this CLI to run releases for this CLI :P So check after v1.2.11 in the changelog for a working example... It took me that long to get this working :P!
Each time I make a change and I'm ready for a release, I run npm run release which in turn runs:
``
./bin/run --during-release-post-hook="npm publish && git commit -am 'Updated the readme'"
The easiest way to use this is to include it as a dev dependency or to install it globally. Assuming you've installed it globally:
`bash`
npm install -g entro-version
You would now be able to use it in a git-flow context. So you can cd into your repo and simply run entro-version to release a new version. To get some examples of how the CLI can be used, run:
`bash`
entro-version help
The default command that runs is:
`bash`
entro-version release
But there are other commands to help with versioning that you'll see when you run help. The --help command will show help for the release command because that's the default.
Let's assume you use entro-ci which allows you to compile Handlebars templates using the version of the repo. In this case, you could trigger the creation of the templates within the git-flow release using the following in your package.json:
`json`
{
"scripts": {
"release": "entro-version --during-release-post-hook=\"entro-ci templates:update && git commit -am 'Updated the templates'\""
}
}
Maybe, like this package, you want to publish this to https://npmjs.com. In that case, you could trigger the publish during the release by adding the following to your package.json:
`json`
{
"scripts": {
"release": "entro-version --during-release-post-hook=\"npm publish && git commit -am 'Updated the readme'\""
}
}
sh-session
$ npm install -g entro-version
$ entro-version COMMAND
running command...
$ entro-version (--version)
entro-version/3.0.0 linux-x64 node-v16.15.0
$ entro-version --help [COMMAND]
USAGE
$ entro-version COMMAND
...
`
Commands
* [](#entro-version-help-command)
* entro-version release
*
* Display help for entro-version.
USAGE
$ entro-version help [COMMAND] [-n]ARGUMENTS
COMMAND Command to show help for.
FLAGS
-n, --nested-commands Include all nested commands in the output.
DESCRIPTION
Display help for entro-version.
_See code: @oclif/plugin-help_
Creates a release using git-flow
USAGE
$ entro-version release [-p ] [-P ] [-s] [-f ] [-M ] [-d ] [-p] [-m
] [-b ] [-B]FLAGS
-B, --skip-base-branch-merge-to-develop If the --base-branch option is specified, it will automatically merge
into develop after the release is completed. If you would like to skip
this merge then use this flag. This might be useful if you want to
create a release on a staging branch or something to that effect.
-M, --main-branch-name= [default: master] The name of the master branch
-P, --during-release-post-hook= Any commands to run during the release, after standard-version
-b, --base-branch= If the release must be generated from any branch other than develop (eg.
master) then you would specify this base branch. Leave this empty if
there it is not required.
-d, --develop-branch-name= [default: develop] The name of the develop branch
-f, --commit-and-tag-version-flag=... [default: ] Flags to add to the commit-and-tag-version command
-m, --release-message= [default: Merging release] The description that you would like to give
your release (this shows up on the releases page in Github). This also
replaces {{version}} with the newly created version if you want to
include that in your message.
-p, --during-release-pre-hook= Any commands to run during the release, before standard-version
-p, --no-push Do not push the develop and master branches (with --follow-tags) during
the release
-s, --no-sign Do not sign during the release using your GPG key
DESCRIPTION
Creates a release using git-flow
EXAMPLES
$ entro-version release
$ entro-version release --during-release-post-hook="npm run publish && git commit -am 'Updated the readme'"
$ entro-version release --commit-and-tag-version-flag="--prerelease='alpha'"
$ entro-version release --commit-and-tag-version-flag="--release-as=major"
_See code: dist/commands/release.ts_
Retrieves the current version of the project
USAGE
$ entro-version version:get [-i ] [-k ] [-P ]FLAGS
-P, --prefix= The version prefix to add (eg. "v")
-i, --input= [default: ./package.json] The path to the JSON file to use to retrieve the version
-k, --key= [default: version] The key in the JSON file that holds the version
DESCRIPTION
Retrieves the current version of the project
EXAMPLES
$ entro-version version:get
$ entro-version version:get --input="./src/my-proj/package.json"
$ entro-version version:get --input="./src/version.json" --key="ver"
$ entro-version version:get --prefix="v"
$ entro-version version:get --prefix="staging-v"
_See code: dist/commands/version/get.ts_
Returns what the next version would be
USAGE
$ entro-version version:next [-f ] [-P ]FLAGS
-P, --prefix= The version prefix to add (eg. "v")
-f, --commit-and-tag-version-flag=... [default: ] Flags to add to the commit-and-tag-version command
DESCRIPTION
Returns what the next version would be
EXAMPLES
$ entro-version version:next
$ entro-version version:next --commit-and-tag-version-flag="--release-as=major"
$ entro-version version:next --prefix=v
_See code: dist/commands/version/next.ts_