testeranto 0.47.11 → 0.47.13

package/dist/common/Project.js

@@ -0,0 +1,648 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ITProject = void 0;
+const ws_1 = require("ws");
+const esbuild_1 = __importDefault(require("esbuild"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const fs_promises_exists_1 = __importDefault(require("fs.promises.exists"));
+const pm2_1 = __importDefault(require("pm2"));
+const readline_1 = __importDefault(require("readline"));
+readline_1.default.emitKeypressEvents(process.stdin);
+if (process.stdin.isTTY)
+    process.stdin.setRawMode(true);
+const TIMEOUT = 2000;
+const OPEN_PORT = "";
+let webSocketServer;
+const getRunnables = (tests, payload = [new Set(), new Set()]) => {
+    return tests.reduce((pt, cv, cndx, cry) => {
+        if (cv[1] === "node") {
+            pt[0].add(cv[0]);
+        }
+        else if (cv[1] === "web") {
+            pt[1].add(cv[0]);
+        }
+        if (cv[2].length) {
+            getRunnables(cv[2], payload);
+        }
+        return pt;
+    }, payload);
+};
+class ITProject {
+    constructor(config) {
+        this.exitCodes = {};
+        this.mode = `up`;
+        this.ports = {};
+        this.websockets = {};
+        this.resourceQueue = [];
+        this.spinCycle = 0;
+        this.spinAnimation = "←↖↑↗→↘↓↙";
+        this.mainLoop = async () => {
+            if (this.clearScreen) {
+                console.clear();
+            }
+            const procsTable = [];
+            pm2_1.default.list((err, procs) => {
+                procs.forEach((proc) => {
+                    var _a, _b;
+                    procsTable.push({
+                        name: proc.name,
+                        pid: proc.pid,
+                        pm_id: proc.pm_id,
+                        mem: (_a = proc.monit) === null || _a === void 0 ? void 0 : _a.memory,
+                        cpu: (_b = proc.monit) === null || _b === void 0 ? void 0 : _b.cpu,
+                        "exit code": this.exitCodes[proc.name]
+                    });
+                });
+                console.table(procsTable);
+                console.table(this.resourceQueue);
+                // console.log("webSocketServer.clients", webSocketServer.clients.size);
+                // console.log("resourceQueue", this.resourceQueue);
+                const resourceRequest = this.resourceQueue.pop();
+                if (!resourceRequest) {
+                    if (!this.devMode && this.mode === "up") {
+                        this.initiateShutdown("resource request queue is empty");
+                    }
+                    if (this.mode === "down" && procsTable.every((p) => p.pid === 0 || p.pid === undefined)) {
+                        this.shutdown();
+                    }
+                }
+                else {
+                    console.log("handling", resourceRequest);
+                    if (resourceRequest.protocol === "ipc") {
+                        this.allocateViaIpc(resourceRequest);
+                    }
+                    else if (resourceRequest.protocol === "ws") {
+                        this.allocateViaWs(resourceRequest);
+                    }
+                }
+                if (this.devMode) {
+                    if (this.mode === "up") {
+                        console.log(this.spinner(), "Running tests while watching for changes. Use 'q' to initiate shutdown");
+                    }
+                    else {
+                        console.log(this.spinner(), "Shutdown is in progress. Please wait.");
+                    }
+                }
+                else {
+                    if (this.mode === "up") {
+                        console.log(this.spinner(), "Running tests without watching for changes. Use 'q' to initiate shutdown");
+                    }
+                    else {
+                        console.log(this.spinner(), "Shutdown is in progress. Please wait.");
+                    }
+                }
+                // console.log(this.spinner());
+                // console.log(
+                //   this.spinner(),
+                //   this.mode === `up`
+                //     ? `press "q" to initiate graceful shutdown`
+                //     : `please wait while testeranto shuts down gracefully...`
+                // );
+            });
+        };
+        this.clearScreen = config.clearScreen;
+        this.devMode = config.devMode;
+        Object.values(config.ports).forEach((port) => {
+            this.ports[port] = OPEN_PORT;
+        });
+        const testPath = `${process.cwd()}/${config.tests}`;
+        const featurePath = `${process.cwd()}/${config.features}`;
+        process.on('SIGINT', () => this.initiateShutdown("CTRL+C"));
+        process.on('SIGQUIT', () => this.initiateShutdown("Keyboard quit"));
+        process.on('SIGTERM', () => this.initiateShutdown("'kill' command"));
+        process.stdin.on('keypress', (str, key) => {
+            if (key.name === 'q') {
+                this.initiateShutdown("'q' command");
+            }
+        });
+        Promise.resolve().then(() => __importStar(require(testPath))).then((tests) => {
+            this.tests = tests.default;
+            Promise.resolve().then(() => __importStar(require(featurePath))).then((features) => {
+                this.features = features.default;
+                Promise.resolve(Promise.all([
+                    ...this.getSecondaryEndpointsPoints("web")
+                ]
+                    .map(async (sourceFilePath) => {
+                    const sourceFileSplit = sourceFilePath.split("/");
+                    const sourceDir = sourceFileSplit.slice(0, -1);
+                    const sourceFileName = sourceFileSplit[sourceFileSplit.length - 1];
+                    const sourceFileNameMinusJs = sourceFileName.split(".").slice(0, -1).join(".");
+                    const htmlFilePath = path_1.default.normalize(`${process.cwd()}/${config.outdir}/${sourceDir.join("/")}/${sourceFileNameMinusJs}.html`);
+                    const jsfilePath = `./${sourceFileNameMinusJs}.mjs`;
+                    return fs_1.default.promises.mkdir(path_1.default.dirname(htmlFilePath), { recursive: true }).then(x => fs_1.default.writeFileSync(htmlFilePath, `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <script type="module" src="${jsfilePath}"></script>
+</head>
+
+<body>
+  <h1>${htmlFilePath}</h1>
+  <div id="root">
+    
+  </div>
+</body>
+
+<footer></footer>
+
+</html>
+`));
+                })));
+                const [nodeEntryPoints, webEntryPoints] = getRunnables(this.tests);
+                const esbuildConfigNode = {
+                    define: {
+                        "process.env.FLUENTFFMPEG_COV": "0"
+                    },
+                    absWorkingDir: process.cwd(),
+                    banner: {
+                        js: `import { createRequire } from 'module';const require = createRequire(import.meta.url);`
+                    },
+                    target: "esnext",
+                    // packages: "external",
+                    format: "esm",
+                    splitting: true,
+                    outExtension: { '.js': '.mjs' },
+                    platform: "node",
+                    external: ["tests.test.js", "features.test.js", "react"],
+                    outbase: config.outbase,
+                    outdir: config.outdir,
+                    jsx: 'transform',
+                    entryPoints: [...nodeEntryPoints],
+                    bundle: true,
+                    minify: config.minify === true,
+                    write: true,
+                    loader: {
+                        '.js': 'jsx',
+                        '.png': 'binary',
+                        '.jpg': 'binary',
+                    },
+                    plugins: [
+                        ...(config.plugins || []),
+                        {
+                            name: 'rebuild-notify',
+                            setup(build) {
+                                build.onEnd(result => {
+                                    console.log(`node build ended with ${result.errors.length} errors`);
+                                    result.errors.length !== 0 && process.exit(-1);
+                                    // HERE: somehow restart the server from here, e.g., by sending a signal that you trap and react to inside the server.
+                                });
+                            }
+                        },
+                    ],
+                };
+                const esbuildConfigWeb = {
+                    // packages: "external",
+                    target: "esnext",
+                    format: "esm",
+                    splitting: true,
+                    outExtension: { '.js': '.mjs' },
+                    alias: {
+                        react: path_1.default.resolve("./node_modules/react")
+                    },
+                    external: [
+                        // "url", 
+                        "electron",
+                        "path",
+                        "fs",
+                        // "react",
+                        "stream",
+                        "tests.test.js", "features.test.js"
+                    ],
+                    platform: "browser",
+                    outbase: config.outbase,
+                    outdir: config.outdir,
+                    jsx: 'transform',
+                    entryPoints: [
+                        ...webEntryPoints,
+                        testPath,
+                        featurePath,
+                    ],
+                    bundle: true,
+                    minify: config.minify === true,
+                    write: true,
+                    loader: {
+                        '.js': 'jsx',
+                        '.png': 'binary',
+                        '.jpg': 'binary',
+                    },
+                    plugins: [
+                        ...(config.plugins || []),
+                        {
+                            name: 'rebuild-notify',
+                            setup(build) {
+                                build.onEnd(result => {
+                                    console.log(`web build ended with ${result.errors.length} errors`);
+                                    result.errors.length !== 0 && process.exit(-1);
+                                    // HERE: somehow restart the server from here, e.g., by sending a signal that you trap and react to inside the server.
+                                });
+                            }
+                        },
+                    ],
+                };
+                esbuild_1.default.build({
+                    bundle: true,
+                    entryPoints: ["./node_modules/testeranto/dist/module/Report.js"],
+                    minify: config.minify === true,
+                    outbase: config.outbase,
+                    write: true,
+                    outfile: `${config.outdir}/Report.js`,
+                    external: ["tests.test.js", "features.test.js"]
+                });
+                fs_1.default.writeFileSync(`${config.outdir}/report.html`, `
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta name="description" content="Webpage description goes here" />
+  <meta charset="utf-8" />
+  <title>kokomoBay - testeranto</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="author" content="" />
+  <link rel="stylesheet" href="./Report.css" />
+
+  <script type="importmap">
+    {
+    "imports": {
+      "tests.test.js": "./tests.test.js",
+      "features.test.js": "./features.test.js"
+    }
+  }
+  </script>
+
+
+  <script src="./Report.js"></script>
+</head>
+
+<body>
+  <div id="root">
+    react is loading
+  </div>
+</body>
+
+</html>
+        `);
+                Promise.all([
+                    esbuild_1.default.context(esbuildConfigNode).then(async (nodeContext) => {
+                        await nodeContext.watch();
+                    }),
+                    esbuild_1.default.context(esbuildConfigWeb).then(async (esbuildWeb) => {
+                        await esbuildWeb.watch();
+                    })
+                ]);
+                pm2_1.default.connect(async (err) => {
+                    if (err) {
+                        console.error(err);
+                        process.exit(-1);
+                    }
+                    else {
+                        console.log(`pm2 is connected`);
+                    }
+                    // run a websocket as an alternative to node IPC
+                    webSocketServer = new ws_1.WebSocketServer({
+                        port: 8080,
+                        host: "localhost",
+                    });
+                    webSocketServer.on('open', () => {
+                        console.log('open');
+                        // process.exit()
+                    });
+                    webSocketServer.on('close', (data) => {
+                        console.log('webSocketServer close: %s', data);
+                        // process.exit()
+                    });
+                    webSocketServer.on('listening', () => {
+                        console.log("webSocketServer listening", webSocketServer.address());
+                        // process.exit()
+                    });
+                    webSocketServer.on('connection', (webSocket) => {
+                        console.log('webSocketServer connection');
+                        webSocket.on('message', (webSocketData) => {
+                            console.log('webSocket message: %s', webSocketData);
+                            const payload = webSocketData.valueOf();
+                            const name = payload.data.name;
+                            const messageType = payload.type;
+                            const requestedResources = payload.data;
+                            this.websockets[name] = webSocket;
+                            console.log('connected: ' + name + ' in ' + Object.getOwnPropertyNames(this.websockets));
+                            if (messageType === "testeranto:hola") {
+                                console.log("hola WS", requestedResources);
+                                this.requestResource(requestedResources, 'ws');
+                            }
+                            else if (messageType === "testeranto:adios") {
+                                console.log("adios WS", name);
+                                this.releaseTestResources(payload);
+                            }
+                        });
+                    });
+                    const makePath = (fPath, rt) => {
+                        return path_1.default.resolve("./" + config.outdir + "/" + fPath.replace(path_1.default.extname(fPath), "") + ".mjs");
+                    };
+                    const bootInterval = setInterval(async () => {
+                        const filesToLookup = this.tests
+                            .map(([p, rt]) => {
+                            const filepath = makePath(p, rt);
+                            return {
+                                filepath,
+                                exists: (0, fs_promises_exists_1.default)(filepath),
+                            };
+                        });
+                        const allFilesExist = (await Promise.all(filesToLookup.map((f) => f.exists))).every((b) => b);
+                        if (!allFilesExist) {
+                            console.log(this.spinner(), "waiting for files to build...");
+                            filesToLookup.forEach((f) => {
+                                console.log(f.exists, "\t", f.filepath);
+                            });
+                        }
+                        else {
+                            clearInterval(bootInterval);
+                            pm2_1.default.launchBus((err, pm2_bus) => {
+                                pm2_bus.on("testeranto:hola", (packet) => {
+                                    console.log("hola IPC", packet);
+                                    this.requestResource(packet.data.requirement, 'ipc');
+                                });
+                                pm2_bus.on("testeranto:adios", (payload) => {
+                                    console.log("adios IPC", payload);
+                                    this.releaseTestResources(payload.data);
+                                });
+                            });
+                            this
+                                .tests
+                                .reduce((m, [inputFilePath, runtime]) => {
+                                const script = makePath(inputFilePath, runtime);
+                                const partialTestResourceByCommandLineArg = `${script} '${JSON.stringify({
+                                    name: inputFilePath,
+                                    ports: [],
+                                    fs: path_1.default.resolve(process.cwd(), config.outdir, inputFilePath),
+                                })}'`;
+                                if (runtime === "web") {
+                                    const fileAsList = inputFilePath.split("/");
+                                    const fileListHead = fileAsList.slice(0, -1);
+                                    const fname = fileAsList[fileAsList.length - 1];
+                                    const fnameOnly = fname.split(".").slice(0, -1).join(".");
+                                    const htmlFile = [config.outdir, ...fileListHead, `${fnameOnly}.html`].join("/");
+                                    const jsFile = htmlFile.split(".html")[0] + ".mjs";
+                                    console.log("watching", jsFile);
+                                    pm2_1.default.start({
+                                        script: `yarn electron node_modules/testeranto/dist/common/electron.js ${htmlFile} '${JSON.stringify({
+                                            name: inputFilePath,
+                                            ports: [],
+                                            fs: path_1.default.resolve(process.cwd(), config.outdir, inputFilePath),
+                                        })}'`,
+                                        name: inputFilePath,
+                                        autorestart: false,
+                                        args: partialTestResourceByCommandLineArg,
+                                        watch: [jsFile],
+                                    }, (err, proc) => {
+                                        if (err) {
+                                            console.error(err);
+                                            return pm2_1.default.disconnect();
+                                        }
+                                    });
+                                }
+                                else if (runtime === "node") {
+                                    pm2_1.default.start({
+                                        name: inputFilePath,
+                                        script: `node ${script} '${JSON.stringify({
+                                            name: inputFilePath,
+                                            ports: [],
+                                            fs: path_1.default.resolve(process.cwd(), config.outdir, inputFilePath),
+                                        })}'`,
+                                        autorestart: false,
+                                        watch: [script],
+                                        args: partialTestResourceByCommandLineArg
+                                    }, (err, proc) => {
+                                        if (err) {
+                                            console.error(err);
+                                            return pm2_1.default.disconnect();
+                                        }
+                                    });
+                                }
+                                this.exitCodes[inputFilePath] = null;
+                                return [inputFilePath, ...m];
+                            }, []);
+                            setInterval(this.mainLoop, TIMEOUT).unref();
+                        }
+                    }, TIMEOUT).unref();
+                });
+            });
+        });
+    }
+    requestResource(requirement, protocol) {
+        this.resourceQueue.push({ requirement, protocol });
+    }
+    getSecondaryEndpointsPoints(runtime) {
+        if (runtime) {
+            return this.tests
+                .filter((t) => {
+                return (t[1] === runtime);
+            })
+                .map((tc) => tc[0]);
+        }
+        return this.tests
+            .map((tc) => tc[0]);
+    }
+    initiateShutdown(reason) {
+        console.log("Shutdown initiated because", reason);
+        this.mode = "down";
+    }
+    shutdown() {
+        console.log("Stopping PM2");
+        pm2_1.default.stop("all", (e) => console.error(e));
+        pm2_1.default.killDaemon((e) => console.error(e));
+        pm2_1.default.disconnect();
+        process.exit();
+    }
+    spinner() {
+        this.spinCycle = (this.spinCycle + 1) % this.spinAnimation.length;
+        return this.spinAnimation[this.spinCycle];
+    }
+    async releaseTestResources(payload) {
+        const name = payload.testResourceConfiguration.name;
+        const failed = payload.failed;
+        console.log("releaseTestResources", name, failed);
+        // reset ports
+        pm2_1.default.list((err, processes) => {
+            processes.forEach((proc) => {
+                if (proc.name === name) {
+                    Object.keys(this.ports).forEach((port) => {
+                        if (this.ports[port] === name) {
+                            this.ports[port] = OPEN_PORT;
+                        }
+                    });
+                }
+            });
+        });
+        this.exitCodes[name] = failed;
+    }
+    allocateViaWs(resourceRequest) {
+        const pName = resourceRequest.requirement.name;
+        const testResourceRequirement = resourceRequest.requirement;
+        pm2_1.default.list((err, processes) => {
+            console.error(err);
+            processes.forEach((p) => {
+                if (p.name === pName && p.pid) {
+                    const message = {
+                        // these fields must be present
+                        id: p.pid,
+                        topic: "some topic",
+                        type: "process:msg",
+                        // Data to be sent
+                        data: {
+                            testResourceConfiguration: {
+                                ports: [],
+                                // fs: fPath,
+                            },
+                            id: p.pm_id,
+                        },
+                    };
+                    if ((testResourceRequirement === null || testResourceRequirement === void 0 ? void 0 : testResourceRequirement.ports) === 0) {
+                        pm2_1.default.sendDataToProcessId(p.pid, message, function (err, res) {
+                            // console.log("sendDataToProcessId", err, res, message);
+                        });
+                    }
+                    if (((testResourceRequirement === null || testResourceRequirement === void 0 ? void 0 : testResourceRequirement.ports) || 0) > 0) {
+                        // clear any port-slots associated with this job
+                        Object.values(this.ports).forEach((jobMaybe, portNumber) => {
+                            if (jobMaybe && jobMaybe === pName) {
+                                this.ports[portNumber] = OPEN_PORT;
+                            }
+                        });
+                        // find a list of open ports
+                        const foundOpenPorts = Object.keys(this.ports).filter((p) => this.ports[p] === OPEN_PORT);
+                        // if there are enough open port-slots...
+                        if (foundOpenPorts.length >= testResourceRequirement.ports) {
+                            const selectionOfPorts = foundOpenPorts.slice(0, testResourceRequirement.ports);
+                            const message = {
+                                // these fields must be present
+                                id: p.pid,
+                                topic: "some topic",
+                                // process:msg will be send as 'message' on target process
+                                type: "process:msg",
+                                // Data to be sent
+                                data: {
+                                    testResourceConfiguration: {
+                                        // fs: fPath,
+                                        ports: selectionOfPorts,
+                                    },
+                                    id: p.pid,
+                                },
+                            };
+                            pm2_1.default.sendDataToProcessId(p.pid, message, function (err, res) {
+                                // no-op
+                            });
+                            // mark the selected ports as occupied
+                            for (const foundOpenPort of selectionOfPorts) {
+                                this.ports[foundOpenPort] = p.pid.toString();
+                            }
+                        }
+                        else {
+                            console.log(`no port was open so send the ${p.pid} job to the back of the resourceQueue`);
+                            this.resourceQueue.push(resourceRequest);
+                        }
+                    }
+                }
+            });
+        });
+    }
+    allocateViaIpc(resourceRequest) {
+        console.log("allocateViaIpc", resourceRequest);
+        const pName = resourceRequest.requirement.name;
+        const testResourceRequirement = resourceRequest.requirement;
+        pm2_1.default.list((err, processes) => {
+            console.error(err);
+            processes.forEach((p) => {
+                console.log("p.pid, p.name, p.pm_id", p.pid, p.name, p.pm_id);
+                if (p.name === pName && p.pid) {
+                    const message = {
+                        // these fields must be present
+                        id: p.pid,
+                        topic: "some topic",
+                        type: "process:msg",
+                        // Data to be sent
+                        data: {
+                            testResourceConfiguration: {
+                                ports: [],
+                                // fs: fPath,
+                            },
+                            id: p.pm_id,
+                        },
+                    };
+                    console.log("message", message);
+                    if ((testResourceRequirement === null || testResourceRequirement === void 0 ? void 0 : testResourceRequirement.ports) === 0) {
+                        pm2_1.default.sendDataToProcessId(p.pm_id, message, function (err, res) {
+                            // console.log("sendDataToProcessId", err, res, message);
+                        });
+                    }
+                    if (((testResourceRequirement === null || testResourceRequirement === void 0 ? void 0 : testResourceRequirement.ports) || 0) > 0) {
+                        // clear any port-slots associated with this job
+                        Object.values(this.ports).forEach((jobMaybe, portNumber) => {
+                            if (jobMaybe && jobMaybe === pName) {
+                                this.ports[portNumber] = OPEN_PORT;
+                            }
+                        });
+                        // find a list of open ports
+                        const foundOpenPorts = Object.keys(this.ports).filter((p) => this.ports[p] === OPEN_PORT);
+                        // if there are enough open port-slots...
+                        if (foundOpenPorts.length >= testResourceRequirement.ports) {
+                            const selectionOfPorts = foundOpenPorts.slice(0, testResourceRequirement.ports);
+                            const message = {
+                                // these fields must be present
+                                id: p.pid,
+                                topic: "some topic",
+                                // process:msg will be send as 'message' on target process
+                                type: "process:msg",
+                                // Data to be sent
+                                data: {
+                                    testResourceConfiguration: {
+                                        // fs: fPath,
+                                        ports: selectionOfPorts,
+                                    },
+                                    id: p.pid,
+                                },
+                            };
+                            pm2_1.default.sendDataToProcessId(p.pm_id, message, function (err, res) {
+                                // no-op
+                            });
+                            // mark the selected ports as occupied
+                            for (const foundOpenPort of selectionOfPorts) {
+                                this.ports[foundOpenPort] = p.pid.toString();
+                            }
+                        }
+                        else {
+                            console.log(`no port was open so send the ${p.pid} job to the back of the resourceQueue`);
+                            this.resourceQueue.push(resourceRequest);
+                        }
+                    }
+                }
+            });
+        });
+    }
+}
+exports.ITProject = ITProject;

package/dist/common/Types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });