tauri-test-cli 0.3.1 → 0.4.0

package/README.md

@@ -8,16 +8,16 @@ CLI for testing Tauri applications with screenshot capture, DOM inspection, and
 # Install globally
 npm install -g tauri-test-cli
 
-# Install tauri-test (required)
-tauri-test setup
+# Install tauri-driver (required)
+tauri-test-cli setup
 
 # Check dependencies
-tauri-test check-deps
+tauri-test-cli check-deps
 
 # Start server and test your app
-tauri-test server --app ./target/debug/my-app &
-tauri-test screenshot --output /tmp/screen.png
-tauri-test click "button.submit"
+tauri-test-cli server --app ./target/debug/my-app &
+tauri-test-cli screenshot --output /tmp/screen.png
+tauri-test-cli click "button.submit"
 ```
 
 ## Installation
@@ -32,7 +32,7 @@ bun install -g tauri-test-cli
 pnpm install -g tauri-test-cli
 
 # Then install tauri-test
-tauri-test setup
+tauri-test-cli setup
 ```
 
 ### Using Pixi (Recommended for Development)
@@ -57,7 +57,7 @@ pixi run dev server --app ./target/debug/my-app
 The CLI will check for missing dependencies and provide install instructions:
 
 ```bash
-tauri-test check-deps
+tauri-test-cli check-deps
 ```
 
 <details>
@@ -73,23 +73,23 @@ sudo pacman -S webkit2gtk-4.1              # Arch
 
 # Rust and tauri-test
 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
-tauri-test setup
+tauri-test-cli setup
 ```
 
 #### macOS
 
-WebKit is included in macOS. Just install tauri-test:
+WebKit is included in macOS. Just install tauri-driver:
 
 ```bash
-tauri-test setup
+tauri-test-cli setup
 ```
 
 #### Windows
 
-WebView2 is included in Windows 10/11. Just install tauri-test:
+WebView2 is included in Windows 10/11. Just install tauri-driver:
 
 ```bash
-tauri-test setup
+tauri-test-cli setup
 ```
 
 </details>
@@ -102,7 +102,7 @@ Start a persistent HTTP server - send commands anytime via HTTP.
 
 ```bash
 # Start server
-tauri-test server --app ./target/debug/my-app &
+tauri-test-cli server --app ./target/debug/my-app &
 
 # Send commands
 curl -s http://127.0.0.1:9222 -d '{"cmd":"click","selector":"button"}'
@@ -113,7 +113,7 @@ curl -s http://127.0.0.1:9222 -d '{"cmd":"snapshot"}'
 curl -s http://127.0.0.1:9222/status
 
 # Stop server
-tauri-test stop
+tauri-test-cli stop
 ```
 
 #### Virtual Display Mode (Linux)
@@ -122,11 +122,11 @@ Run in a virtual display to avoid focus-related throttling:
 
 ```bash
 # Using built-in --xvfb flag (recommended)
-tauri-test server --app ./target/debug/my-app --xvfb &
+tauri-test-cli server --app ./target/debug/my-app --xvfb &
 
 # Or manually with Xvfb
 Xvfb :99 -screen 0 1920x1080x24 &
-DISPLAY=:99 tauri-test server --app ./target/debug/my-app &
+DISPLAY=:99 tauri-test-cli server --app ./target/debug/my-app &
 ```
 
 ### Client Mode (CLI without --app)
@@ -135,27 +135,27 @@ Once the server is running, you can use CLI commands directly - no `--app` neede
 
 ```bash
 # Start server once
-tauri-test server --app ./target/debug/my-app &
+tauri-test-cli server --app ./target/debug/my-app &
 
 # Run commands - they automatically connect to the server!
