Vump

CLI semantic version bumper for every project. With a kitty inside.

🚧 TODO

Do you like when projects use semantic versioning a keep a maintained changelog? I bet you do. Yet it is not rare that a patch version change breaks your app. Versions of a random maintained project are a mess. Most of the time, developers use version, because they are forced to, not because they want to.

Here is why:

1. Some people don't know or understand the benefits, for those there are projects like semver, keep-a-changelog etc.
2. The others are lazy. It is hard. The routine is boring, menial and frustrating if you make a mistake, since you cannot usually republish with the same version tag. For those, I made vump.

I try to understand you project. You decide which semver update best describes the unreleased changes and I will snoop your project, do all the file writes in the current directory and then stage them, commit and tag.

If it sounds simple, it's because it is. You might argue that there are many CLI tools doing just the same (find them bellow), even more. That might be true. But very few have ambition to handle different platforms under one hood, and hang on fast to existing standards!

• 📦 Modular and generic approach
• 🎓 Opinionated, based on standards
• 📒 Changelog management
• 👮 Synced, controlled version
• ✔️ Solid test coverage
• ℹ️ User documentation
• 💬 Helpful output
• 🔧 Handful of options

gem install vump

💎 Don't like ruby? There are likely to be prebundled packages for Linux, Windows and Mac in the future.

cd my-project
vump patch

vump [<major|minor|patch|<semver-string>>] [...options]

• Bump minor version (mi is a prefix that cannot be confused with semver or other bumps)

vump mi

• Bump patch version of project in ~/Projects/foo. Ommit all git operations.

vump patch -p=~/Projects/foo --no-git

• Set version of the projet on 1.1.1-beta-3 (use semver's pre-release)

vump 1.1.1 --pre=beta-3

Vump finds which modules are relevant for your project, asks them for version and if all relevent modules align, it bumps each of them. There are some modules, you can use no matter the project:

Changelog module manipulates with CHANGELOG.md file according to keep-a-changelog standard. Using Vump you get changelog maintanance for free, all you need to do is to track your changes in Unreleased section.

Version file is probably the simplest module of all. It keeps just the version string followed by a newline in VERSION text file. You can use it along with other modules, or if you have no other place to keep your version. This module also comes handy, when your metadata are stored in a non-static file (meaning, it is interpreted via any runtime). This is the case for ruby for instance. Vump cannot parse interpret the complexity of ruby runtime. But you can read version from the VERSION file in your gemspec.

• JavaScript / Node.js

  • 🌈 npm Native module for npm's package.json and package-lock.json
  • 🌈 bower - Native module (though tracking version in bower.json is deprecated)
  • 🌈 component Native module for component.json

• Ruby

  • ☀️ rubygems - Dynamic specification, you can use VERSION file

• PHP

  • 🌈 composer - Native module for composer.json

• Python

  • ☀️ PyPI - Dynamic specification, you can use VERSION file

Are you missing something? Please let me know and I will gladly implement new module!

• python-versioneer
• version-bump-prompt
• npm-bump
• bump
• php-bump-version
• perl-bump-version
• dotnet-bump
• release-it
• bumped

Are there any other good alternatives? Please let me know and I will update the list!

Licensed under MIT