wikiploy 2.0.1 → 2.1.0

package/README.building your project.md

@@ -34,11 +34,9 @@ Your `package.json` (crucial part being `scripts`):
 		"chai": "4.x",
 		"eslint": "8.x",
 		"less": "4.x",
-		"mocha": "10.x"
+		"mocha": "10.x",
+		"wikiploy": "2.x"
 	},
-	"dependencies": {
-		"wikiploy": "1.x"
-	}
 }
 ```
 

package/README.md

@@ -7,8 +7,9 @@ After the initial setup, you can quickly build and deploy your user scripts and
 
 See also:
 
-- [README: building your project](https://github.com/Eccenux/Wikiploy/blob/main/README.building%20your%20project.md) recommendation on how to build JS and CSS for your gadgets (includes unit testing setup).
-- [Wikipedia:Wikiploy on pl.wiki](https://pl.wikipedia.org/wiki/Wikipedia:Wikiploy) for Polish description.
+- [Wikiploy project template](https://github.com/Eccenux/wikiploy-rollout-example/releases) — quick start for you gadgets.
+- [README: building your project](https://github.com/Eccenux/Wikiploy/blob/main/README.building%20your%20project.md) — recommendation on how to build JS and CSS for your gadgets (includes unit testing setup).
+- [Wikipedia:Wikiploy on pl.wiki](https://pl.wikipedia.org/wiki/Wikipedia:Wikiploy) — Polish description.
 - (more links on the bottom)
 
 ## New capabilities

package/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",

package/src/index.js

@@ -1,7 +1,7 @@
 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;
 
@@ -9,6 +9,7 @@ export {
 	DeployConfig,
 	verlib,
 	userPrompt,
+	setupSummary,
 	WikiployLite,
 	Wikiploy
 };

package/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 };