Commit PR notes to draftlogs and add scripts to provide draft release notes (CHANGELOG.md) and empty draftlogs

draftlogs/.gitignore

@@ -0,0 +1 @@
+

draftlogs/5779_fix.md

@@ -0,0 +1,2 @@
+ - Improve README for ES6 module import [[#5779](https://github.com/plotly/plotly.js/pull/5779)],
+   with thanks to @andreafonso for the contribution!

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_dist.js

@@ -1,36 +1,13 @@
-var path = require('path');
-var fs = require('fs-extra');
-var common = require('./util/common');
 var constants = require('./util/constants');
+var makeEmptyDirectory = require('./util/make_empty_directory');
+var emptyDir = makeEmptyDirectory.emptyDir;
+var makeDir = makeEmptyDirectory.makeDir;
 
 var dist = constants.pathToDist; // dist
 var distTopojson = constants.pathToTopojsonDist; // dist/topojson
+
 // main
 emptyDir(distTopojson);
 emptyDir(dist);
 makeDir(dist);
 makeDir(distTopojson);
-
-function emptyDir(dir) {
-    if(common.doesDirExist(dir)) {
-        console.log('empty ' + dir);
-        try {
-            var allFiles = fs.readdirSync(dir);
-            allFiles.forEach(function(file) {
-                // remove file
-                fs.unlinkSync(path.join(dir, file));
-            });
-
-            fs.rmdirSync(dir);
-        } catch(err) {
-            console.error(err);
-        }
-    }
-}
-
-function makeDir(dir) {
-    if(!common.doesDirExist(dir)) {
-        // create folder
-        fs.mkdirSync(dir);
-    }
-}

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

@@ -0,0 +1,40 @@
+var path = require('path');
+var fs = require('fs-extra');
+var common = require('./common');
+
+module.exports = {
+    emptyDir: emptyDir,
+    makeDir: makeDir
+};
+
+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));
+            });
+
+            if(!hasFilter) {
+                fs.rmdirSync(dir);
+            }
+        } catch(err) {
+            console.error(err);
+        }
+    }
+}
+
+function makeDir(dir) {
+    if(!common.doesDirExist(dir)) {
+        // create folder
+        fs.mkdirSync(dir);
+    }
+}