add script to draft new changelog based on draftlogs

Author: archmoj

package.json

@@ -27,8 +27,11 @@
     "stats": "node tasks/stats.js",
     "find-strings": "node tasks/find_locale_strings.js",
     "preprocess": "node tasks/preprocess.js",
-    "build": "node tasks/empty_dist.js && npm run preprocess && npm run find-strings && npm run bundle && npm run extra-bundles && npm run stats",
-    "cibuild": "node tasks/empty_dist.js && npm run preprocess && node tasks/cibundle.js",
+    "use-draftlogs": "node tasks/use_draftlogs.js",
+    "empty-draftlogs": "node tasks/empty_draftlogs.js",
+    "empty-dist": "node tasks/empty_dist.js",
+    "build": "npm run empty-dist && npm run preprocess && npm run find-strings && npm run bundle && npm run extra-bundles && npm run stats",
+    "cibuild": "npm run empty-dist && npm run preprocess && node tasks/cibundle.js",
     "watch": "node tasks/watch.js",
     "lint": "eslint --version && eslint .",
     "lint-fix": "eslint . --fix || true",

tasks/empty_draftlogs.js

@@ -0,0 +1,18 @@
+var constants = require('./util/constants');
+var makeEmptyDirectory = require('./util/make_empty_directory');
+var emptyDir = makeEmptyDirectory.emptyDir;
+var makeDir = makeEmptyDirectory.makeDir;
+
+var pathToDraftlogs = constants.pathToDraftlogs;
+
+var chZero = '0'.charCodeAt(0);
+var chNine = '9'.charCodeAt(0);
+
+function startsWithNumber(v) {
+    var ch = v.charCodeAt(0);
+    return chZero <= ch && ch <= chNine;
+}
+
+// main
+emptyDir(pathToDraftlogs, { filter: startsWithNumber });
+makeDir(pathToDraftlogs);

tasks/use_draftlogs.js

@@ -0,0 +1,77 @@
+var fs = require('fs');
+var path = require('path');
+var constants = require('./util/constants');
+
+var pathToDraftlogs = constants.pathToDraftlogs;
+var pathToChangelog = constants.pathToChangelog;
+
+var chZero = '0'.charCodeAt(0);
+var chNine = '9'.charCodeAt(0);
+
+function startsWithNumber(v) {
+    var ch = v.charCodeAt(0);
+    return chZero <= ch && ch <= chNine;
+}
+
+var allLogs = fs.readdirSync(pathToDraftlogs).filter(startsWithNumber);
+
+var len = allLogs.length;
+if(!len) return;
+
+var writeAfterMe = 'where X.Y.Z is the semver of most recent plotly.js release.';
+var changelog = fs.readFileSync(pathToChangelog).toString().split(writeAfterMe);
+var head = changelog[0];
+var foot = changelog[1];
+
+var all = {
+    Added: [],
+    Removed: [],
+    Deprecated: [],
+    Changed: [],
+    Fixed: []
+};
+
+var ENTER = '\n';
+
+for(var i = 0; i < len; i++) {
+    var filename = allLogs[i];
+    var message = fs.readFileSync(path.join(pathToDraftlogs, filename), { encoding: 'utf-8' }).toString();
+    // trim empty lines
+    message = message.split(ENTER).filter(function(e) { return !!e; }).join(ENTER);
+
+    if(filename.endsWith('_add.md')) {
+        all.Added.push(message);
+    } else if(filename.endsWith('_remove.md')) {
+        all.Removed.push(message);
+    } else if(filename.endsWith('_deprecate.md')) {
+        all.Deprecated.push(message);
+    } else if(filename.endsWith('_change.md')) {
+        all.Changed.push(message);
+    } else if(filename.endsWith('_fix.md')) {
+        all.Fixed.push(message);
+    }
+}
+
+var draftNewChangelog = [
+    head + writeAfterMe,
+    '',
+    '## [X.Y.Z] -- UNRELEASED'
+];
+
+var append = function(key) {
+    var newMessages = all[key];
+    if(!newMessages.length) return;
+    draftNewChangelog.push('');
+    draftNewChangelog.push('### ' + key);
+    draftNewChangelog.push(newMessages.join(ENTER));
+};
+
+append('Added');
+append('Removed');
+append('Deprecated');
+append('Changed');
+append('Fixed');
+
+draftNewChangelog.push(foot);
+
+fs.writeFileSync(pathToChangelog, draftNewChangelog.join(ENTER), { encoding: 'utf-8' });

tasks/util/constants.js

@@ -7,6 +7,7 @@ var pathToSrc = path.join(pathToRoot, 'src/');
 var pathToLib = path.join(pathToRoot, 'lib/');
 var pathToImageTest = path.join(pathToRoot, 'test/image');
 var pathToStrictD3Module = path.join(pathToRoot, 'test/strict-d3.js');
+var pathToDraftlogs = path.join(pathToRoot, 'draftlogs/');
 var pathToDist = path.join(pathToRoot, 'dist/');
 var pathToBuild = path.join(pathToRoot, 'build/');
 
@@ -168,6 +169,8 @@ module.exports = {
     pathToLib: pathToLib,
     pathToBuild: pathToBuild,
     pathToDist: pathToDist,
+    pathToDraftlogs: pathToDraftlogs,
+    pathToChangelog: path.join(pathToRoot, 'CHANGELOG.md'),
 
     partialBundleTraces: partialBundleTraces,
 

tasks/util/make_empty_directory.js

@@ -7,17 +7,25 @@ module.exports = {
     makeDir: makeDir
 };
 
-function emptyDir(dir) {
+function emptyDir(dir, opts) {
     if(common.doesDirExist(dir)) {
         console.log('empty ' + dir);
         try {
             var allFiles = fs.readdirSync(dir);
+            var hasFilter = false;
+            if(opts && opts.filter) {
+                hasFilter = true;
+                allFiles = allFiles.filter(opts.filter);
+            }
+
             allFiles.forEach(function(file) {
                 // remove file
                 fs.unlinkSync(path.join(dir, file));
             });
 
-            fs.rmdirSync(dir);
+            if(!hasFilter) {
+                fs.rmdirSync(dir);
+            }
         } catch(err) {
             console.error(err);
         }