kempo-testing-framework 1.2.0 → 1.2.2

package/index.js

@@ -10,7 +10,8 @@ const shortFlagMap = {
     'd': 'delay',
     'p': 'port',
     'g': 'gui',
-    'w': 'show-browser'
+    'w': 'show-browser',
+    'h': 'help'
 };
 
 /*
@@ -22,7 +23,7 @@ const remainingArgs = [];
 
 // Define which flags take values vs booleans
 const valueFlags = new Set(['log-level', 'delay', 'port']);
-const booleanFlags = new Set(['browser', 'node', 'gui', 'show-browser']);
+const booleanFlags = new Set(['browser', 'node', 'gui', 'show-browser', 'help', 'debug-flags']);
 
 for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -108,6 +109,48 @@ if (Object.prototype.hasOwnProperty.call(flags, 'log-level')) {
     delete flags['log-level'];
 }
 
+/*
+ * Help Display
+ */
+if (flags.help || flags.h) {
+    console.log(`
+Kempo Testing Framework
+
+USAGE:
+  kempo-test [OPTIONS] [SUITE_FILTER] [TEST_FILTER]
+
+OPTIONS:
+  -h, --help              Show this help message and exit
+  -b, --browser           Run only browser tests
+  -n, --node              Run only node tests
+  -l, --log-level LEVEL   Set log level (0-4 or silent/minimal/normal/verbose/debug)
+  -d, --delay MS          Add delay between tests in milliseconds
+  -p, --port PORT         Set port for test server (default: 3000)
+  -g, --gui               Launch GUI mode
+  -w, --show-browser      Show browser window during tests
+
+ARGUMENTS:
+  SUITE_FILTER           Filter test suites by name
+  TEST_FILTER            Filter individual tests by name
+
+EXAMPLES:
+  kempo-test                    # Run all tests
+  kempo-test --browser          # Run only browser tests
+  kempo-test -l verbose         # Run with verbose logging
+  kempo-test --gui              # Launch GUI mode
+  kempo-test myComponent        # Run tests for 'myComponent' suite
+  kempo-test myComponent myTest # Run specific test in specific suite
+`);
+    process.exit(0);
+}
+
+/*
+ * Debug Flags (for testing only)
+ */
+if (flags['debug-flags']) {
+    console.log('kempo-test flags:', flags);
+}
+
 /*
  * Mode Selection and Execution
  */
@@ -115,8 +158,6 @@ if (flags.gui) {
     const { default: gui } = await import('./src/gui.js');
     await gui(flags, remainingArgs);
 } else {
-    // Log flags to verify capture
-    console.log('kempo-test flags:', flags);
     const { default: cli } = await import('./src/cli.js');
     await cli(flags, remainingArgs);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kempo-testing-framework",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "The Kempo Testing Framework is a simple testing framework built on the principle that code intended to be ran in the browser should be tested in the browser, code intended to be ran in Node should be tested in Node, and code intended to be ran in both should be tested in both. No mocking, no complexity—just testing.",
   "main": "index.js",
   "bin": {

package/src/runBrowserTests.js

@@ -48,6 +48,14 @@ export default async ({
     await page.goto(`${url}?testFile=${testFile}&testFilter=${filter}&delay=${delayMs}`);
     await page.waitForFunction(() => document.readyState === 'complete' || document.readyState === 'interactive');
     
+    // Ensure the test page has focus when browser is visible
+    if (showBrowser) {
+      await page.bringToFront();
+      if (logLevel >= LOG_LEVELS.VERBOSE) {
+        console.log(`\x1b[90m Bringing test page to front\x1b[0m`);
+      }
+    }
+    
     // Check for any errors first
     const hasError = await page.evaluate(() => window.error !== undefined);
     if (hasError) {

package/tests/cli-flags.node-test.js

@@ -1,7 +1,7 @@
 import { spawn } from 'child_process';
 
 const runWithArgs = (args, timeoutMs = 3000) => new Promise((resolve) => {
-  const child = spawn(process.execPath, ['index.js', ...args], {
+  const child = spawn(process.execPath, ['index.js', ...args, '--debug-flags'], {
     cwd: process.cwd(),
     stdio: ['ignore', 'pipe', 'pipe']
   });

package/tests/cli-help.node-test.js

@@ -0,0 +1,61 @@
+import { spawn } from 'child_process';
+
+const runWithHelp = (args, timeoutMs = 3000) => new Promise((resolve) => {
+  const child = spawn(process.execPath, ['index.js', ...args], {
+    cwd: process.cwd(),
+    stdio: ['ignore', 'pipe', 'pipe']
+  });
+  let out = '';
+  let resolved = false;
+
+  const finish = () => {
+    if (resolved) return;
+    resolved = true;
+    try { child.kill('SIGTERM'); } catch {}
+    resolve(out);
+  };
+
+  child.stdout.on('data', (chunk) => {
+    out += chunk.toString();
+    // Help should exit quickly, check for help content
+    if (out.includes('Kempo Testing Framework') && out.includes('USAGE:')) {
+      setTimeout(finish, 50);
+    }
+  });
+  child.stderr.on('data', (chunk) => { out += chunk.toString(); });
+  child.on('error', () => finish());
+  child.on('exit', () => finish());
+
+  setTimeout(finish, timeoutMs);
+});
+
+export default {
+  '--help shows help message and exits': async ({ pass, fail }) => {
+    const out = await runWithHelp(['--help']);
+    const hasHelp = out.includes('Kempo Testing Framework') && 
+                   out.includes('USAGE:') && 
+                   out.includes('OPTIONS:') &&
+                   out.includes('--help');
+    const noTestRun = !out.includes('kempo-test flags:') && !out.includes('Test Summary');
+    
+    if (hasHelp && noTestRun) {
+      pass('--help shows help message and exits without running tests');
+    } else {
+      fail(`Help output incorrect:\nHas help: ${hasHelp}\nNo test run: ${noTestRun}\nOutput:\n${out}`);
+    }
+  },
+  '-h shows help message and exits': async ({ pass, fail }) => {
+    const out = await runWithHelp(['-h']);
+    const hasHelp = out.includes('Kempo Testing Framework') && 
+                   out.includes('USAGE:') && 
+                   out.includes('OPTIONS:') &&
+                   out.includes('--help');
+    const noTestRun = !out.includes('kempo-test flags:') && !out.includes('Test Summary');
+    
+    if (hasHelp && noTestRun) {
+      pass('-h shows help message and exits without running tests');
+    } else {
+      fail(`Help output incorrect:\nHas help: ${hasHelp}\nNo test run: ${noTestRun}\nOutput:\n${out}`);
+    }
+  }
+};