[Unified Recorder] Updates the dev-tool commands to follow the new syntax

common/tools/dev-tool/README.md

@@ -22,6 +22,41 @@ It provides a place to centralize scripts, resources, and processes for developm
   - `prep` (prepare samples for local source-linked execution)
   - `run` (execute a sample or all samples within a directory)
   - `check-node-versions` (execute samples with different node versions, typically in preparation for release)
+- `test-proxy`
+  - `start` (start the test-proxy tool. This requires docker.)
+  - `wait-for-proxy-endpoint` (waits until the proxy endpoint is ready or aborts in 120 seconds, whichever happens first)
+- `run`
+
+  - `test:node-ts-input` (runs the node tests with TS input files with the default mocha configs, and concurrently runs the proxy tool in record/playback modes if it is not already active)
+
+    - Mocha settings added by default
+
+      > `-r esm -r ts-node/register --reporter ../../../common/tools/mocha-multi-reporter.js --full-trace`
+
+    - Example usage
+
+      ```bash
+      dev-tool run test:node-ts-input -- --timeout 1200000 'test/*.spec.ts'
+      ```
+  - `test:node-js-input` (runs the node tests with JS input files with the default mocha configs, and concurrently runs the proxy tool in record/playback modes if it is not already active)
+
+    - Mocha settings added by default
+
+      > `-r esm --require source-map-support/register --reporter ../../../common/tools/mocha-multi-reporter.js --full-trace`
+
+    - Also, calls mocha with `nyc` for code coverage
+
+    - Example usage
+
+      ```bash
+      dev-tool run test:node-js-input -- --timeout 5000000 "dist-esm/test/{,!(browser)/**/}/*.spec.js"
+      ```
+
+  - `test:browser` (runs the browser tests using karma, and concurrently runs the proxy tool in record/playback modes if it is not already active)
+    - Example usage
+      ```bash
+      dev-tool run test:browser
+      ```
 
 The `dev-tool about` command will print some information about how to use the command. All commands additionally accept the `--help` argument, which will print information about the usage of that specific command. For example, to show help information for the `resolve` command above, issue the command `dev-tool package resolve --help`.
 

common/tools/dev-tool/src/commands/run/testBrowser.ts

@@ -2,23 +2,17 @@
 // Licensed under the MIT license
 
 import { leafCommand, makeCommandInfo } from "../../framework/command";
-import { runTestsWithProxyTool } from "../../util/testUtils";
+import { concatArguments, runTestsWithProxyTool } from "../../util/testUtils";
 
 export const commandInfo = makeCommandInfo(
   "test:browser",
-  "runs the browser tests using karma with the default and the provided options; starts the proxy-tool in record and playback modes",
-  {
-    karma: {
-      kind: "string",
-      description: "Karma options (such as --single-run)",
-      default: "--single-run"
-    }
-  }
+  "runs the browser tests using karma with the default and the provided options; starts the proxy-tool in record and playback modes"
 );
 
 export default leafCommand(commandInfo, async (options) => {
+  const karmaArgs = options["--"]?.length ? concatArguments(options["--"]) : "--single-run";
   return runTestsWithProxyTool({
-    command: `karma start ${options.karma}`,
+    command: `karma start ${karmaArgs}`,
     name: "browser-tests"
   });
 });

common/tools/dev-tool/src/commands/run/testNodeJSInput.ts

@@ -2,24 +2,21 @@
 // Licensed under the MIT license
 
 import { leafCommand, makeCommandInfo } from "../../framework/command";
-import { runTestsWithProxyTool } from "../../util/testUtils";
+import { concatArguments, runTestsWithProxyTool } from "../../util/testUtils";
 
 export const commandInfo = makeCommandInfo(
   "test:node-js-input",
-  "runs the node tests using mocha with the default and the provided options; starts the proxy-tool in record and playback modes",
-  {
-    mocha: {
-      kind: "string",
-      description:
-        "Mocha options along with the bundled test file(JS) with rollup as expected by mocha",
-      default: '--timeout 5000000 "dist-esm/test/{,!(browser)/**/}/*.spec.js"'
-    }
-  }
+  "runs the node tests using mocha with the default and the provided options; starts the proxy-tool in record and playback modes"
 );
 
 export default leafCommand(commandInfo, async (options) => {
+  const defaultMochaArgs =
+    "-r esm --require source-map-support/register --reporter ../../../common/tools/mocha-multi-reporter.js --full-trace";
+  const mochaArgs = options["--"]?.length
+    ? concatArguments(options["--"])
+    : '--timeout 5000000 "dist-esm/test/{,!(browser)/**/}/*.spec.js"';
   return runTestsWithProxyTool({
-    command: `nyc mocha -r esm --require source-map-support/register --reporter ../../../common/tools/mocha-multi-reporter.js --full-trace ${options.mocha}`,
+    command: `nyc mocha ${defaultMochaArgs} ${mochaArgs}`,
     name: "node-tests"
   });
 });

