feat: add --tests option to test command

README.md

@@ -46,3 +46,27 @@ kopytko <command> --help
 |   start    |  	s   | 	Compiles and runs an application on a Roku device       |
 |    test    |  	t   | 	Compiles and runs unit tests on a Roku device           |
 |    new     |  	n   | 	Creates new kopytko application                         |
+
+## Test command options
+
+| Option | Env var | Description |
+|--------|---------|-------------|
+| `--testFileName=<name>` | `TEST_FILE_NAME` | Run only tests whose file name matches `<name>` |
+| `--tests=<patterns>` | `TESTS` | Semicolon-separated glob patterns of unit names to build and run (e.g. `Home*;Video*;Button`). Filters at build time — only matching test files are compiled and deployed |
+| `--forceConnect` | — | Kill any process occupying port 8085 before connecting to read test results |
+| `--rokuIP=<ip>` | `ROKU_IP` | IP address of the target Roku device |
+| `--rokuDevPassword=<password>` | `ROKU_DEV_PASSWORD` | Developer password for the target Roku device |
+
+```shell
+# Run all tests
+npm test
+
+# Run tests for a single unit (shorthand)
+npm test -- MyService
+
+# Run tests matching glob patterns in a single build+deploy
+npm test -- --tests="Home*;Video*;Button"
+
+# Force-take port 8085 if occupied
+npm test -- --forceConnect
+```

commands/test.js

@@ -1,5 +1,6 @@
 const rokuDevPasswordOption = require('../options/rokuDevPassword');
 const testFileNameOption = require('../options/testFileName');
+const testsOption = require('../options/tests');
 const forceConnectOption = require('../options/forceConnect');
 const forceHttpOption = require('../options/forceHttp');
 const rokuIPOption = require('../options/rokuIP');
@@ -13,6 +14,7 @@ function load(program) {
     .addOption(rokuIPOption)
     .addOption(rokuDevPasswordOption)
     .addOption(testFileNameOption)
+    .addOption(testsOption)
     .addOption(telnetOption)
     .addOption(forceHttpOption)
     .addOption(forceConnectOption)

options/tests.js

@@ -0,0 +1,4 @@
+const { Option } = require('commander');
+
+module.exports = new Option('--tests <string>', 'Semicolon-separated glob patterns of unit test names to run (e.g. Rail*;Video*;Tile*)')
+  .env('TESTS');

package.json

@@ -41,7 +41,7 @@
   },
   "peerDependencies": {
     "@dazn/kopytko-packager": "^1.4.2",
-    "@dazn/kopytko-unit-testing-framework": "^2.5.2"
+    "@dazn/kopytko-unit-testing-framework": "^2.6.0"
   },
   "license": "MIT",
   "repository": {