kempo-testing-framework 1.2.3 → 1.3.3

package/src/browserTestServer.js

@@ -1,115 +1,115 @@
-import http from 'http';
-import { readFile } from 'fs/promises';
-import { fileURLToPath } from 'url';
-import path from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-let server;
-let port;
-
-export const startServer = async (_port = 3000) => {
-  if(!server){
-    port = _port;
-    server = http.createServer(async (req, res) => {
-      const basePath = req.url.split('?')[0];
-      
-      /*
-       * Route Handling
-       */
-      if(basePath === '/'){
-        res.writeHead(200, { 'Content-Type': 'text/html' });
-        const testHtmlPath = path.join(__dirname, '..', 'test.html');
-        res.end(await readFile(testHtmlPath, 'utf8'));
-      } else if(basePath === '/runTests.js'){
-        res.writeHead(200, { 'Content-Type': 'application/javascript' });
-        const filePath = path.join(__dirname, 'runTests.js');
-        res.end(await readFile(filePath, 'utf8'));
-      }
-      // Serve essential.css like the GUI server does
-      else if (basePath === '/essential.css') {
-        try {
-          const cssPath = path.join(__dirname, '../node_modules/essentialcss/dist/essential.min.css');
-          const css = await readFile(cssPath, 'utf8');
-          res.writeHead(200, { 'Content-Type': 'text/css' });
-          res.end(css);
-        } catch (error) {
-          console.error(`Error serving essential.css:`, error);
-          res.writeHead(404);
-          res.end('Not found');
-        }
-      } else if(['/favicon.ico', '/.well-known/appspecific/com.chrome.devtools.json'].includes(basePath)){
-        res.writeHead(404);
-        res.end('');
-      } else {
-        /*
-         * Static File Serving
-         */
-        try {
-          // First try from project root, e.g. /gui/components/* works already
-          const primaryPath = `.${basePath}`;
-          let fileContent = await readFile(primaryPath);
-          const extension = basePath.split('.').pop().toLowerCase();
-          let contentType = 'text/plain';
-          switch(extension){
-            case 'html': contentType = 'text/html'; break;
-            case 'css': contentType = 'text/css'; break;
-            case 'js': contentType = 'application/javascript'; break;
-            case 'json': contentType = 'application/json'; break;
-            case 'png': contentType = 'image/png'; break;
-            case 'jpg': case 'jpeg': contentType = 'image/jpeg'; break;
-            case 'gif': contentType = 'image/gif'; break;
-            case 'svg': contentType = 'image/svg+xml'; break;
-            case 'map': contentType = 'application/json'; break;
-          }
-          res.writeHead(200, { 'Content-Type': contentType });
-          res.end(fileContent);
-        } catch (primaryErr) {
-          // If requesting a sourcemap, quietly 404 without noisy logs
-          if (basePath.endsWith('.map')) {
-            res.writeHead(404);
-            res.end('Not found');
-            return;
-          }
-          // If not found, try resolving under gui/ for assets like /icons/*
-          try {
-            const rel = basePath.replace(/^\//, '');
-            const relUnderGui = rel.startsWith('gui/') ? rel : path.join('gui', rel);
-            const fallbackPath = path.join(__dirname, '..', relUnderGui);
-            const fileContent = await readFile(fallbackPath);
-            const extension = basePath.split('.').pop().toLowerCase();
-            let contentType = 'text/plain';
-            switch(extension){
-              case 'html': contentType = 'text/html'; break;
-              case 'css': contentType = 'text/css'; break;
-              case 'js': contentType = 'application/javascript'; break;
-              case 'json': contentType = 'application/json'; break;
-              case 'png': contentType = 'image/png'; break;
-              case 'jpg': case 'jpeg': contentType = 'image/jpeg'; break;
-              case 'gif': contentType = 'image/gif'; break;
-              case 'svg': contentType = 'image/svg+xml'; break;
-              case 'map': contentType = 'application/json'; break;
-            }
-            res.writeHead(200, { 'Content-Type': contentType });
-            res.end(fileContent);
-          } catch (fallbackErr) {
-            res.writeHead(404);
-            res.end('Not found');
-          }
-        }
-      }
-    });
-    await new Promise((resolve, reject) => {
-      server.listen(port, err => err ? reject(err) : resolve());
-    });
-  }
-  return `http://localhost:${port}`;
-};
-
-export const stopServer = async () => {
-  if(server){
-  await new Promise(resolve => server.close(resolve));
-    server = null;
-  }
-};
+import http from 'http';
+import { readFile } from 'fs/promises';
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+let server;
+let port;
+
+export const startServer = async (_port = 3000) => {
+  if(!server){
+    port = _port;
+    server = http.createServer(async (req, res) => {
+      const basePath = req.url.split('?')[0];
+      
+      /*
+       * Route Handling
+       */
+      if(basePath === '/'){
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        const testHtmlPath = path.join(__dirname, '..', 'test.html');
+        res.end(await readFile(testHtmlPath, 'utf8'));
+      } else if(basePath === '/runTests.js'){
+        res.writeHead(200, { 'Content-Type': 'application/javascript' });
+        const filePath = path.join(__dirname, 'runTests.js');
+        res.end(await readFile(filePath, 'utf8'));
+      }
+      // Serve kempo.css like the GUI server does
+      else if (basePath === '/kempo.css') {
+        try {
+          const cssPath = path.join(__dirname, '../node_modules/kempo-css/dist/kempo.min.css');
+          const css = await readFile(cssPath, 'utf8');
+          res.writeHead(200, { 'Content-Type': 'text/css' });
+          res.end(css);
+        } catch (error) {
+          console.error(`Error serving kempo.css:`, error);
+          res.writeHead(404);
+          res.end('Not found');
+        }
+      } else if(['/favicon.ico', '/.well-known/appspecific/com.chrome.devtools.json'].includes(basePath)){
+        res.writeHead(404);
+        res.end('');
+      } else {
+        /*
+         * Static File Serving
+         */
+        try {
+          // First try from project root, e.g. /gui/components/* works already
+          const primaryPath = `.${basePath}`;
+          let fileContent = await readFile(primaryPath);
+          const extension = basePath.split('.').pop().toLowerCase();
+          let contentType = 'text/plain';
+          switch(extension){
+            case 'html': contentType = 'text/html'; break;
+            case 'css': contentType = 'text/css'; break;
+            case 'js': contentType = 'application/javascript'; break;
+            case 'json': contentType = 'application/json'; break;
+            case 'png': contentType = 'image/png'; break;
+            case 'jpg': case 'jpeg': contentType = 'image/jpeg'; break;
+            case 'gif': contentType = 'image/gif'; break;
+            case 'svg': contentType = 'image/svg+xml'; break;
+            case 'map': contentType = 'application/json'; break;
+          }
+          res.writeHead(200, { 'Content-Type': contentType });
+          res.end(fileContent);
+        } catch (primaryErr) {
+          // If requesting a sourcemap, quietly 404 without noisy logs
+          if (basePath.endsWith('.map')) {
+            res.writeHead(404);
+            res.end('Not found');
+            return;
+          }
+          // If not found, try resolving under gui/ for assets like /icons/*
+          try {
+            const rel = basePath.replace(/^\//, '');
+            const relUnderGui = rel.startsWith('gui/') ? rel : path.join('gui', rel);
+            const fallbackPath = path.join(__dirname, '..', relUnderGui);
+            const fileContent = await readFile(fallbackPath);
+            const extension = basePath.split('.').pop().toLowerCase();
+            let contentType = 'text/plain';
+            switch(extension){
+              case 'html': contentType = 'text/html'; break;
+              case 'css': contentType = 'text/css'; break;
+              case 'js': contentType = 'application/javascript'; break;
+              case 'json': contentType = 'application/json'; break;
+              case 'png': contentType = 'image/png'; break;
+              case 'jpg': case 'jpeg': contentType = 'image/jpeg'; break;
+              case 'gif': contentType = 'image/gif'; break;
+              case 'svg': contentType = 'image/svg+xml'; break;
+              case 'map': contentType = 'application/json'; break;
+            }
+            res.writeHead(200, { 'Content-Type': contentType });
+            res.end(fileContent);
+          } catch (fallbackErr) {
+            res.writeHead(404);
+            res.end('Not found');
+          }
+        }
+      }
+    });
+    await new Promise((resolve, reject) => {
+      server.listen(port, err => err ? reject(err) : resolve());
+    });
+  }
+  return `http://localhost:${port}`;
+};
+
+export const stopServer = async () => {
+  if(server){
+  await new Promise(resolve => server.close(resolve));
+    server = null;
+  }
+};

package/src/cli.js

@@ -1,198 +1,198 @@
-import runTestFiles from './runTestFiles.js';
-import LOG_LEVELS from './utils/logLevels.js';
-
-export default async (flags, args) => {
-  const [suiteFilter, testFilter] = args;
-  
-  /*
-   * Log Level Configuration
-   */
-  let logLevel = LOG_LEVELS.NORMAL;
-  if (typeof flags.logLevel === 'number' && Number.isFinite(flags.logLevel)) {
-    const lvl = Math.max(0, Math.min(4, flags.logLevel));
-    logLevel = lvl;
-  }
-  
-  if(logLevel >= LOG_LEVELS.DEBUG){
-    console.log('\x1b[90m[Debug] Flags:', flags);
-    console.log('[Debug] Args:', args);
-    console.log(`[Debug] Log level: ${logLevel}\x1b[0m`);
-  }
-  
-  /*
-   * Test Configuration
-   */
-  const showBrowser = Boolean(flags['show-browser']);
-  const runBrowser = Boolean(flags.browser);
-  const runNode = Boolean(flags.node);
-  const shouldRunBrowser = runBrowser || (!runBrowser && !runNode);
-  const shouldRunNode = runNode || (!runBrowser && !runNode);
-  const port = flags.port ? parseInt(flags.port, 10) : 3000;
-  // Parse delay (milliseconds). Non-numeric or missing => 0
-  const delayMs = Number.isFinite(parseInt(flags.delay, 10)) ? Math.max(0, parseInt(flags.delay, 10)) : 0;
-
-  /*
-   * Color Configuration
-   */
-  const colors = {
-    reset: '\x1b[0m',
-    bright: '\x1b[1m',
-    green: '\x1b[32m',
-    red: '\x1b[31m',
-    cyan: '\x1b[36m',
-    magenta: '\x1b[35m',
-    gray: '\x1b[90m',
-    blue: '\x1b[34m'
-  };
-
-  /*
-   * Test Execution
-   */
-  const { nodeResults, browserResults } = await runTestFiles({
-    suiteFilter,
-    testFilter,
-    shouldRunBrowser,
-    shouldRunNode,
-    showBrowser,
-    port,
-    logLevel,
-    delayMs,
-    onNodeTestStart: logLevel > LOG_LEVELS.MINIMAL ? (file) => {
-      console.log(`${colors.cyan}Running Node test: ${file}${colors.reset}`);
-    } : undefined,
-    onBrowserTestStart: logLevel > LOG_LEVELS.MINIMAL ? (file) => {
-      console.log(`${colors.magenta}Running Browser test: ${file}${colors.reset}`);
-    } : undefined
-  });
-  
-  /*
-   * Results Display
-   */
-  if(logLevel >= LOG_LEVELS.SILENT){
-    displayResults('Node', nodeResults, logLevel, colors);
-    displayResults('Browser', browserResults, logLevel, colors);
-    displaySummary(nodeResults, browserResults, colors);
-  }
-};
-
-const displayResults = (type, results, logLevel, colors) => {
-  if(Object.keys(results).length === 0) return;
-  
-  if(logLevel > LOG_LEVELS.MINIMAL){
-    console.log(`\n${colors.bright}=== ${type} Test Results ====${colors.reset}`);
-  }
-  let hasFailedTests = false;
-  if(logLevel === LOG_LEVELS.MINIMAL){
-    for(const [_, result] of Object.entries(results)){
-      for(const [_, testResult] of Object.entries(result.tests)){
-        if(!testResult.passed){
-          hasFailedTests = true;
-          break;
-        }
-      }
-      if(hasFailedTests) break;
-    }
-    
-    if(hasFailedTests){
-      console.log(`\n${colors.red}Failed ${type} Tests:${colors.reset}`);
-    }
-  }
-  
-  for(const [file, result] of Object.entries(results)){
-    let fileHeaderShown = logLevel > LOG_LEVELS.MINIMAL;
-    
-    if(logLevel >= LOG_LEVELS.VERBOSE && result.beforeAllLogs?.length){
-      if(!fileHeaderShown){
-        console.log(`\n${colors.bright}${file}${colors.reset}`);
-        fileHeaderShown = true;
-      }
-      console.log(`${colors.blue}${colors.bright}beforeAll${colors.reset}`);
-      result.beforeAllLogs.forEach(log => {
-        if(log.level <= logLevel){
-          console.log(`  ${colors.blue}${log.message}${colors.reset}`);
-        }
-      });
-    }
-    for(const [testName, testResult] of Object.entries(result.tests)){
-      
-      if(logLevel === LOG_LEVELS.MINIMAL && testResult.passed){
-        continue;
-      }
-      const passStatus = testResult.passed 
-        ? `${colors.green}PASS${colors.reset}` 
-        : `${colors.red}FAIL${colors.reset}`;
-      
-      if(!fileHeaderShown){
-        console.log(`\n${colors.bright}${file}${colors.reset}`);
-        fileHeaderShown = true;
-      }
-      
-      if(logLevel >= LOG_LEVELS.MINIMAL){
-        console.log(`  ${passStatus} ${testName}`);
-      }
-      
-      if(logLevel >= LOG_LEVELS.VERBOSE || (!testResult.passed && logLevel >= LOG_LEVELS.NORMAL)){
-        if(testResult.logs && testResult.logs.length > 0){
-          if(logLevel >= LOG_LEVELS.VERBOSE){
-            console.log(`    ${colors.cyan}--Test Logs--${colors.reset}`);
-          }
-          
-          const logsToShow = testResult.logs.filter(log => {
-            if(logLevel >= LOG_LEVELS.VERBOSE) return true;
-            return log.type !== 'progress' && log.level <= logLevel;
-          });
-            
-          logsToShow.forEach(log => {
-            let logColor = colors.gray;
-            if(log.type === 'fail') logColor = colors.red;
-            if(log.type === 'pass') logColor = colors.green;
-            
-            console.log(`      ${logColor}${log.message}${colors.reset}`);
-          });
-        }
-      }
-    }
-    
-    if(logLevel >= LOG_LEVELS.VERBOSE && result.afterAllLogs?.length){
-      if(!fileHeaderShown){
-        console.log(`\n${colors.bright}${file}${colors.reset}`);
-        fileHeaderShown = true;
-      }
-      console.log(`${colors.blue}${colors.bright}afterAll${colors.reset}`);
-      result.afterAllLogs.forEach(log => {
-        if(log.level <= logLevel){
-          console.log(`  ${colors.blue}${log.message}${colors.reset}`);
-        }
-      });
-    }
-  }
-};
-
-const displaySummary = (nodeResults, browserResults, colors) => {
-  let totalTests = 0;
-  let passedTests = 0;
-  let failedTests = 0;
-  Object.values(nodeResults).forEach(result => {
-    Object.values(result.tests || {}).forEach(test => {
-      totalTests++;
-      if(test.passed) passedTests++;
-      else failedTests++;
-    });
-  });
-  Object.values(browserResults).forEach(result => {
-    Object.values(result.tests || {}).forEach(test => {
-      totalTests++;
-      if(test.passed) passedTests++;
-      else failedTests++;
-    });
-  });
-  console.log(`\n${colors.bright}=== Test Summary ====${colors.reset}`);
-  console.log(`${colors.bright}Total Tests:${colors.reset} ${totalTests}`);
-  console.log(`${colors.green}Passed:${colors.reset} ${passedTests}`);
-  console.log(`${colors.red}Failed:${colors.reset} ${failedTests}`);
-  if(failedTests === 0){
-    console.log(`\n${colors.green}${colors.bright}All tests passed!${colors.reset}`);
-  } else {
-    console.log(`\n${colors.red}${colors.bright}Some tests failed. See details above.${colors.reset}`);
-  }
-};
+import runTestFiles from './runTestFiles.js';
+import LOG_LEVELS from './utils/logLevels.js';
+
+export default async (flags, args) => {
+  const [suiteFilter, testFilter] = args;
+  
+  /*
+   * Log Level Configuration
+   */
+  let logLevel = LOG_LEVELS.NORMAL;
+  if (typeof flags.logLevel === 'number' && Number.isFinite(flags.logLevel)) {
+    const lvl = Math.max(0, Math.min(4, flags.logLevel));
+    logLevel = lvl;
+  }
+  
+  if(logLevel >= LOG_LEVELS.DEBUG){
+    console.log('\x1b[90m[Debug] Flags:', flags);
+    console.log('[Debug] Args:', args);
+    console.log(`[Debug] Log level: ${logLevel}\x1b[0m`);
+  }
+  
+  /*
+   * Test Configuration
+   */
+  const showBrowser = Boolean(flags['show-browser']);
+  const runBrowser = Boolean(flags.browser);
+  const runNode = Boolean(flags.node);
+  const shouldRunBrowser = runBrowser || (!runBrowser && !runNode);
+  const shouldRunNode = runNode || (!runBrowser && !runNode);
+  const port = flags.port ? parseInt(flags.port, 10) : 3000;
+  // Parse delay (milliseconds). Non-numeric or missing => 0
+  const delayMs = Number.isFinite(parseInt(flags.delay, 10)) ? Math.max(0, parseInt(flags.delay, 10)) : 0;
+
+  /*
+   * Color Configuration
+   */
+  const colors = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    green: '\x1b[32m',
+    red: '\x1b[31m',
+    cyan: '\x1b[36m',
+    magenta: '\x1b[35m',
+    gray: '\x1b[90m',
+    blue: '\x1b[34m'
+  };
+
+  /*
+   * Test Execution
+   */
+  const { nodeResults, browserResults } = await runTestFiles({
+    suiteFilter,
+    testFilter,
+    shouldRunBrowser,
+    shouldRunNode,
+    showBrowser,
+    port,
+    logLevel,
+    delayMs,
+    onNodeTestStart: logLevel > LOG_LEVELS.MINIMAL ? (file) => {
+      console.log(`${colors.cyan}Running Node test: ${file}${colors.reset}`);
+    } : undefined,
+    onBrowserTestStart: logLevel > LOG_LEVELS.MINIMAL ? (file) => {
+      console.log(`${colors.magenta}Running Browser test: ${file}${colors.reset}`);
+    } : undefined
+  });
+  
+  /*
+   * Results Display
+   */
+  if(logLevel >= LOG_LEVELS.SILENT){
+    displayResults('Node', nodeResults, logLevel, colors);
+    displayResults('Browser', browserResults, logLevel, colors);
+    displaySummary(nodeResults, browserResults, colors);
+  }
+};
+
+const displayResults = (type, results, logLevel, colors) => {
+  if(Object.keys(results).length === 0) return;
+  
+  if(logLevel > LOG_LEVELS.MINIMAL){
+    console.log(`\n${colors.bright}=== ${type} Test Results ====${colors.reset}`);
+  }
+  let hasFailedTests = false;
+  if(logLevel === LOG_LEVELS.MINIMAL){
+    for(const [_, result] of Object.entries(results)){
+      for(const [_, testResult] of Object.entries(result.tests)){
+        if(!testResult.passed){
+          hasFailedTests = true;
+          break;
+        }
+      }
+      if(hasFailedTests) break;
+    }
+    
+    if(hasFailedTests){
+      console.log(`\n${colors.red}Failed ${type} Tests:${colors.reset}`);
+    }
+  }
+  
+  for(const [file, result] of Object.entries(results)){
+    let fileHeaderShown = logLevel > LOG_LEVELS.MINIMAL;
+    
+    if(logLevel >= LOG_LEVELS.VERBOSE && result.beforeAllLogs?.length){
+      if(!fileHeaderShown){
+        console.log(`\n${colors.bright}${file}${colors.reset}`);
+        fileHeaderShown = true;
+      }
+      console.log(`${colors.blue}${colors.bright}beforeAll${colors.reset}`);
+      result.beforeAllLogs.forEach(log => {
+        if(log.level <= logLevel){
+          console.log(`  ${colors.blue}${log.message}${colors.reset}`);
+        }
+      });
+    }
+    for(const [testName, testResult] of Object.entries(result.tests)){
+      
+      if(logLevel === LOG_LEVELS.MINIMAL && testResult.passed){
+        continue;
+      }
+      const passStatus = testResult.passed 
+        ? `${colors.green}PASS${colors.reset}` 
+        : `${colors.red}FAIL${colors.reset}`;
+      
+      if(!fileHeaderShown){
+        console.log(`\n${colors.bright}${file}${colors.reset}`);
+        fileHeaderShown = true;
+      }
+      
+      if(logLevel >= LOG_LEVELS.MINIMAL){
+        console.log(`  ${passStatus} ${testName}`);
+      }
+      
+      if(logLevel >= LOG_LEVELS.VERBOSE || (!testResult.passed && logLevel >= LOG_LEVELS.NORMAL)){
+        if(testResult.logs && testResult.logs.length > 0){
+          if(logLevel >= LOG_LEVELS.VERBOSE){
+            console.log(`    ${colors.cyan}--Test Logs--${colors.reset}`);
+          }
+          
+          const logsToShow = testResult.logs.filter(log => {
+            if(logLevel >= LOG_LEVELS.VERBOSE) return true;
+            return log.type !== 'progress' && log.level <= logLevel;
+          });
+            
+          logsToShow.forEach(log => {
+            let logColor = colors.gray;
+            if(log.type === 'fail') logColor = colors.red;
+            if(log.type === 'pass') logColor = colors.green;
+            
+            console.log(`      ${logColor}${log.message}${colors.reset}`);
+          });
+        }
+      }
+    }
+    
+    if(logLevel >= LOG_LEVELS.VERBOSE && result.afterAllLogs?.length){
+      if(!fileHeaderShown){
+        console.log(`\n${colors.bright}${file}${colors.reset}`);
+        fileHeaderShown = true;
+      }
+      console.log(`${colors.blue}${colors.bright}afterAll${colors.reset}`);
+      result.afterAllLogs.forEach(log => {
+        if(log.level <= logLevel){
+          console.log(`  ${colors.blue}${log.message}${colors.reset}`);
+        }
+      });
+    }
+  }
+};
+
+const displaySummary = (nodeResults, browserResults, colors) => {
+  let totalTests = 0;
+  let passedTests = 0;
+  let failedTests = 0;
+  Object.values(nodeResults).forEach(result => {
+    Object.values(result.tests || {}).forEach(test => {
+      totalTests++;
+      if(test.passed) passedTests++;
+      else failedTests++;
+    });
+  });
+  Object.values(browserResults).forEach(result => {
+    Object.values(result.tests || {}).forEach(test => {
+      totalTests++;
+      if(test.passed) passedTests++;
+      else failedTests++;
+    });
+  });
+  console.log(`\n${colors.bright}=== Test Summary ====${colors.reset}`);
+  console.log(`${colors.bright}Total Tests:${colors.reset} ${totalTests}`);
+  console.log(`${colors.green}Passed:${colors.reset} ${passedTests}`);
+  console.log(`${colors.red}Failed:${colors.reset} ${failedTests}`);
+  if(failedTests === 0){
+    console.log(`\n${colors.green}${colors.bright}All tests passed!${colors.reset}`);
+  } else {
+    console.log(`\n${colors.red}${colors.bright}Some tests failed. See details above.${colors.reset}`);
+  }
+};