feat(release): add changelog generation

Author: dignifiedquire

README.md

@@ -127,9 +127,10 @@ $ gulp build
 2. Run tests
 3. Build everything
 4. Bump the version in `package.json`
-5. Commit the version change
-6. Create a git tag
-7. Run `git push` to `upstream/master`
+5. Generate a changelog based on the git log
+6. Commit the version change & `CHANGELOG.md`
+7. Create a git tag
+8. Run `git push` to `upstream/master`
 
 ```bash
 # Major release
@@ -151,6 +152,12 @@ $ aegir-release --env node
 $ gulp release --env node
 ```
 
+You can generate a changelog for all versions by using `--first`
+
+```bash
+$ aegir-relase --first
+```
+
 ## Other Notes
 
 There is a badge.

package.json

@@ -39,6 +39,7 @@
     "gulp": "^3.9.1",
     "gulp-babel": "^6.1.2",
     "gulp-bump": "^2.2.0",
+    "gulp-conventional-changelog": "^1.1.0",
     "gulp-eslint": "^3.0.1",
     "gulp-filter": "^4.0.0",
     "gulp-git": "^1.10.0",
@@ -89,4 +90,4 @@
     "dignifiedquire <[email protected]>",
     "greenkeeperio-bot <[email protected]>"
   ]
-}
+}

src/utils.js

@@ -2,6 +2,7 @@
 
 const runSequence = require('run-sequence')
 const $ = require('gulp-load-plugins')()
+const fs = require('fs')
 
 // Workaround gulp not exiting if there are some
 // resources not freed
@@ -34,3 +35,7 @@ exports.fail = (msg) => {
   $.util.log($.util.colors.red(msg))
   process.exit(1)
 }
+
+exports.getVersion = () => {
+  return JSON.parse(fs.readFileSync('./package.json', 'utf8')).version
+}

tasks/release/bump.js

@@ -2,9 +2,10 @@
 
 const $ = require('gulp-load-plugins')()
 const semver = require('semver')
-const fs = require('fs')
 const _ = require('lodash')
 
+const getVersion = require('../../src/utils').getVersion
+
 function getType () {
   if (_.includes($.util.env._, 'major')) return 'major'
   if (_.includes($.util.env._, 'minor')) return 'minor'
@@ -13,21 +14,13 @@ function getType () {
   return 'patch'
 }
 
-function getCurrentVersion () {
-  return JSON.parse(fs.readFileSync('./package.json', 'utf8')).version
-}
-
 module.exports = (gulp, done) => {
   const type = getType()
-  const newVersion = semver.inc(getCurrentVersion(), type)
+  const newVersion = semver.inc(getVersion(), type)
 
   $.util.log('Releasing %s', newVersion)
 
   return gulp.src('./package.json')
     .pipe($.bump({version: newVersion}))
     .pipe(gulp.dest('./'))
-    .pipe($.git.add())
-    .pipe($.git.commit(`chore: release version v${newVersion}`, {args: '-n'}))
-    .pipe($.filter('package.json'))
-    .pipe($.tagVersion())
 }

tasks/release/changelog.js

@@ -0,0 +1,14 @@
+'use strict'
+
+const $ = require('gulp-load-plugins')()
+
+module.exports = (gulp, done) => {
+  const releaseCount = $.util.env.first ? 0 : 1
+
+  return gulp.src('CHANGELOG.md')
+    .pipe($.conventionalChangelog({
+      preset: 'angular',
+      releaseCount
+    }))
+    .pipe(gulp.dest('./'))
+}

tasks/release/commit.js

@@ -0,0 +1,15 @@
+'use strict'
+
+const $ = require('gulp-load-plugins')()
+
+const getVersion = require('../../src/utils').getVersion
+
+module.exports = (gulp, done) => {
+  const newVersion = getVersion()
+
+  return gulp.src(['package.json', 'CHANGELOG.md'])
+    .pipe($.git.add())
+    .pipe($.git.commit(`chore: release version v${newVersion}`, {args: '-n'}))
+    .pipe($.filter('package.json'))
+    .pipe($.tagVersion())
+}

tasks/release/post-build.js

@@ -6,6 +6,8 @@ module.exports = (gulp, done) => {
   runSequence.use(gulp)(
     'release:contributors',
     'release:bump',
+    'release:changelog',
+    'release:commit',
     'release:push',
     'release:publish',
     done