-tauri-test click "button.submit"
-tauri-test type "input[name=email]" "user@example.com"
-tauri-test screenshot --output /tmp/screen.png
-tauri-test snapshot --output /tmp/dom.yaml
-tauri-test eval "document.title"
-tauri-test wait ".modal" --gone --timeout 5000
+tauri-test-cli click "button.submit"
+tauri-test-cli type "input[name=email]" "user@example.com"
+tauri-test-cli screenshot --output /tmp/screen.png
+tauri-test-cli snapshot --output /tmp/dom.yaml
+tauri-test-cli eval "document.title"
+tauri-test-cli wait ".modal" --gone --timeout 5000
 
 # Check server status
-tauri-test status
+tauri-test-cli status
 
 # Stop when done
-tauri-test stop
+tauri-test-cli stop
 ```
 
 Use `--port` to connect to a different server:
 
 ```bash
-tauri-test click "button" --port 8080
+tauri-test-cli click "button" --port 8080
 ```
 
 ### Why Server Mode?
@@ -181,11 +181,11 @@ tauri-test click "button" --port 8080
 
 | Command | Description |
 |---------|-------------|
-| `tauri-test setup` | Install tauri-test via cargo |
-| `tauri-test status [--port]` | Check if a server is running |
-| `tauri-test stop [--port]` | Stop a running server |
-| `tauri-test cleanup` | Kill stale WebDriver processes |
-| `tauri-test check-deps` | Check system dependencies |
+| `tauri-test-cli setup` | Install tauri-driver via cargo |
+| `tauri-test-cli status [--port]` | Check if a server is running |
+| `tauri-test-cli stop [--port]` | Stop a running server |
+| `tauri-test-cli cleanup` | Kill stale WebDriver processes |
+| `tauri-test-cli check-deps` | Check system dependencies |
 
 ### Examples
 
@@ -193,22 +193,22 @@ tauri-test click "button" --port 8080
 
 ```bash
 # Click a button
-tauri-test click "button.submit"
+tauri-test-cli click "button.submit"
 
 # Type into an input
-tauri-test type "input[name=email]" "user@example.com"
+tauri-test-cli type "input[name=email]" "user@example.com"
 
 # Take screenshot
-tauri-test screenshot --output /tmp/screen.png
+tauri-test-cli screenshot --output /tmp/screen.png
 
 # Get DOM snapshot (accessibility tree in YAML format)
-tauri-test snapshot --output /tmp/dom.yaml
+tauri-test-cli snapshot --output /tmp/dom.yaml
 
 # Execute JavaScript
-tauri-test eval "document.title"
+tauri-test-cli eval "document.title"
 
 # Wait for element to disappear
-tauri-test wait ".modal" --gone --timeout 5000
+tauri-test-cli wait ".modal" --gone --timeout 5000
 ```
 
 **Using curl:**
@@ -241,7 +241,7 @@ For single-invocation workflows with multiple commands:
 echo '[
   {"cmd":"click","selector":"button"},
   {"cmd":"screenshot","output":"/tmp/result.png"}
-]' | tauri-test batch --app ./target/debug/my-app --json
+]' | tauri-test-cli batch --app ./target/debug/my-app --json
 ```
 
 ## Single Commands
@@ -249,9 +249,9 @@ echo '[
 Each command starts a fresh session (slower but simpler):
 
 ```bash
-tauri-test screenshot --app ./target/debug/my-app --output /tmp/screen.png
-tauri-test click "button#submit" --app ./target/debug/my-app
-tauri-test snapshot --app ./target/debug/my-app
+tauri-test-cli screenshot --app ./target/debug/my-app --output /tmp/screen.png
+tauri-test-cli click "button#submit" --app ./target/debug/my-app
+tauri-test-cli snapshot --app ./target/debug/my-app
 ```
 
 ## Using with Claude Code
