risei 2.0.0 → 3.0.0

package/system/Risei.js

@@ -1,118 +0,0 @@
-/**/
-
-/* Copyright (c) 2023-2024 Ed Fallin.  Published under the terms of the MIT license. */
-
-/* This index.js is the entry point for running Risei tests from 
-   other code.  It imports other modules to perform its work.
-   It also exports modules that should / can be subclassed. */
-
-// region Imports
-
-// region Test-running dependencies
-
-import TestRunner from "./TestRunner.js";
-import LocalCaller from "./LocalCaller.js";
-import TerminalReporter from "./TerminalReporter.js";
-import TestFinder from "./TestFinder.js";
-
-// endregion Test-running dependencies
-
-// region Display dependencies
-
-import chalk from "chalk";
-import Moment from "./Moment.js";
-
-// endregion Display dependencies
-
-// endregion Imports
-
-// region Named styles
-
-/* Display styles for the start title and other general needs. */
-const title = chalk.hex("FFFFFF").bgHex("191970").bold;
-const fails = chalk.hex("000000").bgHex("FFD700").bold;
-
-// endregion Named styles
-
-// region Styling for color stripes
-
-let wide = (text) => { 
-    let width = process.stdout.columns;
-    text = text || "";
-
-    return text.padEnd(width, "\u00A0");
-};
-
-// endregion Styling for color stripes
-
-// region Key callable and its scripted call
-
-async function runRiseiMetaTests(testFinderPath) {
-    // region Converting test-finder from path to class
-    
-    testFinderPath = testFinderPath || "./TestFinder.js";
-    let finderModule = await import(testFinderPath);
-    
-    let moduleKeys = Object.keys(finderModule);
-    let classKey = moduleKeys[0];
-    let finderClass = finderModule[classKey];
-    
-    // endregion Converting test-finder from path to class
-
-    // region Intro / title
-    
-    console.clear();
-    console.log();
-    console.log(title(wide()));
-    
-    let now = new Date();
-    now = new Moment(now);
-    
-    console.log(title(wide(` Risei tests run on ${ now.asReadable() } local time.`)));
-    console.log(title(wide()));
-    
-    console.log();
-    
-    // endregion Intro / title
-    
-    // region Running tests
-    
-    // Test-system objects and their relationships.
-    const finder = new finderClass.prototype.constructor();
-    finder.sourceBySearch = () => { return { tests: "**.outward-rt.js" }; };
-
-    const runner = new TestRunner();
-    const reporter = new TerminalReporter();
-    
-    const caller = new LocalCaller(finder, runner, reporter);
-
-    // Actually running the tests using this system.
-    await caller.runAllTests();
-    
-    // endregion Running tests
-    
-    // region Trailing display of test-loading issues
-
-    if (finder.thrown.length !== 0) {
-        let loadFails = finder.thrown;
-
-        for (let fail of loadFails) {
-            console.log(fails(wide(` ${ fail }`)));
-        }
-    }
-
-    // endregion Trailing display of test-loading issues
-
-    // region Trailing formatting
-    
-    console.log();
-    console.log();
-    
-    // endregion Trailing formatting
-}
-
-/* Runs tests now. */
-await runRiseiMetaTests();
-
-// endregion Key callable and its scripted call
-

package/test-target-objects/ConditionalThrowTarget.js

@@ -1,11 +0,0 @@
-/**/
-
-export default class ConditionalThrowTarget {
-    returnArgOrThrow(arg) {
-        if (arg === undefined) {
-            throw new Error("No arg provided.");
-        }
-        
-        return arg;
-    }
-}

package/test-target-objects/Counter.js

