grunt-semantic-release

Using this plugin it is possible to release a new version with just grunt release.

This will

• determine the correct semantic version to release (yes the checkboxes are prechecked for you)
• generate a conventional-changelog
• release code that doesn't fail it's tests only
• generate distribution files on Travis CI, rather than on a local, error-prone machine
• publish the new version to npm and GitHub Releases

Here is an example release.

Usage

• grunt release: suggests correct version
• grunt release:patch: 0.0.1 => 0.0.2
• grunt release:minor: 0.0.2 => 0.1.0
• grunt release:major: 0.1.0 => 1.0.0
• grunt release --setversion=4.12.3-alpha.19: 1.0.0 => 4.12.3-alpha.19

Getting Started

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-semantic-release --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-semantic-release');

Setup

This task comes with a setup script, that takes care of registering all necessary build hooks in the .travis.yml file and encrypting necessary tokens.

./node_modules/.bin/setup

The "release" task

Overview

In your project's Gruntfile, add a section named release to the data object passed into grunt.initConfig().

Example for a minimal configuration:

grunt.initConfig({
  release: {
    email: '[email protected]',
    name: 'Stephan Bönnemann'
  }
})

Options

email

Type: Array<String> required

The email used for git commits.

name

Type: Array<String> required

releaseBranch

Type: String optional

The branch which new releases are pushed to.

Default value: master

The name used for git commits.

bump

Type: Object optional

Default value:

bump: {
  commitMessage: 'chore(release): v%VERSION%',
  files: ['package.json', 'bower.json', 'component.json'],
  commitFiles: ['-a'],
  pushTo: 'origin master'
}

The options object that gets (partly) forwarded to the grunt-bump task.

The task relies on some options for grunt-bump, but there shouldn't be a need to configure this anyways. E.g. when there is a bower.json file present in the file system it is added to the files array automatically.

tasks

Type: Array<String> optional

Default value: ['changelog']

A list of tasks that prepare files for the release commit. Per default the changelog is generated here, but you can do other stuff like minifying a distribution build, generating a list of contributors – basically everything you could imagine and find useful.

payload

Type: Function optional

function(payload, cb) {
  getAwesomeContextualGif(function(url) {
    payload.body += '\n![yo](' + url + ')';
    cb(payload);
  })
}

You can use this function to manipulate the payload for the GitHub release. For example you could search the internet for an amazing gif and append it to the message body.

The payload object already contains information about the repo, owner and tag_name; the body is set to the current changelog.

Caveats

This grunt tasks is extracted from hood.ie's release process and thus tightly coupled to the tools, conventions and needs of hoodie. Extracting this into it's own general purpose task is the first of several steps to make this more universally applicable.

Currently it is required to:

• host code on GitHub
• use Travis for CI
• adhere to the angular commit message guidelines

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

License

Copyright (c) 2014 Stephan Bönnemann. Licensed under the MIT license.