@@ -261,24 +261,24 @@ This CLI is designed for AI agents. Add this to your project's CLAUDE.md:
 ```markdown
 ## Testing Tauri Apps
 
-Use `tauri-test` CLI for testing the Tauri application.
+Use `tauri-test-cli` for testing the Tauri application.
 
 ### Start test server
-tauri-test server --app ./target/debug/my-app --xvfb &
+tauri-test-cli server --app ./target/debug/my-app --xvfb &
 
 ### Available commands (once server is running, no --app needed)
-- Click: `tauri-test click "button"`
-- Type: `tauri-test type "input" "hello"`
-- Screenshot: `tauri-test screenshot --output /tmp/screen.png`
-- Snapshot: `tauri-test snapshot --output /tmp/dom.yaml`
-- Eval: `tauri-test eval "document.title"`
-- Wait: `tauri-test wait ".element" --timeout 5000`
+- Click: `tauri-test-cli click "button"`
+- Type: `tauri-test-cli type "input" "hello"`
+- Screenshot: `tauri-test-cli screenshot --output /tmp/screen.png`
+- Snapshot: `tauri-test-cli snapshot --output /tmp/dom.yaml`
+- Eval: `tauri-test-cli eval "document.title"`
+- Wait: `tauri-test-cli wait ".element" --timeout 5000`
 
 ### Check server status
-tauri-test status
+tauri-test-cli status
 
 ### Stop server
-tauri-test stop
+tauri-test-cli stop
 ```
 
 ## Development
@@ -334,7 +334,7 @@ pixi run test-app-build
 # Run the test app manually
 pixi run test-app-run
 
-# Start tauri-test server with test app
+# Start tauri-test-cli server with test app
 pixi run test-server
 ```
 
@@ -414,21 +414,21 @@ Example output:
 ### "Maximum number of active sessions" Error
 
 ```bash
-tauri-test cleanup
+tauri-test-cli cleanup
 ```
 
 ### Server won't start
 
 ```bash
-tauri-test stop
-tauri-test cleanup
+tauri-test-cli stop
+tauri-test-cli cleanup
 ```
 
 ### Missing dependencies
 
 ```bash
-tauri-test check-deps
-tauri-test setup  # Install tauri-test
+tauri-test-cli check-deps
+tauri-test-cli setup  # Install tauri-test
 ```
 
 ### Window focus issues (slow commands)
@@ -436,16 +436,16 @@ tauri-test setup  # Install tauri-test
 Use the `--xvfb` flag to run in a virtual display:
 
 ```bash
-tauri-test server --app ./target/debug/my-app --xvfb &
+tauri-test-cli server --app ./target/debug/my-app --xvfb &
 ```
 
 ## CLI Reference
 
 ```
-tauri-test - CLI for testing Tauri applications
+tauri-test-cli - CLI for testing Tauri applications
 
 USAGE:
-  tauri-test <command> [options]
+  tauri-test-cli <command> [options]
 
   When --app is omitted, commands connect to a running server (client mode).
 
@@ -461,7 +461,7 @@ COMMANDS:
   status [--port <port>]            Check if a server is running
   stop [--port <port>]              Stop a running server
   cleanup                           Kill stale WebDriver processes
-  setup                             Install tauri-test via cargo
+  setup                             Install tauri-driver via cargo
   check-deps                        Check system dependencies
 
 OPTIONS:

package/dist/cli.js

@@ -120740,7 +120740,7 @@ async function disconnect2() {
 }
 function requireBrowser() {
   if (!browser2) {
-    throw new Error("Not connected. Run 'tauri-test connect' first.");
+    throw new Error("Not connected. Run 'tauri-test-cli connect' first.");
   }
   return browser2;
 }
@@ -122048,7 +122048,7 @@ async function sendToServer(port, cmd) {
     return await response.json();
   } catch (err) {
     if (err instanceof TypeError && (err.message.includes("fetch") || err.message.includes("ECONNREFUSED"))) {
-      throw new Error(`No server running on port ${port}. Start one with: tauri-test server --app <path> --port ${port}`);
+      throw new Error(`No server running on port ${port}. Start one with: tauri-test-cli server --app <path> --port ${port}`);
     }
     throw err;
   }