@@ -1,46 +0,0 @@
-/**/
-
-export default class Counter {
-    constructor() {
-        /* No operations. */
-    }
-
-    howMany(subject, target) /* passed */ {
-        // Bad-call edge case.
-        if (arguments.length < 2) {
-            return 0;
-        }
-
-        // Bad-arg edge cases.
-        if (this.#isEdgeCase(subject, target)) {
-            return 0;
-        }
-
-        // Initial values and ops reducer.
-        let at = 0;
-        let count = 0;
-        let span = target.length;
-
-        // Tracking found site and jumping past it each time the target is found.
-        while ((at = subject.indexOf(target, at)) !== -1) {
-            count++;
-            at += span;
-        }
-
-        // Back to caller.
-        return count;
-    }
-
-    #isEdgeCase(subject, target) /* verified */ {
-        if (subject === null || target === null) {
-            return true;
-        }
-
-        if (target === "") {
-            return true;
-        }
-
-        return false;
-    }
-
-}

package/test-target-objects/DomTarget.js

@@ -1,37 +0,0 @@
-/**/
-
-export default class DomTarget {
-    // region Private fields
-
-    #id;
-    #node;
-    
-    // endregion Private fields
-    
-    // region Properties
-    
-    get id() {
-        return this.#id;
-    }
-    
-    get node() {
-        return this.#node;
-    }
-
-    // endregion Properties
-
-    constructor(id) {
-        this.#id = id;
-        this.#node = this.domNodeFrom(id);
-    }
-    
-    domNodeFrom(id) {
-        let node = document.getElementById(id);
-        return node;
-    }
-    
-    changeDomItem(id) {
-        this.#id = id;
-        this.#node = this.domNodeFrom(id);
-    }
-}

package/test-target-objects/InterSpoofer.js

