versioner

This gem allows you to easily add, update, and retrieve a version number for your Rails application.

Add this line to your application's Gemfile:

gem 'versioner'

And then execute:

$ bundle

Or install it yourself as:

$ gem install versioner

Then run the installer:

$ rails generate versioner:install

This adds these files:

• [RAILS_ROOT]/config/versioner.yml - This is where the version number is stored.
• [RAILS_ROOT]/config/initializers/versioner.rb - This is where you can configure options. The only option available right now is storage_path, which allows you to change the location of versioner.yml.

Version numbers follow the format Major.Minor.Patch. A major goal of this project is to follow Semantic Versioning conventions: if minor is incremented, reset the patch to 0; if major is incremented, reset both minor and patch to 0.

Force a new version number like this:

$ rake versioner:force[1,0,3]

Then you can update it:

$ rake versioner:increment_major
$ rake versioner:increment_minor
$ rake versioner:increment_patch

And get it:

$ rake versioner:version

Within your Rails app, you can use the following to get your app's version as a string:

Versioner.version

Right now, the version is stored in YAML format, by default under config/versioner.yml. This location can be changed in config/initializers/versioner.rb.

More storage back-end options are coming.

• Fully support Semantic Versioning (patch & build commands)
• Git integration (set build to current git revision, automatic git tagging)
• Support for other frameworks (e.g., Sinatra)
• More storage back-ends

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

MIT