@@ -122065,10 +122065,10 @@ async function isServerRunning(port) {
   }
 }
 var HELP = `
-tauri-test - CLI for testing Tauri applications
+tauri-test-cli - CLI for testing Tauri applications
 
 USAGE:
-  tauri-test <command> --app <path-to-tauri-binary> [options]
+  tauri-test-cli <command> --app <path-to-tauri-binary> [options]
 
 COMMANDS:
   server [--port <port>] [--xvfb]
@@ -122098,16 +122098,16 @@ COMMANDS:
       Execute multiple commands in a single session (reads JSON from stdin)
 
   stop [--port <port>]
-      Stop a running tauri-test server
+      Stop a running tauri-test-cli server
 
   status [--port <port>]
       Check if a server is running
 
   cleanup
-      Kill stale WebDriver processes (tauri-test, WebKitWebDriver, Xvfb)
+      Kill stale WebDriver processes (tauri-driver, WebKitWebDriver, Xvfb)
 
   setup
-      Install tauri-test via cargo
+      Install tauri-driver via cargo
 
   check-deps
       Check if all required system dependencies are installed
@@ -122129,25 +122129,25 @@ CLIENT MODE (talk to running server):
   This is the simplest way to interact with your app!
 
   # 1. Start server once (in background)
-  tauri-test server --app /path/to/your/tauri-app &
+  tauri-test-cli server --app /path/to/your/tauri-app &
 
   # 2. Run CLI commands - no --app needed!
-  tauri-test click "button.submit"
-  tauri-test type "input[name=email]" "user@example.com"
-  tauri-test screenshot --output /tmp/screen.png
-  tauri-test snapshot --output /tmp/dom.yaml
-  tauri-test eval "document.title"
-  tauri-test wait ".modal" --gone --timeout 5000
+  tauri-test-cli click "button.submit"
+  tauri-test-cli type "input[name=email]" "user@example.com"
+  tauri-test-cli screenshot --output /tmp/screen.png
+  tauri-test-cli snapshot --output /tmp/dom.yaml
+  tauri-test-cli eval "document.title"
+  tauri-test-cli wait ".modal" --gone --timeout 5000
 
   # Use --port to connect to a different server
-  tauri-test click "button" --port 8080
+  tauri-test-cli click "button" --port 8080
 
 SERVER MODE (Recommended for Agents):
   Start a persistent HTTP server - no batching needed!
   Commands execute instantly (no auto-wait by default for speed).
 
   # 1. Start server (runs in foreground, use & for background)
-  tauri-test server --app /path/to/your/tauri-app --port 9222 &
+  tauri-test-cli server --app /path/to/your/tauri-app --port 9222 &
 
   # 2. Send commands anytime via curl - executes instantly!
   curl -s http://127.0.0.1:9222 -d '{"cmd":"click","selector":"button"}'
@@ -122171,28 +122171,28 @@ AUTO-WAIT BEHAVIOR (batch mode only by default):
 
 EXAMPLES:
   # First-time setup
-  tauri-test setup                    # Install tauri-test via cargo
-  tauri-test check-deps               # Verify all dependencies
+  tauri-test-cli setup                # Install tauri-driver via cargo
+  tauri-test-cli check-deps           # Verify all dependencies
 
   # Server mode (best for agents)
-  tauri-test server --app ./target/debug/my-tauri-app &
+  tauri-test-cli server --app ./target/debug/my-tauri-app &
   curl -s http://127.0.0.1:9222 -d '{"cmd":"click","selector":"button"}'
   curl -s http://127.0.0.1:9222 -d '{"cmd":"screenshot","output":"/tmp/result.png"}'
 
   # Server in virtual display (Linux - avoids focus/throttling issues)
-  tauri-test server --app ./target/debug/my-tauri-app --xvfb &
+  tauri-test-cli server --app ./target/debug/my-tauri-app --xvfb &
 
   # Stop server and cleanup
-  tauri-test stop                     # Stop server on default port
-  tauri-test stop --port 8080         # Stop server on custom port
-  tauri-test cleanup                  # Kill stale WebDriver processes
+  tauri-test-cli stop                 # Stop server on default port
+  tauri-test-cli stop --port 8080     # Stop server on custom port
+  tauri-test-cli cleanup              # Kill stale WebDriver processes
 
   # Batch mode (single invocation)
-  echo '[{"cmd":"click","selector":"button"},{"cmd":"screenshot","output":"/tmp/result.png"}]' | tauri-test batch --app ./target/debug/my-tauri-app --json
+  echo '[{"cmd":"click","selector":"button"},{"cmd":"screenshot","output":"/tmp/result.png"}]' | tauri-test-cli batch --app ./target/debug/my-tauri-app --json
 
   # Single commands
-  tauri-test screenshot --app ./target/debug/my-tauri-app --output /tmp/screen.png
-  tauri-test click "button#submit" --app ./target/debug/my-tauri-app
+  tauri-test-cli screenshot --app ./target/debug/my-tauri-app --output /tmp/screen.png
+  tauri-test-cli click "button#submit" --app ./target/debug/my-tauri-app
 `;
 function parseArgs(argv) {
   const args = [];
@@ -122351,10 +122351,10 @@ async function main() {
         console.error(`Error: No server running on port ${port}.`);
         console.error("");
         console.error("Either start a server first:");
-        console.error(`  tauri-test server --app ./target/debug/my-app --port ${port} &`);
+        console.error(`  tauri-test-cli server --app ./target/debug/my-app --port ${port} &`);
         console.error("");
         console.error("Or specify --app to run standalone:");
-        console.error(`  tauri-test ${command} --app ./target/debug/my-app`);
+        console.error(`  tauri-test-cli ${command} --app ./target/debug/my-app`);
         process.exit(1);
       }
       let cmd;
@@ -122446,8 +122446,8 @@ async function main() {
     console.error("Error: --app <path> is required. Specify the path to your Tauri app binary.");
     console.error("");
     console.error("Example:");
-    console.error("  tauri-test server --app ./target/debug/my-app");
-    console.error("  tauri-test screenshot --app ./target/debug/my-app --output /tmp/screen.png");
+    console.error("  tauri-test-cli server --app ./target/debug/my-app");
+    console.error("  tauri-test-cli screenshot --app ./target/debug/my-app --output /tmp/screen.png");
     process.exit(1);
   }
   const waitTimeout = options.wait ? parseInt(options.wait) : 15000;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "tauri-test-cli",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "CLI for testing Tauri applications with screenshot capture, DOM inspection, and user interaction simulation",
   "type": "module",
   "bin": {
-    "tauri-test": "./dist/cli.js"
+    "tauri-test-cli": "./dist/cli.js"
   },
   "files": [
     "dist",

package/scripts/postinstall.js

@@ -61,10 +61,10 @@ if (warnings.length > 0) {
     console.log();
   }
 
-  console.log(`${dim}Run 'tauri-test --help' for usage information.${reset}`);
+  console.log(`${dim}Run 'tauri-test-cli --help' for usage information.${reset}`);
 } else {
   console.log(`${green}All dependencies found!${reset}`);
-  console.log(`${dim}Run 'tauri-test --help' to get started.${reset}`);
+  console.log(`${dim}Run 'tauri-test-cli --help' to get started.${reset}`);
 }
 
 console.log();

package/scripts/postinstall.test.ts

@@ -49,7 +49,7 @@ describe("postinstall script", () => {
     });
 
     const output = result.stdout.toString();
-    expect(output).toContain("tauri-test");
+    expect(output).toContain("tauri-test-cli");
   });
 });