random-word-wikipedia 1.0.5 → 2.0.0

package/cli.js

@@ -1,31 +1,42 @@
 #!/usr/bin/env node
-"use strict";
-const meow = require("meow");
-const randomWordWikipedia = require(".");
 
-const cli = meow(`
-	Usage
-	  $ random-word-wikipedia [lang]
+import { parseArgs } from "node:util";
+import randomWordWikipedia from "./index.js";
 
-	Options
-	  -n 10 or less [Default: 1]
+const help = `
+  Usage
+    $ random-word-wikipedia [lang=en]
 
-	Examples
-	  $ random-word-wikipedia
-		YuruYuri
+  Options
+    -n  Number of words, 10 or less [Default: 1]
 
-	  $ random-word-wikipedia ja -n 3
-		バダインジャラン砂漠
-		内野 (印西市)
-		PAC-MAN 256
+  Examples
+    $ random-word-wikipedia
+    $ random-word-wikipedia ja -n 3
+`;
 
-`);
+const { values, positionals } = parseArgs({
+	allowPositionals: true,
+	options: {
+		n: { type: "string", short: "n" },
+		help: { type: "boolean", short: "h" }
+	}
+});
 
-randomWordWikipedia(cli.input[0], cli.flags.n)
-	.then(res => {
+if (values.help) {
+	console.log(help);
+	process.exit(0);
+}
+
+const lang = positionals[0];
+const n = values.n === undefined ? 1 : Number(values.n);
+
+randomWordWikipedia(lang, n)
+	.then((res) => {
 		console.log(res.join("\n"));
 	})
-	.catch(err => {
-		console.error("Error: err.message");
+	.catch((err) => {
+		console.error(`Error: ${err.message}`);
 		console.error("$ random-word-wikipedia --help");
+		process.exit(1);
 	});

package/index.js

@@ -1,27 +1,20 @@
-require("isomorphic-fetch");
-require("es6-promise").polyfill();
+const randomWordWikipedia = async (lang = "en", n = 1) => {
+	if (typeof lang !== "string") {
+		throw new TypeError(`Expected a string, got ${typeof lang}`);
+	}
 
-module.exports = (lang, n) => {
-	return new Promise(function(resolve, reject) {
-		lang = lang || "en";
-		if (typeof lang !== "string") {
-			throw new TypeError(`Expected a string, got ${typeof lang}`);
-		}
+	if (n <= 0 || n > 10) {
+		throw new TypeError(`Expected a -n (1 - 10), got ${n}`);
+	}
 
-		n = n || 1;
-		if (n <= 0 || n > 10) {
-			throw new TypeError(`Expected a -n (1 - 10), got ${n}`);
-		}
+	// rnlimit: API limit 10 or less
+	const url = `https://${lang}.wikipedia.org/w/api.php?format=json&action=query&list=random&rnnamespace=0&rnlimit=${n}`;
 
-		// rnlimit: API limit 10 or less
-		const url = `http://${lang}.wikipedia.org/w/api.php?format=json&action=query&list=random&rnnamespace=0&rnlimit=10`;
+	const res = await fetch(url);
+	const data = await res.json();
+	const words = data.query.random;
 
-		const res = fetch(url)
-			.then(res => res.json())
-			.then(data => {
-				const words = data.query.random;
-				words.length = n;
-				resolve(words.map(v => v.title));
-			});
-	});
+	return words.slice(-n).map((v) => v.title);
 };
+
+export default randomWordWikipedia;

package/package.json

@@ -1,30 +1,24 @@
 {
 	"name": "random-word-wikipedia",
 	"description": "Get random word from wikipedia random page",
-	"version": "1.0.5",
+	"version": "2.0.0",
 	"author": {
 		"name": "elzup",
 		"email": "guild0105@gmail.com",
-		"url": "elzup.com"
+		"url": "https://anozon.me"
 	},
-	"bin": "cli.js",
-	"dependencies": {
-		"es6-promise": "^4.2.2",
-		"isomorphic-fetch": "^2.2.1",
-		"meow": "^3.7.0"
-	},
-	"devDependencies": {
-		"ava": "^0.20.0"
+	"type": "module",
+	"bin": {
+		"random-word-wikipedia": "./cli.js"
 	},
 	"engines": {
-		"node": ">=6"
+		"node": ">=22"
 	},
 	"files": [
 		"cli.js",
 		"index.js"
 	],
 	"keywords": [
-		"",
 		"cli",
 		"cli-app",
 		"wikipedia",
@@ -34,6 +28,8 @@
 	"license": "MIT",
 	"repository": "elzup/random-word-wikipedia",
 	"scripts": {
-		"test": "ava"
+		"test": "node --test",
+		"cli": "node cli.js",
+		"prepublishOnly": "node --test"
 	}
 }

package/readme.md

@@ -1,74 +1,72 @@
-# random-word-wikipedia [![Build Status](https://travis-ci.org/elzup/random-word-wikipedia.svg?branch=master)](https://travis-ci.org/elzup/random-word-wikipedia)
+# random-word-wikipedia
 
-> Get random word from wikipedia random page
+[![npm](https://img.shields.io/npm/v/random-word-wikipedia.svg)](https://www.npmjs.com/package/random-word-wikipedia)
+[![Node.js CI](https://github.com/elzup/random-word-wikipedia/actions/workflows/node.js.yml/badge.svg)](https://github.com/elzup/random-word-wikipedia/actions/workflows/node.js.yml)
 
+> Get a random word (article title) from Wikipedia's random page.
+
+- 🪶 **Zero dependencies** — uses the platform `fetch`, nothing else
+- 📦 **ESM-only** and typed for modern Node.js (`>= 22`)
+- 🌍 **Any language** — pass a Wikipedia language code (`en`, `ja`, …)
 
 ## Install
 
-```
-$ npm install random-word-wikipedia
+```sh
+npm install random-word-wikipedia
 ```
 
-
 ## Usage
 
 ```js
-const randomWordWikipedia = require('random-word-wikipedia');
+import randomWordWikipedia from "random-word-wikipedia";
 
-randomWordWikipedia().then(console.log);
-//=> [ 'Saxifraga spathularis' ]
+await randomWordWikipedia();
+//=> ['Saxifraga spathularis']
 
-randomWordWikipedia('ja', 2).then(console.log);
-//=> [ 'ジョン・イサーク・ブリケ', '月は闇夜に隠るが如く' ]
+await randomWordWikipedia("ja", 2);
+//=> ['ジョン・イサーク・ブリケ', '月は闇夜に隠るが如く']
 ```
 
-
 ## API
 
-### randomWordWikipedia([lang, n])
-
-#### options
-
-##### lang
-
-Type: `string`<br>
-Default: `en`
+### `randomWordWikipedia(lang?, n?)`
 
-wikipedia lang string.
+Returns `Promise<string[]>` — an array of random article titles.
 
-##### n
+| Param  | Type     | Default | Description                                  |
+| ------ | -------- | ------- | -------------------------------------------- |
+| `lang` | `string` | `"en"`  | Wikipedia language code (e.g. `en`, `ja`).   |
+| `n`    | `number` | `1`     | How many words to return. Must be `1`–`10`.  |
 
-Type: `number` 1 - 10<br>
-Default: 1
-
-number of word.
+Throws a `TypeError` if `lang` is not a string or `n` is outside `1`–`10`.
 
 ## CLI
 
-```
-$ npm install --global random-word-wikipedia
+```sh
+npm install --global random-word-wikipedia
 ```
 
-```
-$ random-word-wikipedia --help
+```console
+$ random-word-wikipedia
+Mapania caudata
 
-	Usage
-	  $ random-word-wikipedia [lang]
+$ random-word-wikipedia ja -n 3
+バダインジャラン砂漠
+内野 (印西市)
+PAC-MAN 256
 
-	Options
-	  -n 10 or less [Default: 1]
+$ random-word-wikipedia --help
 
-	Examples
-	  $ random-word-wikipedia
-		YuruYuri
+  Usage
+    $ random-word-wikipedia [lang=en]
 
-	  $ random-word-wikipedia ja -n 4
-		バダインジャラン砂漠
-		ゆるゆり
-		内野 (印西市)
-		PAC-MAN 256
-```
+  Options
+    -n  Number of words, 10 or less [Default: 1]
 
+  Examples
+    $ random-word-wikipedia
+    $ random-word-wikipedia ja -n 3
+```
 
 ## License
 

package/lib/cli.js

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-
-"use strict";
-
-var _ = require(".");
-
-var _2 = _interopRequireDefault(_);
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-var meow = require("meow");
-
-
-var cli = meow("\n\tUsage\n\t  $ random-word-wikipedia [lang]\n\n\tOptions\n\t  -n 10 or less [Default: 1]\n\n\tExamples\n\t  $ random-word-wikipedia\n\t\tYuruYuri\n\n\t  $ random-word-wikipedia ja -n 3\n\t\t\u30D0\u30C0\u30A4\u30F3\u30B8\u30E3\u30E9\u30F3\u7802\u6F20\n\t\t\u5185\u91CE (\u5370\u897F\u5E02)\n\t\tPAC-MAN 256\n\n");
-
-(0, _2.default)(cli.input[0], cli.flags.n).then(function (res) {
-	console.log(res.join("\n"));
-});
-//# sourceMappingURL=cli.js.map

package/lib/index.js

@@ -1,37 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-	value: true
-});
-
-var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; };
-
-require("isomorphic-fetch");
-
-require("es6-promise").polyfill();
-
-exports.default = async function main(lang, n) {
-	lang = lang || "en";
-	if (typeof lang !== "string") {
-		throw new TypeError("Expected a string, got " + (typeof lang === "undefined" ? "undefined" : _typeof(lang)));
-	}
-
-	n = n || 1;
-	if (n <= 0 || n > 10) {
-		throw new TypeError("Expected a -n (1 - 10), got " + n);
-	}
-
-	// rnlimit: API limit 10 or less
-	var url = "http://" + lang + ".wikipedia.org/w/api.php?format=json&action=query&list=random&rnnamespace=0&rnlimit=10";
-
-	var res = await fetch(url);
-	var data = await res.json();
-	var words = data.query.random;
-	words.length = n;
-	return words.map(function (v) {
-		return v.title;
-	});
-};
-
-module.exports = exports["default"];
-//# sourceMappingURL=index.js.map