testeranto 0.47.34 → 0.47.52

package/.nvmrc

@@ -0,0 +1 @@
+v18.18.0

package/Bundle.Dockerfile

@@ -0,0 +1,45 @@
+FROM node:18.18.0
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    python3 \
+    make \
+    g++ && \
+    rm -rf /var/lib/apt/lists/*
+
+RUN yarn global add node-gyp
+
+RUN mkdir -p /usr/src/app
+RUN mkdir -p /usr/src/app/docs
+WORKDIR /usr/src/app
+COPY package.json /usr/src/app
+RUN yarn install
+COPY ./src/ /usr/src/app/src
+COPY ./subPackages/ /usr/src/app/subPackages
+COPY ./testeranto.mts /usr/src/app/testeranto.mts
+COPY ./tsconfig.json /usr/src/app/tsconfig.json
+COPY ./init.mts /usr/src/app/init.mts
+COPY ./bundle.mts /usr/src/app/bundle.mts
+COPY ./test.mts /usr/src/app/test.mts
+
+RUN yarn run init
+RUN yarn bundle
+# COPY ./docs/ /usr/src/app/docs
+# # COPY ./testeranto.json /usr/src/app/testeranto.json
+# # COPY prebuild.sh /usr/src/app
+# # COPY postBuild.sh /usr/src/app
+
+
+# # RUN yarn build
+
+# RUN cp ./node_modules/testeranto/dist/prebuild/TaskManBackEnd.mjs /usr/src/app/TaskManBackEnd.mjs
+# RUN cp ./node_modules/testeranto/dist/prebuild/TaskManFrontEnd.js /usr/src/app/TaskManFrontEnd.js
+# RUN cp ./node_modules/testeranto/dist/prebuild/TaskManFrontEnd.css /usr/src/app/TaskManFrontEnd.css
+
+# # RUN ts-node-esm ./node_modules/testeranto/dist/prebuild/TaskManBackEnd.mjs
+
+# EXPOSE 3000
+# EXPOSE 27017
+# ENV MONGO_HOST=host.docker.internal
+# # # CMD ['yarn', 'testeranto-testrun', '&', 'yarn', 'testeranto-taskman']
+CMD ["node", "test.mts"]

package/README.md

@@ -1,5 +1,7 @@
 # testeranto
 
+🚧 WARNING: Testeranto is still under development and is not ready for production yet. 🚧
+
 home: [adamwong246.github.io/testeranto](https://adamwong246.github.io/testeranto/)
 
 source: [github.com/adamwong246/testeranto](https://github.com/adamwong246/testeranto)
@@ -12,7 +14,7 @@ example repo: [kokomo bay](https://github.com/ChromaPDX/kokomoBay)
 
 ## tl;dr
 
-- Do you like BDD?
+- Do you like TDD/BDD?
 - Do you love Typescript?
 - Do you hate Jira?
 
@@ -20,23 +22,40 @@ If so, then testeranto might be the testing tool you have been looking for!
 
 ## about
 
-Testeranto.ts an Acceptance Test Driven Development ([ATDD](https://en.wikipedia.org/wiki/Acceptance_test-driven_development)) framework. It focuses on strongly-typed tests, specified in a gherkin-like syntax. Testeranto includes a framework to help write your tests, a test runner to schedule the tests and a reporter to display the results.
-
-## 2 distinguishing features of testeranto
+Testeranto.ts an typescript Acceptance Test Driven Development ([ATDD](https://en.wikipedia.org/wiki/Acceptance_test-driven_development)) framework. It includes a library of common patterns to help write your tests, a test runner to schedule the tests and a reporter to display the results. The tests are specified in a strongly-typed gherkin-like syntax. Features are tracked _as code_, rather than living in a separate app. Tests can be run in the browser frontend or the node backend, or both! Testeranto can be used to test _anything_ that can be bundled with esbuild.
 
-1. Rather than testing your code directly, Testeranto requires you wrap your code with a semantic interface which is based on TS type signatures. These interfaces can be shared and your code is now tested through the gherkin-ish directives provided by that interface.
+## Getting started
 
-2. Testeranto tracks features and test results directly in the source code. You may be accustomed to using tools like Jira and Trello to define user stories and assign story points- Under Testeranto, this data lives within the code base _as_ typescript code. Features are defined as nodes within a directed graph, allowing the reporter to summarize these features and their test results.
+1. Write some code.
+2. Write some tests of that code.
+3. Write some features of that code.
+4. Write a `testeranto.mts`, which acts as a config file.
+5. Launch testeranto. The test runner is now rebuilding the docs folder.
+6. Commit the results of those tests.
+7. Your github pages now shows your report, showing your features, linked with your test results.
+8. Optionally add testeranto to your CI.
 
 ## tech of note
 
+- esm - Testeranto uses modern js.
 - typescript - tests are functions with type parameters
+- puppeteer - provides access to both node and chrome runtimes
 - esbuild - used to quickly generate test bundles
 - graphology - used to store features within a semantic network
 
+## 3 distinguishing features of testeranto
+
+1. Rather than testing your code directly, Testeranto requires you wrap your code with a semantic interface which is based on TS type signatures. These interfaces can be shared and your code is tested through the gherkin-ish directives provided by that interface.
+
+2. Testeranto tracks features and tests results directly in the source code. You may be accustomed to using tools like Jira and Trello to define user stories and assign story points. Using Testeranto, this data lives within the code base _as_ typescript code. Features are defined as nodes within a directed graph, allowing the reporter to summarize these features and their test results.
+
+3. Testeranto is designed for both the backend and the frontend. It leverages puppeteer to provide both of these runtimes. Each of your tests can be executed in the backend node runtime, within the frontend chromium browser runtime, or both.
+
 ## the good parts
 
-Testeranto includes a test runner which bundles and executes your tests, taking care to only run the tests which have changed. It is designed to run most tests in parallel, though it has support for tests which require a shared resource, like a port.
+Your tests can be run in node, chromium, or both.
+
+Testeranto includes a test runner which bundles and executes your tests, taking care to only run the tests which have changed.
 
 Testeranto includes a test reporter which displays the state of your code in a web app. ([see example](https://chromapdx.github.io/kokomoBay/report.html)) This reporter can also be run locally for the developer's convenience.
 
@@ -46,10 +65,66 @@ Rather than the traditional method of specifying tests in plain text, Testeranto
 
 ## the bad parts
 
-Testeranto does not (yet!) of a means of allowing non-coders to affect changes so, as they say, "get good 💪!"
+Testeranto is very flexible and unopinionated, but not designed to maximize performance.
+
+Testeranto does not (yet!) allow a means of allowing non-coders to affect changes so, as they say, "git good 💪!"
+
+Testeranto uses ONLY node v8 and chromium. It does not support bun or deno, nor firefox nor safari.
+
+## How it works
+
+Testeranto is comprised of 3 parts
+
+1. The build process reads a config and builds the docs folder, then launches 3 esbuild build processes.
+
+- Build the features for the html report
+- Build the node-style tests
+- Build the web-style tests
+
+2. The test runner watches the output of those build processes and launches the tests as those files change. It uses puppeteer to run web tests in chromium. It uses dynamic loading to import the node tests directly into the node v8 process.
+
+3. A Report which links your features, your tests and the results of those tests into a handy website.
+
+## CLI
+
+There are 3 commands you should add to your `package.json`
+
+```
+// build the tests once
+"testeranto-esbuild": "ts-node-esm testeranto.mts",
+
+// build the tests, watching for changes
+"testeranto-esbuild-dev": "ts-node-esm testeranto.mts",
+
+// run the tests
+"testeranto-puppeteer":"ts-node-esm node_modules/testeranto/dist/module/Puppeteer.js",
+```
+
+## Hybrid tests
+
+Consider the a scenario: You have an http server which serves a frontend react component. You have multiple ways you can test this.
+
+- A node test of the logic of the http server.
+- A node test of the full http server, tested over http request.
+- A node test of the react component with react-test-render
+- A web test of the react component rendering it to the dom.
+- A node test of the logic of the server, rending the component as a paired artifact and communicated over IPC.
+- A node test of the full server, invoking puppeteer to drive the browser.
+- A web test, invoking the server as a shared artifact, serving http to the browser.
+
+## API
+
+Testeranto's main API interface is 2 functions, 1 for each run time. You must pass to this function the following arguments
 
-Testeranto is not for testing pure functions. It's designed only to address _stateful_ logic.
+- The "shape" - a TS type signature to which the other arguments must conform.
+- The "input" - the test subject. The "thing that is to be tested"
+- the "specification" - This is the Cucumber-style Given/When/Then steps.
+- the "implementation" - This is the code which implements the "test specification" in code.
+- the "interface" - The code which sets up the test.
 
-Testeranto prefers TS and to be leveraged to it full potential requires at least some proficiency with the language.
+This is designed so that each piece can be worked upon separately. You can think of each argument as the responsibility of a different member of your team.
 
-Because Testeranto is so un-opinionated that it does not provide test infrastructure. You will need to find an existing recipe or implement it yourself, though I plan to have some sort of public repo of test interfaces someday 😅
+- "Senior Engineer" handles the "shape" and "input"
+- "Product Manager" handles the "specification"
+- "Middle Engineer" handles the "interface"
+- "Junior Engineer" handles the "implementation"

package/Report.Dockerfile

@@ -0,0 +1,43 @@
+FROM node:18.18.0
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    python3 \
+    make \
+    g++ && \
+    rm -rf /var/lib/apt/lists/*
+
+RUN yarn global add node-gyp
+
+RUN mkdir -p /usr/src/app
+RUN mkdir -p /usr/src/app/docs
+WORKDIR /usr/src/app
+COPY package.json /usr/src/app
+RUN yarn install
+COPY ./src/ /usr/src/app/src
+COPY ./subPackages/ /usr/src/app/subPackages
+COPY ./testeranto.mts /usr/src/app/testeranto.mts
+COPY ./tsconfig.json /usr/src/app/tsconfig.json
+COPY ./init.mts /usr/src/app/init.mts
+COPY ./report.mts /usr/src/app/report.mts
+RUN yarn run init
+# RUN yarn report
+# COPY ./docs/ /usr/src/app/docs
+# # COPY ./testeranto.json /usr/src/app/testeranto.json
+# # COPY prebuild.sh /usr/src/app
+# # COPY postBuild.sh /usr/src/app
+
+
+# # RUN yarn build
+
+# RUN cp ./node_modules/testeranto/dist/prebuild/TaskManBackEnd.mjs /usr/src/app/TaskManBackEnd.mjs
+# RUN cp ./node_modules/testeranto/dist/prebuild/TaskManFrontEnd.js /usr/src/app/TaskManFrontEnd.js
+# RUN cp ./node_modules/testeranto/dist/prebuild/TaskManFrontEnd.css /usr/src/app/TaskManFrontEnd.css
+
+# # RUN ts-node-esm ./node_modules/testeranto/dist/prebuild/TaskManBackEnd.mjs
+
+EXPOSE 3000
+EXPOSE 27017
+ENV MONGO_HOST=host.docker.internal
+# # CMD ['yarn', 'testeranto-testrun', '&', 'yarn', 'testeranto-taskman']
+CMD ["yarn", "report"]

package/dist/cjs-shim.js

@@ -0,0 +1,12 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import url from 'node:url';
+
+// globalThis.require = createRequire(import.meta.url);
+globalThis.__filename = url.fileURLToPath(import.meta.url);
+globalThis.__dirname = path.dirname(__filename);
+
+// const p = `${import.meta.url}/..`;
+// globalThis.require = createRequire(`${import.meta.url}/..`);
+// globalThis.__filename = url.fileURLToPath(`${import.meta.url}/..`);
+// globalThis.__dirname = path.dirname(`${__filename}/..`);

package/dist/common/Features.js

@@ -3,10 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DirectedGraph = exports.TesterantoFeatures = exports.TesterantoGraphDirectedAcyclic = exports.TesterantoGraphDirected = exports.TesterantoGraphUndirected = exports.BaseFeature = void 0;
-const graphology_1 = __importDefault(require("graphology"));
-/* @ts-ignore:next-line */
-const { DirectedGraph, UndirectedGraph } = graphology_1.default;
+exports.DirectedGraph = exports.TesterantoGraphDirectedAcyclic = exports.TesterantoGraphDirected = exports.TesterantoGraphUndirected = exports.BaseFeature = void 0;
+const graphology_umd_js_1 = __importDefault(require("graphology/dist/graphology.umd.js"));
+const { DirectedGraph, UndirectedGraph } = graphology_umd_js_1.default;
 exports.DirectedGraph = DirectedGraph;
 class TesterantoGraph {
     constructor(name) {
@@ -49,37 +48,4 @@ class TesterantoGraphDirectedAcyclic {
     }
 }
 exports.TesterantoGraphDirectedAcyclic = TesterantoGraphDirectedAcyclic;
-class TesterantoFeatures {
-    constructor(features, graphs) {
-        this.features = features;
-        this.graphs = graphs;
-    }
-    networks() {
-        return [
-            ...this.graphs.undirected.values(),
-            ...this.graphs.directed.values(),
-            ...this.graphs.dags.values(),
-        ];
-    }
-    toObj() {
-        return {
-            features: Object.entries(this.features).map(([name, feature]) => {
-                return Object.assign(Object.assign({}, feature), { inNetworks: this.networks()
-                        .filter((network) => {
-                        return network.graph.hasNode(feature.name);
-                    })
-                        .map((network) => {
-                        return {
-                            network: network.name,
-                            neighbors: network.graph.neighbors(feature.name),
-                        };
-                    }) });
-            }),
-            networks: this.networks().map((network) => {
-                return Object.assign({}, network);
-            }),
-        };
-    }
-}
-exports.TesterantoFeatures = TesterantoFeatures;
 exports.default = {};

package/dist/common/Init.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+exports.default = async (partialConfig) => {
+    const config = Object.assign(Object.assign({}, partialConfig), { buildDir: process.cwd() + "/" + partialConfig.outdir });
+    fs_1.default.writeFileSync(`${config.outdir}/testeranto.json`, JSON.stringify(Object.assign(Object.assign({}, config), { buildDir: process.cwd() + "/" + config.outdir }), null, 2));
+    fs_1.default.copyFileSync("./node_modules/testeranto/dist/prebuild/TaskManFrontEnd.js", "./docs/TaskManFrontEnd.js");
+    fs_1.default.copyFileSync("./node_modules/testeranto/dist/prebuild/TaskManFrontEnd.css", "./docs/TaskManFrontEnd.css");
+    fs_1.default.writeFileSync(`${config.outdir}/index.html`, `<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta name="description" content="Webpage description goes here" />
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="author" content="" />
+
+  <title>TaskMan</title>
+
+  <link rel="stylesheet" href="/docs/TaskManFrontEnd.css" />
+  <script type="module" src="/docs/TaskManFrontEnd.js"></script>
+</head>
+
+<body><div id="root">react is loading</div></body>
+
+</html>`);
+};

package/dist/common/Node.js

@@ -3,72 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const core_js_1 = require("./core.js");
-const core_js_2 = __importDefault(require("./core.js"));
-const NodeWriter_js_1 = require("./NodeWriter.js");
-const receiveTestResourceConfigUnscheduled = async (t, testresource) => {
-    const { failed, artifacts, logPromise } = await t.receiveTestResourceConfig(testresource);
-    Promise.all([...artifacts, logPromise]).then(async () => {
-        process.exit(await failed ? 1 : 0);
-    });
-};
-const receiveTestResourceConfigScheduled = async (t, testresource) => {
-    const { failed, artifacts, logPromise } = await t.receiveTestResourceConfig(testresource);
-    /* @ts-ignore:next-line */
-    process.send({
-        type: "testeranto:adios",
-        data: {
-            failed,
-            testResourceConfiguration: t.test.testResourceConfiguration,
-            results: t.toObj(),
-        },
-    }, async (err) => {
-        if (!err) {
-            Promise.all([...artifacts, logPromise]).then(async () => {
-                process.exit(await failed ? 1 : 0);
-            });
-        }
-        else {
-            console.error(err);
-            process.exit(1);
-        }
-    });
-};
-exports.default = async (input, testSpecification, testImplementation, testInterface, testResourceRequirement = core_js_1.defaultTestResourceRequirement) => {
-    const mrt = new core_js_2.default(input, testSpecification, testImplementation, testInterface, testResourceRequirement, testInterface.assertioner || (async (t) => t), testInterface.beforeEach || async function (subject, initialValues, testResource) {
-        return subject;
-    }, testInterface.afterEach || (async (s) => s), testInterface.afterAll || ((store) => undefined), testInterface.butThen || (async (a) => a), testInterface.andWhen, testInterface.actionHandler ||
-        function (b) {
-            return b;
-        }, NodeWriter_js_1.NodeWriter);
-    const tl2 = mrt;
-    const t = tl2.testJobs[0];
-    const testResourceArg = process.argv[2] || `{}`;
-    try {
-        const partialTestResource = JSON.parse(testResourceArg);
-        if (partialTestResource.scheduled) {
-            console.log("test is scheduled", partialTestResource);
-            console.log("requesting test resources via IPC ...", testResourceRequirement);
-            /* @ts-ignore:next-line */
-            process.send({
-                type: "testeranto:hola",
-                data: {
-                    requirement: Object.assign(Object.assign({}, testResourceRequirement), { name: partialTestResource.name })
-                },
-            });
-            console.log("awaiting test resources via IPC...");
-            process.on("message", async function (packet) {
-                const resourcesFromPm2 = packet.data.testResourceConfiguration;
-                const secondTestResource = Object.assign(Object.assign({ fs: "." }, JSON.parse(JSON.stringify(partialTestResource))), JSON.parse(JSON.stringify(resourcesFromPm2)));
-                receiveTestResourceConfigScheduled(t, secondTestResource);
-            });
-        }
-        else {
-            receiveTestResourceConfigUnscheduled(t, partialTestResource);
-        }
+const core_js_1 = __importDefault(require("./lib/core.js"));
+const index_js_1 = require("./lib/index.js");
+const node_js_1 = require("./PM/node.js");
+class NodeTesteranto extends core_js_1.default {
+    constructor(input, testSpecification, testImplementation, testResourceRequirement, testInterface) {
+        super(input, testSpecification, testImplementation, testResourceRequirement, testInterface);
     }
-    catch (e) {
-        console.error(e);
-        process.exit(-1);
+    async receiveTestResourceConfig(partialTestResource) {
+        const t = JSON.parse(partialTestResource);
+        console.log("receiveTestResourceConfig", t);
+        const pm = new node_js_1.PM_Node(t);
+        const { failed, artifacts, logPromise } = await this.testJobs[0].receiveTestResourceConfig(pm);
+        pm.customclose();
     }
+}
+exports.default = async (input, testSpecification, testImplementation, testInterface, testResourceRequirement = index_js_1.defaultTestResourceRequirement) => {
+    return new NodeTesteranto(input, testSpecification, testImplementation, testResourceRequirement, testInterface);
 };

package/dist/common/PM/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PM = void 0;
+const fPaths = [];
+class PM {
+}
+exports.PM = PM;