@@ -1,230 +0,0 @@
-/**/
-
-import MethodSpoofer from "../system/MethodSpoofer.js";
-import PropertySpoofer from "../system/PropertySpoofer.js";
-import PropertiesTarget from "./PropertiesTarget.js";
-
-/* &cruft, maybe drop this after direct testing of groundwork 
-           and reversing it is possible with .do / .undo */
-export default class InterSpoofer {
-    // region Components
-
-    #methodSpoofer = new MethodSpoofer();
-    #propSpoofer = new PropertySpoofer();
-
-    // endregion Components
-
-    // region Gathered names of all spoofables
-
-    static staticProps = [ "staticBaseValueProp", "staticBaseAccessorProp", "staticValueProp", "staticAccessorProp" ];
-    static staticMethods = [ "staticBaseMethod", "staticMethod" ];
-    static props = [ "instanceBaseValueProp", "instanceBaseAccessorProp", "valueProp", "accessorProp" ];
-    static methods = [ "instanceBaseMethod", "instanceMethod" ];
-
-    static allMethods = [ InterSpoofer.staticMethods, InterSpoofer.methods ];
-    static allNames = [ InterSpoofer.staticProps, InterSpoofer.staticMethods, InterSpoofer.props, InterSpoofer.methods ];
-
-    // endregion Gathered names of all spoofables
-
-    // region Gathered original method defs and values
-
-    static #origDefs = InterSpoofer.#bundleDefs(
-        PropertiesTarget, new PropertiesTarget(), ...InterSpoofer.allMethods
-    );
-
-    static #origValues = InterSpoofer.#bundleValues(
-        PropertiesTarget, new PropertiesTarget(), ...InterSpoofer.allNames
-    );
-
-    // endregion Gathered original method defs and values
-
-    // region Methods to test spoofers
-
-    /* If these methods all pass, then the spoofers work 
-       together without breaking each other's changes. */
-
-    spoofMethodsThenProps(test) /* passed */ {
-        this.#methodSpoofer.spoof(test);
-        this.#propSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let values = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return values;
-    }
-    
-    spoofPropsThenMethods(test) /* passed */ {
-        this.#propSpoofer.spoof(test);
-        this.#methodSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let values = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return values;
-    }
-
-    spoofAndUnspoofMethodsThenProps(test) /* passed */ {
-        this.#methodSpoofer.spoof(test);
-        this.#propSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let before = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.#methodSpoofer.unspoof(test);
-        this.#propSpoofer.unspoof(test);
-
-        let after = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return { before, after };
-    }
-
-    spoofAndUnspoofPropsThenMethods(test) /* passed */ {
-        this.#propSpoofer.spoof(test);
-        this.#methodSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let before = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.#propSpoofer.unspoof(test);
-        this.#methodSpoofer.unspoof(test);
-
-        let after = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return { before, after };
-    }
-
-    spoofMethodsFirstAndUnspoofThemLast(test) /* passed */ {
-        this.#methodSpoofer.spoof(test);
-        this.#propSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let before = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.#propSpoofer.unspoof(test);
-        this.#methodSpoofer.unspoof(test);
-
-        let after = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return { before, after };
-    }
-
-    spoofPropsFirstAndUnspoofThemLast(test) /* passed */ {
-        this.#propSpoofer.spoof(test);
-        this.#methodSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let before = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.#methodSpoofer.unspoof(test);
-        this.#propSpoofer.unspoof(test);
-
-        let after = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return { before, after };
-    }
-
-    // endregion Methods to test spoofers
-
-    /* To ensure topic class isolated between tests. */
-    reverseAllSpoofs(type, target) /* verified */ {
-        /* Setting known properties and methods of target type 
-           back to their stored original definitions / values. */
-
-        for (let name of InterSpoofer.staticProps) {
-            type[name] = InterSpoofer.#origValues[name];
-        }
-
-        for (let name of InterSpoofer.staticMethods) {
-            type[name] = InterSpoofer.#origDefs[name];
-        }
-
-        /* Plain instance properties shouldn't need to be reversed. */
-
-        for (let name of InterSpoofer.methods) {
-            type.prototype[name] = InterSpoofer.#origDefs[name];
-        }
-
-        for (let name of InterSpoofer.props) {
-            target[name] = InterSpoofer.#origValues[name];
-        }
-
-        let reversed = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-    }
-
-    // region Internals
-
-    static #bundleDefs(type, target, staticMethods, methods) /* verified */ {
-        /* All callables asked for are stored as copies for restoring. */
-
-        let output = { };
-
-        for (let name of staticMethods) {
-            output[name] = InterSpoofer.#copyMethod(type[name]);
-        }
-
-        for (let name of methods) {
-            output[name] = InterSpoofer.#copyMethod(target[name]);
-        }
-
-        return output;
-    }
-
-    static #bundleValues(type, target, staticProps, staticMethods, props, methods) /* verified */ {
-        /* Everything asked for is dropped into an object, either 
-           property values or return values of calling methods. */
-
-        let output = { };
-
-        for (let name of staticProps) {
-            output[name] = type[name];
-        }
-
-        for (let name of staticMethods) {
-            output[name] = type[name]();
-        }
-
-        for (let name of props) {
-            output[name] = target[name];
-        }
-
-        for (let name of methods) {
-            output[name] = target[name]();
-        }
-
-        return output;
-    }
-
-    static #copyMethod(method) /* verified */ {
-        let passer = [ method ];
-        passer = [ ...passer ];
-        let copy = passer[0];
-
-        return copy;
-    }
-
-    // endregion Internals
-}

package/test-target-objects/MixedContents.js

@@ -1,33 +0,0 @@
-/**/
-
-export default class MixedContents {
-    first = 1;
-    second = "2";
-    third = { three: 3 };
-    
-    static fourth = 4;
-    static fifth = "5";
-    
-    getInstanceValueOf(name) {
-        return this[name];
-    }
-    
-    getInstanceProduct() {
-        let a = this.first;
-        let b = Number(this.second);
-        let c = this.third.three;
-
-        return a * b * c;
-    }
-    
-    static getStaticValueOf(name) {
-        return MixedContents[name];
-    }
-    
-    static getStaticProduct() {
-        let a = MixedContents.fourth;
-        let b = Number(MixedContents.fifth);
-
-        return a * b;
-    }
-}

package/test-target-objects/MutationTarget.js

