v2.1: setupSummary

package.json

@@ -1,6 +1,6 @@
 {
   "name": "wikiploy",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "User scripts and gadgets deployment for MediaWiki (Wikipedia).",
   "main": "src/index.js",
   "type": "module",

src/index.js

@@ -1,14 +1,15 @@
 import DeployConfig from './DeployConfig.js';
 import WikiployLite from './WikiployLite.js';
 import * as verlib from './version.js';
-import { userPrompt } from './userPrompt.js';
+import { userPrompt, setupSummary } from './userPrompt.js';
 
 const Wikiploy = WikiployLite;
 
 export {
 	DeployConfig,
 	verlib,
 	userPrompt,
+	setupSummary,
 	WikiployLite,
 	Wikiploy
 };

src/userPrompt.js

@@ -1,6 +1,11 @@
 import readline from 'node:readline';
 import { stdin as input, stdout as output } from 'node:process';
 
+/**
+ * Prompt for summary.
+ * @param {String} prompt Prompt information to display.
+ * @returns 
+ */
 const userPrompt = (prompt) => {
 	const rl = readline.createInterface({ input, output });
 
@@ -13,4 +18,22 @@ const userPrompt = (prompt) => {
 	});
 };
 
-export { userPrompt };
+/**
+ * Read (prompt) and setup summary.
+ * @param {WikiployLite} ployBot Bot object (required to setup `summary()`).
+ * @param {Number} version Gadget version.
+ * @param {String} standardSummary Standard summary (aside from version).
+ */
+async function setupSummary(ployBot, version = '', standardSummary = 'changes from Github') {
+	let info = version.length ? `(empty for a standard summary prefixed with v${version})` : `(empty for a standard summary)`;
+	let summary = await userPrompt(`Summary of changes ${info}:`);
+	if (typeof summary !== 'string' || !summary.length) {
+		summary = standardSummary;
+	}
+	ployBot.summary = () => {
+		return version.length ? `v${version}: ${summary}` : summary;
+	};
+	console.log(`[INFO] summary: »${ployBot.summary()}«\n`);
+}
+
+export { userPrompt, setupSummary };