common/tools/dev-tool/src/commands/run/testNodeTSInput.ts

@@ -2,24 +2,21 @@
 // Licensed under the MIT license
 
 import { leafCommand, makeCommandInfo } from "../../framework/command";
-import { runTestsWithProxyTool } from "../../util/testUtils";
+import { concatArguments, runTestsWithProxyTool } from "../../util/testUtils";
 
 export const commandInfo = makeCommandInfo(
   "test:node-ts-input",
-  "runs the node tests using mocha with the default and the provided options; starts the proxy-tool in record and playback modes",
-  {
-    mocha: {
-      kind: "string",
-      description:
-        "Mocha options along with the test files(glob pattern) in TS as expected by mocha",
-      default: '--timeout 1200000 --exclude "test/**/browser/*.spec.ts" "test/**/*.spec.ts"'
-    }
-  }
+  "runs the node tests using mocha with the default and the provided options; starts the proxy-tool in record and playback modes"
 );
 
 export default leafCommand(commandInfo, async (options) => {
+  const defaultMochaArgs =
+    "-r esm -r ts-node/register --reporter ../../../common/tools/mocha-multi-reporter.js --full-trace";
+  const mochaArgs = options["--"]?.length
+    ? concatArguments(options["--"])
+    : '--timeout 1200000 --exclude "test/**/browser/*.spec.ts" "test/**/*.spec.ts"';
   return runTestsWithProxyTool({
-    command: `mocha -r esm -r ts-node/register --reporter ../../../common/tools/mocha-multi-reporter.js --full-trace ${options.mocha}`,
+    command: `mocha ${defaultMochaArgs} ${mochaArgs}`,
     name: "node-tests"
   });
 });

common/tools/dev-tool/src/util/testUtils.ts

@@ -22,7 +22,9 @@ async function shouldRunProxyTool(): Promise<boolean> {
   }
 }
 
-export async function runTestsWithProxyTool(testCommandObj: concurrently.CommandObj): Promise<boolean> {
+export async function runTestsWithProxyTool(
+  testCommandObj: concurrently.CommandObj
+): Promise<boolean> {
   if (
     await shouldRunProxyTool() // Boolean to figure out if we need to run just the mocha command or the test-proxy too
   ) {
@@ -46,3 +48,8 @@ export async function runTestsWithProxyTool(testCommandObj: concurrently.Command
   }
   return true;
 }
+
+export function concatArguments(args?: string[]): string | undefined {
+  // ["a", "b", "c"] => "a b c"
+  return args?.reduce((final, currentArg) => (final += " " + currentArg));
+}

sdk/test-utils/recorder-new/package.json

@@ -24,7 +24,7 @@
     "format": "prettier --write --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.ts\" \"test/**/*.ts\" \"*.{js,json}\"",
     "integration-test:browser": "concurrently \"npm run tests:server\" \"npm run test:browser-with-proxy\" --kill-others --success first",
     "integration-test:node": "concurrently \"npm run tests:server\" \"npm run test:node-with-proxy\" --kill-others --success first",
-    "test:node-with-proxy": "dev-tool run test:node-ts-input --mocha=\"--timeout 1200000 'test/*.spec.ts'\"",
+    "test:node-with-proxy": "dev-tool run test:node-ts-input -- --timeout 1200000 \"test/*.spec.ts\"",
     "test:browser-with-proxy": "dev-tool run test:browser",
     "integration-test": "npm run integration-test:node && npm run integration-test:browser",
     "tests:server": "cross-env TS_NODE_COMPILER_OPTIONS=\"{\\\"module\\\": \\\"commonjs\\\"}\" ts-node test/utils/server.ts",

sdk/test-utils/testing-recorder-new/package.json

@@ -18,7 +18,7 @@
     "extract-api": "echo skipped",
     "format": "prettier --write --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.ts\" \"test/**/*.ts\" \"*.{js,json}\"",
     "integration-test:browser": "dev-tool run test:browser",
-    "integration-test:node": "dev-tool run test:node-ts-input --mocha=\"--timeout 1200000 'test/*.spec.ts'\"",
+    "integration-test:node": "dev-tool run test:node-ts-input -- --timeout 1200000 \"test/*.spec.ts\"",
     "integration-test": "npm run integration-test:node && npm run integration-test:browser",
     "lint:fix": "eslint --no-eslintrc -c ../../.eslintrc.internal.json package.json src test --ext .ts --fix --fix-type [problem,suggestion]",
     "lint": "eslint --no-eslintrc -c ../../.eslintrc.internal.json package.json src test --ext .ts",