@@ -1,37 +0,0 @@
-/**/
-
-export default class MutationTarget {
-    #map;
-    #array;
-
-    constructor(map, array) {
-        this.#map = map;
-        this.#array = array;
-    }
-
-    mutateInitors() {
-        // Map mutation allows for consecutive mutations.
-        let rawKey = this.#map.size + 1;
-        this.#map.set(rawKey.toString(), "C");
-        this.#array.shift();
-        
-        return { map: this.#map, array: this.#array };
-    }
-
-    mutateArgs(array, tuple) {
-        array.push(10);
-        tuple.changes += 10;
-        
-        return { array, tuple };
-    }
-    
-    replaceArg(array, index, replacement) {
-        // The previous element is added at the end for comparison.
-        array.push(array[index].toString());
-
-        // The new element is set at the original index.
-        array[index] = replacement;
-
-        return array;
-    }
-}

package/test-target-objects/ObjectComposer.js

@@ -1,34 +0,0 @@
-/**/
-
-export default class ObjectComposer {
-    constructor() {
-        /* No operations. */
-    }
-    
-    /* Target of spoofing. */
-    supplySomeObject() {
-        throw new Error("supplyObjectA() must be spoofed in tests.");
-    }
-    
-    enact(chain, method) {
-        // Invoke the method to be spoofed.
-        let target = this.supplySomeObject();
-        
-        // Traverse the spoofed return 
-        // value's object tree.
-        for (let link of chain) {
-            target = target[link];
-        }
-        
-        // Invoke the method at chain end for its return value.
-        let output = target[method]();
-        return output;
-    }
-    
-    doubleEnact(chainOne, methodOne, chainTwo, methodTwo) {
-        let outputOne = this.enact(chainOne, methodOne);
-        let outputTwo = this.enact(chainTwo, methodTwo);
-        
-        return [ outputOne, outputTwo ];
-    }
-}

package/test-target-objects/PolySpoofableInner.js

@@ -1,29 +0,0 @@
-/**/
-
-export default class PolySpoofableInner {
-    constructor() {
-        /* No operations. */
-    }
-    
-    /* Spoofing target. */
-    addOrTimes(numbers) {
-        let a = numbers.supplyA();
-        let b = numbers.supplyB();
-        
-        return a + b;
-    }
-    
-    /* Spoofing target. */
-    minusOrOver(numbers) {
-        let a = numbers.supplyA();
-        let b = numbers.supplyB();
-    
-        return a - b;
-    }
-
-    /* Spoofing target.  Nested object. */
-    numberHost = { 
-        supplyC: () => { return 15; }, 
-        supplyD: () => { return 18; } 
-    }
-}

package/test-target-objects/PolySpoofableOuter.js

@@ -1,52 +0,0 @@
-/**/
-
-import PolySpoofableInner from "./PolySpoofableInner.js";
-
-export default class PolySpoofableOuter {
-    /* Spoofing target. */
-    #inner;
-
-    constructor() {
-        this.#inner = new PolySpoofableInner();
-    }
-    
-    /* Not intended to be spoofed, but to use spoofs. */
-    combinedNumbers(numbers) {
-        let first = this.#inner.addOrTimes(numbers);
-        let second = this.#inner.minusOrOver(numbers);
-        
-        let combined = this.combiner(first, second);
-        return combined;
-    }
-    
-    /* Spoofing target. */
-    combiner(first, second) {
-        let combined = Math.pow(first, second);
-        return combined;
-    }
-    
-    /* Not intended to be spoofed, but to use spoofs. */
-    combinedPlusHosted(numbers) {
-        let combined = this.combinedNumbers(numbers);
-        let third = this.#inner.numberHost.supplyC();
-        let fourth = this.#inner.numberHost.supplyD();
-        
-        return combined + third - fourth;
-    }
-    
-    /* Not intended to be spoofed, but to use arg with spoofs. */
-    combinedArgAAndB(inner) {
-        let first = inner.supplyA();
-        let second = inner.supplyB();
-        
-        return first + second;
-    }
-    
-    /* Not intended to be spoofed, but to use arg with spoofs. */
-    combinedArgHostedCAndD(inner) {
-        let third = inner.numberHost.supplyC();
-        let fourth = inner.numberHost.supplyD();
-        
-        return third - fourth;
-    }
-}