bingo-stratum-testers 0.3.0

package/LICENSE.md

@@ -0,0 +1,20 @@
+# MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+<h1 align="center">bingo-stratum-testers</h1>
+
+<p align="center">Test utilities for Stratum Blocks and Presets. 🧑‍🔧</p>
+
+<p align="center">
+	<a href="https://github.com/JoshuaKGoldberg/bingo/blob/main/.github/CODE_OF_CONDUCT.md" target="_blank"><img alt="🤝 Code of Conduct: Kept" src="https://img.shields.io/badge/%F0%9F%A4%9D_code_of_conduct-kept-21bb42" /></a>
+	<a href="https://codecov.io/gh/JoshuaKGoldberg/bingo" target="_blank"><img alt="🧪 Coverage" src="https://img.shields.io/codecov/c/github/JoshuaKGoldberg/bingo?label=%F0%9F%A7%AA%20coverage" /></a>
+	<a href="https://github.com/JoshuaKGoldberg/bingo/blob/main/LICENSE.md" target="_blank"><img alt="📝 License: MIT" src="https://img.shields.io/badge/%F0%9F%93%9D_license-MIT-21bb42.svg"></a>
+	<a href="http://npmjs.com/package/bingo-stratum-testers"><img alt="📦 npm version" src="https://img.shields.io/npm/v/bingo-stratum-testers?color=21bb42&label=%F0%9F%93%A6%20npm" /></a>
+	<img alt="💪 TypeScript: Strict" src="https://img.shields.io/badge/%F0%9F%92%AA_typescript-strict-21bb42.svg" />
+</p>
+
+See **[create.bingo > Templating Engines > Stratum Packages > bingo-stratum-testers](https://create.bingo/build/packages/bingo-stratum-testers)** for documentation.

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { testBase } from "./testBase.js";
+export { testBlock } from "./testBlock.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/index.js

@@ -0,0 +1,3 @@
+export { testBase } from "./testBase.js";
+export { testBlock } from "./testBlock.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/testBase.d.ts

@@ -0,0 +1,8 @@
+import { AnyShape, InferredObject, TakeInput } from "bingo";
+import { Base } from "bingo-stratum";
+export interface BaseContextSettings<OptionsShape extends AnyShape> {
+    options?: InferredObject<OptionsShape>;
+    take?: TakeInput;
+}
+export declare function testBase<OptionsShape extends AnyShape>(base: Base<OptionsShape>, settings?: Partial<BaseContextSettings<OptionsShape>>): Promise<InferredObject<OptionsShape> | import("bingo").AwaitedLazyProperties<import("bingo").LazyOptionalOptions<Partial<InferredObject<OptionsShape>>>> | undefined>;
+//# sourceMappingURL=testBase.d.ts.map

package/lib/testBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testBase.d.ts","sourceRoot":"","sources":["../src/testBase.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,QAAQ,EAER,cAAc,EACd,SAAS,EACT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAIrC,MAAM,WAAW,mBAAmB,CAAC,YAAY,SAAS,QAAQ;IACjE,OAAO,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,wBAAsB,QAAQ,CAAC,YAAY,SAAS,QAAQ,EAC3D,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,EACxB,QAAQ,GAAE,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAM,yKAgBzD"}

package/lib/testBase.js

@@ -0,0 +1,13 @@
+import { awaitLazyProperties, } from "bingo";
+import { createFailingFunction, createFailingObject } from "./utils.js";
+export async function testBase(base, settings = {}) {
+    if (!base.prepare) {
+        return settings.options;
+    }
+    return await awaitLazyProperties(base.prepare({
+        options: createFailingObject("options", "the Base"),
+        take: createFailingFunction("take", "the Base"),
+        ...settings,
+    }));
+}
+//# sourceMappingURL=testBase.js.map

package/lib/testBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testBase.js","sourceRoot":"","sources":["../src/testBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,mBAAmB,GAGnB,MAAM,OAAO,CAAC;AAGf,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOxE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,IAAwB,EACxB,WAAuD,EAAE;IAEzD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC,OAAO,CAAC;IACzB,CAAC;IAED,OAAO,MAAM,mBAAmB,CAC/B,IAAI,CAAC,OAAO,CAAC;QACZ,OAAO,EAAE,mBAAmB,CAC3B,SAAS,EACT,UAAU,CACsB;QACjC,IAAI,EAAE,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC;QAC/C,GAAG,QAAQ;KACX,CAAC,CACF,CAAC;AACH,CAAC"}

package/lib/testBase.test.d.ts

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

package/lib/testBase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testBase.test.d.ts","sourceRoot":"","sources":["../src/testBase.test.ts"],"names":[],"mappings":""}

package/lib/testBase.test.js

@@ -0,0 +1,91 @@
+import { createInput } from "bingo";
+import { createBase } from "bingo-stratum";
+import { describe, expect, it, vi } from "vitest";
+import { z } from "zod";
+import { testBase } from "./testBase.js";
+const baseWithNoProduce = createBase({
+    options: {
+        value: z.string(),
+    },
+});
+const baseWithValueHardcoded = createBase({
+    options: {
+        value: z.string(),
+    },
+    prepare() {
+        return {
+            value: "hardcoded",
+        };
+    },
+});
+describe("testBase", () => {
+    it("doesn't throw an error when the Base has no produce and settings isn't provided", async () => {
+        const actual = await testBase(baseWithNoProduce);
+        expect(actual).toEqual(undefined);
+    });
+    it("doesn't throw an error when the Base has no produce and settings is {}", async () => {
+        const actual = await testBase(baseWithNoProduce, {});
+        expect(actual).toEqual(undefined);
+    });
+    it("doesn't throw an error when the Base has a produce that does not use settings and settings isn't provided", async () => {
+        const actual = await testBase(baseWithValueHardcoded);
+        expect(actual).toEqual({ value: "hardcoded" });
+    });
+    it("doesn't throw an error when the Base has a produce that does not use settings and settings is {}", async () => {
+        const actual = await testBase(baseWithValueHardcoded, {});
+        expect(actual).toEqual({ value: "hardcoded" });
+    });
+    describe("options", () => {
+        const baseWithValueFromOptions = createBase({
+            options: {
+                value: z.string(),
+            },
+            prepare({ options }) {
+                return {
+                    value: options.value ?? "default",
+                };
+            },
+        });
+        it("returns the options directly when the Base has no produce", async () => {
+            const actual = await testBase(baseWithNoProduce, {
+                options: { value: "direct" },
+            });
+            expect(actual).toEqual({ value: "direct" });
+        });
+        it("throws an error when the Base produce uses options and settings does not contain options", async () => {
+            await expect(async () => await testBase(baseWithValueFromOptions, {})).rejects.toMatchInlineSnapshot(`[Error: Context property 'options' was used by the Base but not provided.]`);
+        });
+        it("uses options when the Base produce uses options and settings contains options", async () => {
+            const actual = await testBase(baseWithValueFromOptions, {
+                options: { value: "override" },
+            });
+            expect(actual).toEqual({ value: "override" });
+        });
+    });
+    describe("take", () => {
+        const constant = "abc123";
+        const inputConstant = createInput({
+            produce: () => constant,
+        });
+        const baseWithValueFromInput = createBase({
+            options: {
+                value: z.string(),
+            },
+            prepare({ take }) {
+                return {
+                    value: () => take(inputConstant),
+                };
+            },
+        });
+        it("throws an error when the Base produce uses take and settings does not include take", async () => {
+            await expect(async () => testBase(baseWithValueFromInput, { options: { value: "unused" } })).rejects.toMatchInlineSnapshot(`[Error: Context property 'take' was used by the Base but not provided.]`);
+        });
+        it("uses the provide take when the Base produce uses take and settings includes take", async () => {
+            const take = vi.fn().mockReturnValueOnce("taken");
+            const actual = await testBase(baseWithValueFromInput, { take });
+            expect(actual).toEqual({ value: "taken" });
+            expect(take).toHaveBeenCalledWith(inputConstant);
+        });
+    });
+});
+//# sourceMappingURL=testBase.test.js.map

package/lib/testBase.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testBase.test.js","sourceRoot":"","sources":["../src/testBase.test.ts"],"names":[],"mappings":"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"}

package/lib/testBlock.d.ts

@@ -0,0 +1,13 @@
+import { ProductionMode } from "bingo";
+import { BlockWithAddons, BlockWithoutAddons } from "bingo-stratum";
+import { BlockCreation } from "bingo-stratum/lib/types/creations.js";
+export interface BlockContextSettingsWithOptionalAddons<Addons extends object, Options extends object> extends BlockContextSettingsWithoutAddons<Options> {
+    addons?: Partial<Addons>;
+}
+export interface BlockContextSettingsWithoutAddons<Options extends object> {
+    mode?: ProductionMode;
+    options?: Options;
+}
+export declare function testBlock<Addons extends object, Options extends object>(block: BlockWithAddons<Addons, Options>, settings: BlockContextSettingsWithOptionalAddons<Addons, Options>): Partial<BlockCreation<Options>>;
+export declare function testBlock<Options extends object>(block: BlockWithoutAddons<Options>, settings?: BlockContextSettingsWithoutAddons<Options>): Partial<BlockCreation<Options>>;
+//# sourceMappingURL=testBlock.d.ts.map

package/lib/testBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testBlock.d.ts","sourceRoot":"","sources":["../src/testBlock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EACN,eAAe,EACf,kBAAkB,EAGlB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAIrE,MAAM,WAAW,sCAAsC,CACtD,MAAM,SAAS,MAAM,EACrB,OAAO,SAAS,MAAM,CACrB,SAAQ,iCAAiC,CAAC,OAAO,CAAC;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,iCAAiC,CAAC,OAAO,SAAS,MAAM;IACxE,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,EACtE,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,EAAE,sCAAsC,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/D,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AACnC,wBAAgB,SAAS,CAAC,OAAO,SAAS,MAAM,EAC/C,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAClC,QAAQ,CAAC,EAAE,iCAAiC,CAAC,OAAO,CAAC,GACnD,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC"}

package/lib/testBlock.js

@@ -0,0 +1,10 @@
+import { produceBlock, } from "bingo-stratum";
+import { createFailingObject } from "./utils.js";
+export function testBlock(block, settings = {}) {
+    return produceBlock(block, {
+        addons: {},
+        options: createFailingObject("options", "the Block"),
+        ...settings,
+    });
+}
+//# sourceMappingURL=testBlock.js.map

package/lib/testBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testBlock.js","sourceRoot":"","sources":["../src/testBlock.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,YAAY,GAEZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAsBjD,MAAM,UAAU,SAAS,CACxB,KAAqE,EACrE,WAAoE,EAAE;IAEtE,OAAO,YAAY,CAClB,KAAyC,EACzC;QACC,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAY;QAC/D,GAAG,QAAQ;KACwC,CACpD,CAAC;AACH,CAAC"}

package/lib/testBlock.test.d.ts

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

package/lib/testBlock.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testBlock.test.d.ts","sourceRoot":"","sources":["../src/testBlock.test.ts"],"names":[],"mappings":""}

package/lib/testBlock.test.js

@@ -0,0 +1,79 @@
+import { createBase } from "bingo-stratum";
+import { describe, expect, it } from "vitest";
+import { z } from "zod";
+import { testBlock } from "./testBlock.js";
+const base = createBase({
+    options: {
+        value: z.string(),
+    },
+});
+const blockStandalone = base.createBlock({
+    produce() {
+        return {
+            files: {
+                "value.txt": "abc",
+            },
+        };
+    },
+});
+describe("testBlock", () => {
+    it("doesn't throw an error when settings isn't provided and the block uses no settings", () => {
+        const actual = testBlock(blockStandalone);
+        expect(actual).toEqual({ files: { "value.txt": "abc" } });
+    });
+    it("doesn't throw an error when settings is {} and the block uses no settings", () => {
+        const actual = testBlock(blockStandalone, {});
+        expect(actual).toEqual({ files: { "value.txt": "abc" } });
+    });
+    describe("addons", () => {
+        const blockUsingAddons = base.createBlock({
+            addons: {
+                value: z.string().optional(),
+            },
+            produce({ addons }) {
+                return {
+                    files: {
+                        "value.txt": addons.value ?? "default",
+                    },
+                };
+            },
+        });
+        it("does not throws an error when addons isn't provided and a block uses addons", () => {
+            const actual = testBlock(blockUsingAddons, {});
+            expect(actual).toMatchInlineSnapshot(`
+				{
+				  "files": {
+				    "value.txt": "default",
+				  },
+				}
+			`);
+        });
+        it("passes addons to the block when provided", () => {
+            const actual = testBlock(blockUsingAddons, {
+                addons: { value: "abc" },
+            });
+            expect(actual).toEqual({ files: { "value.txt": "abc" } });
+        });
+    });
+    describe("options", () => {
+        const blockUsingOptions = base.createBlock({
+            produce({ options }) {
+                return {
+                    files: {
+                        "value.txt": options.value,
+                    },
+                };
+            },
+        });
+        it("throws an error when options isn't provided and a block uses options", () => {
+            expect(() => testBlock(blockUsingOptions)).toThrowErrorMatchingInlineSnapshot(`[Error: Context property 'options' was used by the Block but not provided.]`);
+        });
+        it("passes options to the block when provided", () => {
+            const actual = testBlock(blockUsingOptions, {
+                options: { value: "abc" },
+            });
+            expect(actual).toEqual({ files: { "value.txt": "abc" } });
+        });
+    });
+});
+//# sourceMappingURL=testBlock.test.js.map

package/lib/testBlock.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testBlock.test.js","sourceRoot":"","sources":["../src/testBlock.test.ts"],"names":[],"mappings":"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"}

package/lib/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function createFailingFunction(label: string, user: string): () => never;
+export declare function createFailingObject(label: string, user: string): {};
+//# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,eAEhE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,MAO9D"}

package/lib/utils.js

@@ -0,0 +1,12 @@
+export function createFailingFunction(label, user) {
+    return () => failingFunction(label, user);
+}
+export function createFailingObject(label, user) {
+    return new Proxy({}, {
+        get: createFailingFunction(label, user),
+    });
+}
+function failingFunction(label, user) {
+    throw new Error(`Context property '${label}' was used by ${user} but not provided.`);
+}
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,IAAY;IAChE,OAAO,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,IAAY;IAC9D,OAAO,IAAI,KAAK,CACf,EAAE,EACF;QACC,GAAG,EAAE,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC;KACvC,CACD,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAa,EAAE,IAAY;IACnD,MAAM,IAAI,KAAK,CACd,qBAAqB,KAAK,iBAAiB,IAAI,oBAAoB,CACnE,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "bingo-stratum-testers",
+  "version": "0.3.0",
+  "description": "Test utilities for Stratum Blocks and Presets. 🧑‍🔧",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JoshuaKGoldberg/bingo",
+    "directory": "packages/bingo-stratum-testers"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Josh Goldberg ✨",
+    "email": "npm@joshuakgoldberg.com"
+  },
+  "type": "module",
+  "main": "./lib/index.js",
+  "files": [
+    "lib/",
+    "package.json",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "devDependencies": {
+    "zod": "3.24.2"
+  },
+  "peerDependencies": {
+    "bingo": "^0.3.0",
+    "bingo-stratum": "^0.2.0",
+    "bingo-fs": "^0.2.0",
+    "bingo-systems": "^0.2.0",
+    "bingo-testers": "^0.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}