@flash-ai-team/flash-test-framework 0.0.13 → 0.0.15

package/README.md

@@ -18,9 +18,25 @@ Then you can use:
 
 ```bash
 flash-test init <project-name>
+flash-test run <suite-name> [-browser <browser>]
+flash-test latest-run <suite-name>
+flash-test history [suite-name]
 flash-test --version
 ```
 
+### Commands
+
+*   `init <project-name>`: Initialize a new project structure.
+*   `run <suite-name>`: Run a specific test suite.
+    *   Example: `flash-test run parallel_suite`
+    *   Example: `flash-test run parallel_suite -browser firefox`
+*   `latest-run <suite-name>`: View the status of the most recent run for a suite.
+    *   Example: `flash-test latest-run parallel_suite`
+*   `history [suite-name]`: View historical test runs and open the HTML dashboard.
+    *   Example: `flash-test history` (All suites)
+    *   Example: `flash-test history parallel_suite` (Specific suite)
+*   `--version`: Show CLI version.
+
 1.  **Initialize a new project**:
     Make a new folder and run:
     ```bash

package/dist/cli/index.js

@@ -20,8 +20,17 @@ else if (command === 'history') {
     const suiteName = args[1];
     showHistory(suiteName);
 }
+else if (command === 'run') {
+    runSuite(args.slice(1));
+}
+else if (command === 'latest-run') {
+    const suiteName = args[1];
+    showLatestRun(suiteName);
+}
 else {
     console.log('Usage: flash-test init [project-name]');
+    console.log('       flash-test run <suite-name> [-browser <browser-name>]');
+    console.log('       flash-test latest-run <suite-name>');
     console.log('       flash-test history [suite-name]');
     console.log('       flash-test -v / --version');
     process.exit(1);
@@ -336,3 +345,93 @@ function generateHistoryHtml(runs, reportsDir) {
         console.log('Could not auto-open browser. Please open the file manually.');
     }
 }
+function runSuite(args) {
+    const suiteName = args[0];
+    if (!suiteName) {
+        console.error('Error: Suite name is required.');
+        console.log('Usage: flash-test run <suite-name> [-browser <browser-name>]');
+        process.exit(1);
+    }
+    const suitePath = `tests/suites/${suiteName}.spec.ts`;
+    if (!fs_1.default.existsSync(path_1.default.join(process.cwd(), suitePath))) {
+        console.error(`Error: Suite file not found at ${suitePath}`);
+        process.exit(1);
+    }
+    let cmd = `npx playwright test ${suitePath}`;
+    // Check for -browser flag
+    const browserIndex = args.indexOf('-browser');
+    if (browserIndex !== -1 && args[browserIndex + 1]) {
+        const browser = args[browserIndex + 1];
+        cmd += ` --project=${browser}`;
+    }
+    console.log(`Executing: ${cmd}`);
+    try {
+        (0, child_process_1.execSync)(cmd, { stdio: 'inherit' });
+    }
+    catch (e) {
+        process.exit(1);
+    }
+}
+function showLatestRun(suiteName) {
+    if (!suiteName) {
+        console.error('Error: Suite name is required for latest-run.');
+        process.exit(1);
+    }
+    const reportsDir = path_1.default.join(process.cwd(), 'reports', suiteName);
+    if (!fs_1.default.existsSync(reportsDir)) {
+        console.log(`No reports found for suite: ${suiteName}`);
+        return;
+    }
+    // Find latest timestamp folder
+    const runs = fs_1.default.readdirSync(reportsDir)
+        .filter(f => f.startsWith('test_') && fs_1.default.statSync(path_1.default.join(reportsDir, f)).isDirectory())
+        .sort((a, b) => b.localeCompare(a)); // Reverse sort to get newest first
+    if (runs.length === 0) {
+        console.log(`No runs found for suite: ${suiteName}`);
+        return;
+    }
+    const latestRun = runs[0];
+    const runPath = path_1.default.join(reportsDir, latestRun);
+    const jsonPath = path_1.default.join(runPath, 'custom-report.json');
+    console.log(`\nLatest Run: ${suiteName}`);
+    console.log(`Timestamp: ${latestRun.replace('test_', '')}`);
+    console.log(`Report Path: ${runPath}`);
+    console.log('----------------------------------------');
+    if (fs_1.default.existsSync(jsonPath)) {
+        try {
+            const data = JSON.parse(fs_1.default.readFileSync(jsonPath, 'utf-8'));
+            let status = 'Unknown';
+            let passed = 0;
+            let failed = 0;
+            let duration = 0;
+            if (Array.isArray(data)) {
+                passed = data.filter((t) => t.status === 'passed').length;
+                failed = data.filter((t) => t.status === 'failed' || t.status === 'timedOut').length;
+                duration = data.reduce((acc, curr) => acc + (curr.duration || 0), 0);
+                status = failed > 0 ? 'Failed' : (passed > 0 ? 'Passed' : 'No Tests');
+            }
+            else if (data.stats) {
+                passed = data.stats.passed;
+                failed = data.stats.failed;
+                duration = data.stats.duration;
+                status = failed > 0 ? 'Failed' : 'Passed';
+            }
+            const colorFn = status === 'Failed' ? '\x1b[31m' : '\x1b[32m'; // Red or Green
+            const reset = '\x1b[0m';
+            console.log(`Status:   ${colorFn}${status}${reset}`);
+            console.log(`Passed:   ${passed}`);
+            console.log(`Failed:   ${failed}`);
+            console.log(`Duration: ${(duration / 1000).toFixed(2)}s`);
+            if (failed > 0) {
+                console.log(`\n${colorFn}Errors detected! Check report for details.${reset}`);
+            }
+        }
+        catch (e) {
+            console.error('Error parsing report data.');
+        }
+    }
+    else {
+        console.log('Report data not found.');
+    }
+    console.log('');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flash-ai-team/flash-test-framework",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "A powerful keyword-driven automation framework built on top of Playwright and TypeScript.",
   "keywords": [
     "playwright",