proby 0.12.0 → 0.13.0

package/README.md

@@ -42,6 +42,64 @@ Run proby from your project root:
 npx proby
 ```
 
+Run a single file:
+```bash
+npx proby math.spec.ts
+```
+
+Run a single group within a file:
+```bash
+npx proby math.spec.ts addition
+```
+
+### Grouping tests
+
+Use `test.group` in your spec files to cluster related cases. Groups can then
+be targeted individually when running proby:
+```js
+// src/math.spec.ts
+import test from "@rcompat/test";
+
+test.group("addition", () => {
+  test.case("integers", assert => {
+    assert(1 + 1).equals(2);
+  });
+});
+
+test.group("multiplication", () => {
+  test.case("integers", assert => {
+    assert(2 * 3).equals(6);
+  });
+});
+```
+```bash
+npx proby math.spec.ts addition  # runs only the addition group
+```
+
+### Grouping tests
+
+Use `test.group` in your spec files to cluster related cases. Groups can then
+be targeted individually when running proby:
+```js
+// src/math.spec.ts
+import test from "@rcompat/test";
+
+test.group("addition", () => {
+  test.case("integers", assert => {
+    assert(1 + 1).equals(2);
+  });
+});
+
+test.group("multiplication", () => {
+  test.case("integers", assert => {
+    assert(2 * 3).equals(6);
+  });
+});
+```
+```bash
+npx proby math.spec.ts addition  # runs only the addition group
+```
+
 ### Writing tests
 
 Create test files with `.spec.ts` or `.spec.js` extension in your `src`
@@ -128,7 +186,8 @@ npm test
 - Files must end with `.spec.ts` or `.spec.js`
 - Files must be in the `src` directory (or `packages/*/src` for monorepos)
 - Use `@rcompat/test` to write tests
-
+- Use `test.group` to organize cases into named groups targetable by proby
+
 ## Examples
 
 ### Basic assertions

package/lib/Schema.d.ts

@@ -0,0 +1,8 @@
+declare const Schema: import("pema").ObjectType<{
+    monorepo: import("pema").DefaultType<import("pema").BooleanType, false>;
+    packages: import("pema").DefaultType<import("pema").StringType, "packages">;
+    include: import("pema").DefaultType<import("pema").ArrayType<import("pema").StringType>, string[]>;
+    conditions: import("pema").DefaultType<import("pema").ArrayType<import("pema").StringType>, string[]>;
+}>;
+export default Schema;
+//# sourceMappingURL=Schema.d.ts.map

package/lib/Schema.js

@@ -0,0 +1,9 @@
+import p from "pema";
+const Schema = p({
+    monorepo: p.boolean.default(false),
+    packages: p.string.default("packages"),
+    include: p.array(p.string).default(["src"]),
+    conditions: p.array(p.string).default(["source"]),
+});
+export default Schema;
+//# sourceMappingURL=Schema.js.map

package/lib/bin.js

@@ -1,37 +1,45 @@
 #!/usr/bin/env node
-import args from "@rcompat/args";
-import color from "@rcompat/cli/color";
-import print from "@rcompat/cli/print";
+import Schema from "#Schema";
+import env from "@rcompat/env";
 import fs from "@rcompat/fs";
-import run from "./run.js";
+import io from "@rcompat/io";
+import is from "@rcompat/is";
+import runtime from "@rcompat/runtime";
 const root = await fs.project.root();
-const spec_json = root.join("spec.json");
-if (await spec_json.exists()) {
-    //  console.log(`spec.json exists, reading`);
+const ts_config_file = root.join("proby.config.ts");
+const js_config_file = root.join("proby.config.js");
+const user_config = await ts_config_file.exists()
+    ? (await ts_config_file.import("default"))
+    : await js_config_file.exists()
+        ? (await js_config_file.import("default"))
+        : {};
+const { include, packages, conditions, monorepo } = Schema.parse(user_config);
+const conditions_flag = conditions.length > 0
+    ? ` --conditions=${conditions.join(",")}`
+    : "";
+const script = runtime.script;
+const args = runtime.args.join(" ");
+if (!is.defined(env.try("PROBY_RELAUNCHED"))) {
+    await io.spawn(`${runtime.bin} ${conditions_flag} ${script} ${args}`, {
+        inherit: true,
+        env: { ...process.env, PROBY_RELAUNCHED: "1" },
+    });
+    runtime.exit(0);
 }
-else {
-    //  console.log(`spec.json missing, continuing with defaults`);
-}
-const [file] = args;
-const type = await (async (base) => {
-    if (await base.join("packages").exists()) {
-        return "monorepo";
-    }
-    if (await base.join("src").exists()) {
-        return "repo";
-    }
-})(root);
-if (type === "monorepo") {
-    for (const repo of await root.join("packages").list({
+import run from "#run";
+const [file, group] = runtime.args;
+if (monorepo) {
+    for (const repo of await root.join(packages).list({
         filter: info => info.kind === "directory",
     })) {
-        await run(repo.join("src"), repo.name, file);
+        for (const dir of include) {
+            await run(repo.join(dir), repo.name, file, group);
+        }
     }
 }
-else if (type === "repo") {
-    await run(root.join("src"), undefined, file);
-}
 else {
-    print(`${color.red("src")} or ${color.red("packages")} not found\n`);
+    for (const dir of include) {
+        await run(root.join(dir), undefined, file, group);
+    }
 }
 //# sourceMappingURL=bin.js.map

package/lib/config.d.ts

@@ -0,0 +1,9 @@
+import type Schema from "#Schema";
+declare const _default: (input: typeof Schema.input) => {
+    monorepo?: boolean | undefined;
+    packages?: string | undefined;
+    include?: string[] | undefined;
+    conditions?: string[] | undefined;
+} | undefined;
+export default _default;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.js

@@ -0,0 +1,2 @@
+export default (input) => input;
+//# sourceMappingURL=config.js.map

package/lib/fixtures/static-mock/math.d.ts

@@ -0,0 +1,2 @@
+export declare function add(a: number, b: number): number;
+//# sourceMappingURL=math.d.ts.map

package/lib/fixtures/static-mock/math.js

@@ -0,0 +1,4 @@
+export function add(a, b) {
+    return a + b;
+}
+//# sourceMappingURL=math.js.map

package/lib/fixtures/static-mock/math.mock.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=math.mock.d.ts.map

package/lib/fixtures/static-mock/math.mock.js

@@ -0,0 +1,5 @@
+import test from "@rcompat/test";
+test.mock("#fixtures/static-mock/math", () => ({
+    add: (a, b) => 99,
+}));
+//# sourceMappingURL=math.mock.js.map

package/lib/run.d.ts

@@ -1,4 +1,4 @@
 import type { FileRef } from "@rcompat/fs";
-declare const _default: (root: FileRef, subrepo?: string, target?: string) => Promise<void>;
+declare const _default: (root: FileRef, subrepo?: string, target?: string, group?: string) => Promise<void>;
 export default _default;
 //# sourceMappingURL=run.d.ts.map

package/lib/run.js

@@ -44,7 +44,8 @@ async function run_in_worker(spec, env) {
     });
     const context = await env_module.setup?.();
     return new Promise((resolve, reject) => {
-        const worker = new Worker(new URL("./worker.js", import.meta.url), {
+        const worker_url = new URL(import.meta.url.endsWith(".ts") ? "./worker.ts" : "./worker.js", import.meta.url);
+        const worker = new Worker(worker_url, {
             workerData: {
                 spec: spec.path,
                 env: env.path,
@@ -72,7 +73,7 @@ async function run_in_worker(spec, env) {
         });
     });
 }
-export default async (root, subrepo, target) => {
+export default async (root, subrepo, target, group) => {
     const files = await root.list({
         recursive: true,
         filter: info => extensions.some(extension => info.path.endsWith(extension)),
@@ -89,33 +90,41 @@ export default async (root, subrepo, target) => {
             await run_in_worker(file, env_file);
             continue;
         }
+        const mock_file = await file.sibling(file.name.replace(/\.spec\.(ts|js)$/, ".mock.$1")).or(() => null);
         repository.suite(file);
-        await file.import();
-    }
-    for (const suite of repository.next()) {
-        const failed = [];
-        for await (const test of suite.run()) {
-            for (const result of test.results) {
-                if (result.passed) {
-                    print(color.green("o"));
+        const suite = repository.next().next().value;
+        try {
+            if (mock_file !== null)
+                await mock_file.import();
+            await file.import();
+            const failed = [];
+            for await (const test of suite.run()) {
+                if (group !== undefined && test.group !== group)
+                    continue;
+                for (const result of test.results) {
+                    if (result.passed) {
+                        print(color.green("o"));
+                    }
+                    else {
+                        failed.push([test, result]);
+                        print(color.red("x"));
+                    }
                 }
-                else {
-                    failed.push([test, result]);
-                    print(color.red("x"));
+            }
+            await suite.end();
+            if (failed.length > 0) {
+                print("\n");
+                for (const [test, result] of failed) {
+                    print(`${suite.file.debase(root)} ${color.red(test.name)} \n`);
+                    print(`  expected  ${stringify(result.expected)}\n`);
+                    print(`  actual    ${stringify(result.actual)}\n`);
                 }
             }
         }
-        await suite.end();
-        if (failed.length > 0) {
-            print("\n");
-            for (const [test, result] of failed) {
-                print(`${suite.file.debase(root)} ${color.red(test.name)} \n`);
-                print(`  expected  ${stringify(result.expected)}\n`);
-                print(`  actual    ${stringify(result.actual)}\n`);
-            }
+        finally {
+            repository.reset();
         }
     }
     print("\n");
-    repository.reset();
 };
 //# sourceMappingURL=run.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proby",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Standard library test runner",
   "bugs": "https://github.com/rcompat/rcompat/issues",
   "license": "MIT",
@@ -16,13 +16,17 @@
     "directory": "packages/proby"
   },
   "dependencies": {
-    "@rcompat/args": "^0.12.0",
-    "@rcompat/cli": "^0.17.0",
-    "@rcompat/fs": "^0.27.1",
-    "@rcompat/assert": "^0.7.0"
+    "pema": "^0.5.0",
+    "@rcompat/assert": "^0.8.0",
+    "@rcompat/cli": "^0.18.0",
+    "@rcompat/env": "^0.17.0",
+    "@rcompat/io": "^0.5.0",
+    "@rcompat/fs": "^0.28.0",
+    "@rcompat/is": "^0.6.0",
+    "@rcompat/runtime": "^0.11.0"
   },
   "peerDependencies": {
-    "@rcompat/test": "^0.11.2"
+    "@rcompat/test": "^0.12.0"
   },
   "peerDependenciesMeta": {
     "@rcompat/test": {
@@ -32,10 +36,16 @@
   "type": "module",
   "imports": {
     "#*": {
-      "apekit": "./src/*.ts",
+      "source": "./src/*.ts",
       "default": "./lib/*.js"
     }
   },
+  "exports": {
+    "./config": {
+      "source": "./src/config.ts",
+      "default": "./lib/config.js"
+    }
+  },
   "scripts": {
     "build": "npm run clean && tsc",
     "clean": "rm -rf ./lib",