Project

incr

0.01
Low commit activity in last 3 years
A long-lived project that still receives updates
Tasteful utility to increment the version number and create a corresponding git tag.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

= 3.2.0
= 13.2.1
= 3.13.0
= 1.63.5

Runtime

= 1.19.1
= 2.21.1
 Project Readme

incr
incr is a tool to help you easily increment the version number of your NPM or Mix packages.

What does incr do?

The process is detailed as follow:

  • Find the relevant file(s) (e.g.: package.json and package-lock.json or mix.exs).
  • Determine the existing version number.
  • Increment the specified segment. If you increment the minor segment, the patch segment is set to 0 and the same goes for the major segment, the minor and patch segments are set to 0.
  • Write the newly incremented version number in the relevant file(s).
  • Create a new git commit with the relevant file with the version number as the default message (e.g.: 0.2.1).
  • Create a new annotated git tag pointing to the new git commit with the version number prefixed by a 'v' as the name (e.g.: v0.2.1).
  • 💥

Installation

incr

~> gem install incr

Usage

To increment the patch segment of your NPM package version number:

~> incr npm patch

To increment the minor segment of your Mix package version number:

~> incr mix minor

Arguments

Here are some arguments that can be used with incr:

  • -d : Directory where to search for the version files (default: .)
  • -t : Tag name pattern, where %s will be replaced with the new version (default: v%s)
  • --[no-]commit : Commit changes. (default: enabled)
  • --[no-]tag : Create a git tag. (default: enabled)

Example:

~> incr --no-tag -d ./subprojects/web/ -t my-custom-tag-prefix/%s npm patch

This will :

  • Search for package.json and package-lock.json files inside ./subprojects/web/ and update the patch version
  • Commit the changes under the message my-custom-tag-prefix/2.3.4
  • Not create a tag with the new version

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/jcouture/incr. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.