utilium 2.5.2 → 2.5.3

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "utilium",
-	"version": "2.5.2",
+	"version": "2.5.3",
 	"description": "Typescript utilities",
 	"funding": {
 		"type": "individual",

package/scripts/lice.js

@@ -2,37 +2,78 @@
 // SPDX-License-Identifier: LGPL-3.0-or-later
 // Copyright (c) 2025 James Prevett
 
-import { readdirSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
-import { join, matchesGlob, relative } from 'node:path';
+import { dirname, join, matchesGlob, relative } from 'node:path';
 import { parseArgs, styleText } from 'node:util';
 
-const {
-	positionals: dirs,
-	values: { license: expectedLicense, write, verbose, force, exclude },
-} = parseArgs({
+const { positionals: dirs, values: opts } = parseArgs({
 	allowPositionals: true,
 	options: {
-		license: { type: 'string', short: 'L' },
-		write: { type: 'boolean', short: 'w', default: false },
-		verbose: { type: 'boolean', short: 'v', default: false },
+		auto: { type: 'boolean', short: 'a', default: false },
+		exclude: { type: 'string', short: 'x', default: [], multiple: true },
 		force: { type: 'boolean', short: 'f', default: false },
-		exclude: { type: 'string', short: 'x', default: '' },
+		help: { type: 'boolean', short: 'h', default: false },
+		license: { type: 'string', short: 'l' },
+		verbose: { type: 'boolean', short: 'v', default: false },
+		write: { type: 'boolean', short: 'w', default: false },
 	},
 });
 
-if (write && !expectedLicense) {
-	console.error(styleText('red', 'You must specify a license to write with --license/-L'));
+if (opts.help) {
+	console.error(`Usage: lice [options] <dirs...>
+
+Options:
+    -f, --force         Force overwrite of existing license headers
+    -h, --help          Show this help message
+    -a, --auto          Detect the SPDX identifier in package.json
+    -l, --license       Specify the SPDX license identifier to check for.
+    -v, --verbose       Enable verbose output
+    -w, --write         Write the license header if missing
+    -x, --exclude       Glob pattern to exclude files
+`);
+	process.exit(0);
+}
+
+/**
+ *
+ * @returns {string|null}
+ */
+function get_license() {
+	for (let dir = process.cwd(); dir != '/'; dir = dirname(dir)) {
+		const pkgPath = join(dir, 'package.json');
+		if (!existsSync(pkgPath)) continue;
+
+		const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+		if (pkg.spdx) return pkg.spdx;
+		if (pkg.spdxLicense) return pkg.spdxLicense;
+		if (pkg.license) return pkg.license;
+	}
+
+	return null;
+}
+
+const expectedLicense = opts.license || (opts.auto && get_license());
+
+if (opts.write && !expectedLicense) {
+	console.error(styleText('red', 'You must specify a license to write.'));
 	process.exit(1);
 }
 
+function should_exclude(path, display) {
+	for (const pattern of opts.exclude) {
+		if (!matchesGlob(path, pattern)) continue;
+		console.log(styleText('whiteBright', 'Skipped:'), display);
+		return true;
+	}
+
+	return false;
+}
+
 const licenseSpec = /^\s*\/(?:\/|\*) SPDX-License-Identifier: (.+)/;
 
 async function check_file(path, display) {
-	if (matchesGlob(path, exclude)) {
-		console.log(styleText('whiteBright', 'Skipped:'), display);
-		return 'skipped';
-	}
+	if (should_exclude(path, display)) return 'skipped';
 
 	const content = await readFile(path, 'utf-8');
 
@@ -44,14 +85,14 @@ async function check_file(path, display) {
 	}
 
 	if (!expectedLicense) {
-		if (verbose) console.log(styleText(['dim'], 'Found:'), display);
+		if (opts.verbose) console.log(styleText(['dim'], 'Found:'), display);
 		return 'with license';
 	}
 
 	const [, license] = match;
 
 	if (license == expectedLicense) {
-		if (verbose) console.log(styleText(['green', 'dim'], 'Correct:'), display);
+		if (opts.verbose) console.log(styleText(['green', 'dim'], 'Correct:'), display);
 		return 'correct';
 	}
 
@@ -60,10 +101,7 @@ async function check_file(path, display) {
 }
 
 async function write_file(path, display) {
-	if (matchesGlob(path, exclude)) {
-		console.log(styleText('whiteBright', 'Skipped:'), display);
-		return 'skipped';
-	}
+	if (should_exclude(path, display)) return 'skipped';
 
 	const content = await readFile(path, 'utf-8');
 
@@ -79,13 +117,13 @@ async function write_file(path, display) {
 	const [, license] = match;
 
 	if (license == expectedLicense) {
-		if (verbose) console.log(styleText(['green', 'dim'], 'Correct:'), display);
+		if (opts.verbose) console.log(styleText(['green', 'dim'], 'Correct:'), display);
 		return 'correct';
 	}
 
 	process.stdout.write(styleText('yellow', 'Mismatch: ') + display);
 
-	if (!force) {
+	if (!opts.force) {
 		console.log(styleText('whiteBright', ' (skipped)'));
 		return 'skipped';
 	}
@@ -96,6 +134,8 @@ async function write_file(path, display) {
 }
 
 function check_dir(dir, display) {
+	if (should_exclude(dir, display)) return 'skipped';
+
 	const entries = readdirSync(dir, { withFileTypes: true });
 
 	const results = [];
@@ -108,7 +148,7 @@ function check_dir(dir, display) {
 
 		if (!entry.isFile()) continue;
 
-		const op = write ? write_file : check_file;
+		const op = opts.write ? write_file : check_file;
 		results.push(op(join(dir, entry.name), join(display, entry.name)));
 	}
 
@@ -120,7 +160,7 @@ if (!dirs.length) {
 	process.exit(1);
 }
 
-if (verbose) console.log('Checking:', dirs.join(', '));
+if (opts.verbose) console.log('Checking:', dirs.join(', '));
 
 const promises = [];
 
@@ -147,7 +187,7 @@ try {
 		results[result]++;
 	}
 	console.log(
-		write ? 'Wrote' : 'Checked',
+		opts.write ? 'Wrote' : 'Checked',
 		styleText('blueBright', raw_results.length.toString()),
 		'files:',
 		Object.entries(results)

package/scripts/tsconfig.json

@@ -0,0 +1,10 @@
+{
+	"compilerOptions": {
+		"checkJs": true,
+		"noEmit": true,
+		"lib": ["ESNext"],
+		"module": "NodeNext",
+		"moduleResolution": "NodeNext"
+	},
+	"include": ["*.js"]
+}