Semantic version generator

Project created overnight, to prove that management of semantic versioning is NOT painful and do not require arguments and debates within the team. Simple, clean and only thing the project team should need to agree to are the keywords.

• Semantic version generator
  • How does it work
  • Usage
    • Calculations example
    • Example configuration
  • Good to know

How does it work

• Binary clones the github repository
• Iterates through the list of commits looking for the keywords specified in config file for additional bumps of versions
• Returns the semantic version which can be included in the release

Usage

 bash$ ./semver-gen -g
SEMVER 5.1.1

Available flags:

Flags:
  -c, --config string       Path to config file (default "config.yaml")
  -g, --generate            Generate semantic version
  -h, --help                help for this command
  -r, --repository string   Repository URL. If not specified local dir will be used. (default "https://github.com/lukaszraczylo/simple-gql-client")

Calculations example

• 0.0.1 - PATCH - starting commit
• 0.0.2 - PATCH - another commit
• 0.1.0 - MINOR - after commit with word 'Change' => increment MINOR, reset PATCH
• 0.1.1 - PATCH - additional commit
• 1.0.1 - MAJOR - commit with word 'BREAKING' = > INCREMENT MAJOR, reset MINOR
• 1.0.2 - PATCH - another commit

Example configuration

version: 1
force:
  major: 1
  minor: 0
  patch: 1
wording:
  patch:
    - update
    - initial
  minor:
    - add
    - change
    - improve
  major:
    - breaking
    - the # For testing purposes

• version: is not respected at the moment, introduced for potential backwards compatibility in future
• force: sets the "starting" version, you don't need to specify this section as the default is always 0
• wording: words the program should look for in the git commits to increment (patch|minor|major)

Good to know

• Word matching uses fuzzy search AND is case INSENSITIVE
• I do not recommend using common words ( like "the" from the example configuration )