Note: Under active development - expect breaking changes.

conventional bridges the gap in automating version management for Ruby gems from start to finish. Using Conventional Commits, it allows you to automate the process from commit to release.

Add this line to your Gemfile:

gem 'conventional'

and run bundle install from your shell.

To install the gem manually, run:

gem install conventional 

Bumps gem according to conventional commits

Usage: conventional bump Options: --level=VALUE	# The level of bump to execute (determined automatically if not provided): (patch/minor/major) --[no-]tag	# Create and push git tag, default: true --message=VALUE	# Commit message template, default: "chore: Release v%{version} [skip ci]" --[no-]push	# Push changes to git remote, default: true --[no-]dry-run	# Completes a dry run without making any changes, default: false --help, -h	# Print this help 

Returns the recommended bump level according to conventional commits

Usage: conventional recommended-bump Options: --help, -h	# Print this help 

Check out these similar projects, which served as inspiration for conventional.

• conventional-changelog (JS)
• lerna (JS)
• github-changelog-generator (Ruby)
• gem-release (Ruby)

conventional is distributed under the MIT License.

• David Barrell (@dabarrell, davidbarrell.me)