risei 1.0.3 → 1.1.0

package/public/javascript/TerminalReporter.js

@@ -1,222 +1,249 @@
-/**/
-
-/* TerminalReporter is an ATestReporter that sends each result to the terminal / console for display. */
-
-import { ATestReporter } from "./ATestReporter.js";
-import { TestGroup } from "./TestGroup.js";
-import { ClassTestGroup } from "./ClassTestGroup.js";
-import { MethodTestGroup } from "./MethodTestGroup.js";
-import { TestResult } from "./TestResult.js";
-import { TestSummary } from "./TestSummary.js";
-
-import chalk from "chalk";
-
-export class TerminalReporter extends ATestReporter {
-    // region Private fields
-
-    /* Foreground-colors using dependency calls and hex. */
-    #trueWhite = chalk.hex("FFFFFF");
-    #trueBlack = chalk.hex("000000");
-
-    /* Background colors as hex for dependency 
-       calls to use, needed syntactically. */
-    #blue = "0000CD";
-    #aqua = "00BFFF";
-    #paleGreen = "90EE90";
-    #paleRed = "F08080";
-
-    /* Full fore- and background color output styles. */
-
-    #classGroup = this.#trueWhite.bgHex(this.#blue).bold;
-    #methodGroup = this.#trueWhite.bgHex(this.#aqua).bold;
-    #passed = this.#trueBlack.bgHex(this.#paleGreen);
-    #failed = this.#trueBlack.bgHex(this.#paleRed);
-    #passedSummary = this.#trueBlack.bgHex(this.#paleGreen).bold;
-    #failedSummary = this.#trueBlack.bgHex(this.#paleRed).bold;
-    #summary = chalk.hex("000080").bgHex("FAFAD2").bold;
-
-    // Count of characters used for indent 
-    // and text to the left of each test.
-    #preUsedWidth = 20;
-
-    // endregion PrivateFields
-
-    // region ATestReporter
-
-    reportNext(result) {
-        // The next result introduces a group of tests.
-        if (result instanceof TestGroup) {
-            this.reportGroup(result);
-            return;
-        }
-
-        // The next result is from one test.
-        if (result instanceof TestResult) {
-            this.#reportTestResult(result);
-            return;
-        }
-
-        // The next result is the summary of all tests.
-        if (result instanceof TestSummary) {
-            this.reportSummary(result);
-            return;
-        }
-    }
-
-    reportGroup(result) {
-        if (result instanceof ClassTestGroup) {
-            console.log(this.#classGroup(` ${ result.group }: `));
-        }
-
-        if (result instanceof MethodTestGroup) {
-            console.log("   " + this.#methodGroup(` ${ result.group }(): `));
-        }
-    }
-
-    // region Private dependencies of reportNext()
-
-    #reportTestResult(result) {
-        if (result.didPass) {
-            this.reportPassed(result);
-        }
-
-        if (!result.didPass) {
-            this.reportFailed(result);
-        }
-    }
-
-    // endregion Private dependencies of reportNext()
-
-    reportPassed(result) {
-        this.#reportOneTestResult(result, "Passed", this.#passed);
-    }
-
-    reportFailed(result) {
-        this.#reportOneTestResult(result, "Failed", this.#failed);
-    }
-
-    // region Private dependencies of reportPassed() and reportFailed()
-
-    /* cruft, changes here */
-    #reportOneTestResult(result, net, styler) {
-        let { lineOne, lineTwo, lineThree } = this.#calculateResultDisplay(result);
-
-        console.log(
-            "\t" + styler(` ${ net }:  ${ lineOne }`)
-        );
-
-        if (lineTwo) {
-            console.log(
-                "\t\t  " + styler(` ${ lineTwo }`)
-            );
-        }
-
-        if (lineThree) {
-            console.log(
-                "\t\t  " + styler(` ${ lineThree }`)
-            );
-        }
-    }
-    
-    /* &cruft, changes here and/or factoring 
-       to lengths and tactics branching */
-    #calculateResultDisplay(result) {
-        /* Getting lengths to determine if output should 
-         * be split to multiple lines to fit the window. */
-
-        let forInputsLength
-            = this.#preUsedWidth
-            + result.identityText.length
-            + result.inputsText.length;
-
-        let allLength
-            = forInputsLength
-            + result.expectedText.length
-            + result.actualText.length;
-
-        /* Splitting as much as is needed. */
-        
-        let identityText = result.identityText;
-        let inputsText = result.inputsText;
-        let expectedText = result.expectedText;
-        let actualText = result.actualText;
-
-        if (forInputsLength >= process.stdout.columns) {
-            return this.#threeLineTactic(identityText, inputsText, expectedText, actualText);
-        }
-
-        if (allLength >= process.stdout.columns) {
-            return this.#twoLineTactic(identityText, inputsText, expectedText, actualText);
-        }
-
-        return this.#oneLineTactic(identityText, inputsText, expectedText, actualText);
-    }
-
-    // region Private dependencies of #calculateResultDisplay()
-
-    #threeLineTactic(identityText, inputsText, expectedText, actualText) {
-        // Each line, with two spaces between phrases on same line.
-        let lineOne = identityText;
-        let lineTwo = inputsText;
-        let lineThree = expectedText + " " + actualText;
-
-        return { lineOne, lineTwo, lineThree };
-    }
-
-    #twoLineTactic(identityText, inputsText, expectedText, actualText) {
-        // Each line, with two spaces between phrases on same line.
-        let lineOne = identityText + " " + inputsText;
-        let lineTwo = expectedText + " " + actualText;
-
-        // Left undefined.
-        let lineThree;
-
-        return { lineOne, lineTwo, lineThree };
-    }
-
-    #oneLineTactic(identityText, inputsText, expectedText, actualText) {
-        // Single line, with two spaces between all phrases.
-        let lineOne
-            = identityText
-            + " "
-            + inputsText
-            + " "
-            + expectedText
-            + " "
-            + actualText;
-
-        // Left undefined.
-        let lineTwo, lineThree;
-
-        return { lineOne, lineTwo, lineThree };
-    }
-
-    // endregion Private dependencies of #calculateResultDisplay()
-
-    // endregion Private dependencies of reportPassed() and reportFailed()
-
-    reportSummary(summary) {
-        console.log();
-
-        if (summary.anyWereRun) {
-            if (summary.allDidPass) {
-                console.log(this.#passedSummary(this.#toFullWidth(" Test run succeeded.")));
-            }
-            else {
-                console.log(this.#failedSummary(this.#toFullWidth(" Test run failed.")));
-            }
-        }
-
-        console.log(this.#summary(this.#toFullWidth(` ${ summary.summary }`)));
-    }
-
-    #toFullWidth(text) {
-        text = text || "";
-        let width = process.stdout.columns;
-
-        return text.padEnd(width, "\u00A0");
-    }
-
-    // endregion ATestReporter
-
-}
+/**/
+
+/* TerminalReporter is an ATestReporter that sends each result to the terminal / console for display. */
+
+import { ATestReporter } from "./ATestReporter.js";
+import { TestGroup } from "./TestGroup.js";
+import { ClassTestGroup } from "./ClassTestGroup.js";
+import { MethodTestGroup } from "./MethodTestGroup.js";
+import { TestResult } from "./TestResult.js";
+import { TestSummary } from "./TestSummary.js";
+
+import chalk from "chalk";
+
+export class TerminalReporter extends ATestReporter {
+    // region Private fields
+
+    /* Foreground-colors using dependency calls and hex. */
+    #trueWhite = chalk.hex("FFFFFF");
+    #trueBlack = chalk.hex("000000");
+
+    /* Background colors as hex for dependency 
+       calls to use, needed syntactically. */
+    #blue = "0000CD";
+    #aqua = "00BFFF";
+    #paleGreen = "90EE90";
+    #paleRed = "F08080";
+
+    /* Full fore- and background color output styles. */
+
+    #classGroup = this.#trueWhite.bgHex(this.#blue).bold;
+    #methodGroup = this.#trueWhite.bgHex(this.#aqua).bold;
+    #passed = this.#trueBlack.bgHex(this.#paleGreen);
+    #failed = this.#trueBlack.bgHex(this.#paleRed);
+    #passedSummary = this.#trueBlack.bgHex(this.#paleGreen).bold;
+    #failedSummary = this.#trueBlack.bgHex(this.#paleRed).bold;
+    #summary = chalk.hex("000080").bgHex("FAFAD2").bold;
+
+    // Count of characters used for indent 
+    // and text to the left of each test.
+    #preUsedWidth = 20;
+
+    // endregion PrivateFields
+
+    // region ATestReporter
+
+    reportNext(result) {
+        // The next result introduces a group of tests.
+        if (result instanceof TestGroup) {
+            this.reportGroup(result);
+            return;
+        }
+
+        // The next result is from one test.
+        if (result instanceof TestResult) {
+            this.#reportTestResult(result);
+            return;
+        }
+
+        // The next result is the summary of all tests.
+        if (result instanceof TestSummary) {
+            this.reportSummary(result);
+            return;
+        }
+    }
+
+    reportGroup(result) {
+        if (result instanceof ClassTestGroup) {
+            console.log(this.#classGroup(` ${ result.group }: `));
+        }
+
+        if (result instanceof MethodTestGroup) {
+            console.log("   " + this.#methodGroup(` ${ result.group }(): `));
+        }
+    }
+
+    // region Private dependencies of reportNext()
+
+    #reportTestResult(result) {
+        if (result.didPass) {
+            this.reportPassed(result);
+        }
+
+        if (!result.didPass) {
+            this.reportFailed(result);
+        }
+    }
+
+    // endregion Private dependencies of reportNext()
+
+    reportPassed(result) {
+        this.#reportOneTestResult(result, "Passed", this.#passed);
+    }
+
+    reportFailed(result) {
+        this.#reportOneTestResult(result, "Failed", this.#failed);
+    }
+
+    // region Private dependencies of reportPassed() and reportFailed()
+
+    /* &cruft, changes here / in dependencies 
+       for better splitting to multiple lines */
+    #reportOneTestResult(result, net, styler) {
+        let { lineOne, lineTwo, lineThree, lineFour } = this.#calculateResultDisplay(result);
+
+        console.log(
+            "\t" + styler(` ${ net }:  ${ lineOne }`)
+        );
+
+        if (lineTwo) {
+            console.log(
+                "\t\t  " + styler(` ${ lineTwo }`)
+            );
+        }
+
+        if (lineThree) {
+            console.log(
+                "\t\t  " + styler(` ${ lineThree }`)
+            );
+        }
+        
+        if (lineFour) {
+            console.log(
+                "\t\t  " + styler(` ${ lineFour }`)
+            );
+        }
+    }
+    
+    #calculateResultDisplay(result) {
+        /* Getting lengths to determine if output should 
+         * be split to multiple lines to fit the window. */
+
+        let forInputsLength
+            = this.#preUsedWidth
+            + result.identityText.length
+            + result.inputsText.length;
+
+        let allLength
+            = forInputsLength
+            + result.expectedText.length
+            + result.actualText.length;
+        
+        let forOutputsLength 
+            = this.#preUsedWidth
+            + result.expectedText.length
+            + result.actualText.length;
+
+        /* Splitting as much as is needed. */
+        
+        let identityText = result.identityText;
+        let inputsText = result.inputsText;
+        let expectedText = result.expectedText;
+        let actualText = result.actualText;
+
+        if (forOutputsLength >= process.stdout.columns) {
+            return this.#fourLineTactic(identityText, inputsText, expectedText, actualText);
+        }
+
+        if (forInputsLength >= process.stdout.columns) {
+            return this.#threeLineTactic(identityText, inputsText, expectedText, actualText);
+        }
+
+        if (allLength >= process.stdout.columns) {
+            return this.#twoLineTactic(identityText, inputsText, expectedText, actualText);
+        }
+
+        return this.#oneLineTactic(identityText, inputsText, expectedText, actualText);
+    }
+
+    // region Private dependencies of #calculateResultDisplay()
+
+    #fourLineTactic(identityText, inputsText, expectedText, actualText) {
+        // Each line on its own.
+        let lineOne = identityText;
+        let lineTwo = inputsText;
+        let lineThree = expectedText;
+        let lineFour = actualText;
+        
+        return { lineOne, lineTwo, lineThree, lineFour };
+    }
+
+    #threeLineTactic(identityText, inputsText, expectedText, actualText) {
+        // Each line, with two spaces between phrases on same line.
+        let lineOne = identityText;
+        let lineTwo = inputsText;
+        let lineThree = expectedText + " " + actualText;
+
+        // Left undefined.
+        let lineFour;
+
+        return { lineOne, lineTwo, lineThree, lineFour };
+    }
+
+    #twoLineTactic(identityText, inputsText, expectedText, actualText) {
+        // Each line, with two spaces between phrases on same line.
+        let lineOne = identityText + " " + inputsText;
+        let lineTwo = expectedText + " " + actualText;
+
+        // Left undefined.
+        let lineThree, lineFour;
+
+        return { lineOne, lineTwo, lineThree, lineFour };
+    }
+
+    #oneLineTactic(identityText, inputsText, expectedText, actualText) {
+        // Single line, with two spaces between all phrases.
+        let lineOne
+            = identityText
+            + " "
+            + inputsText
+            + " "
+            + expectedText
+            + " "
+            + actualText;
+
+        // Left undefined.
+        let lineTwo, lineThree, lineFour;
+
+        return { lineOne, lineTwo, lineThree, lineFour };
+    }
+
+    // endregion Private dependencies of #calculateResultDisplay()
+
+    // endregion Private dependencies of reportPassed() and reportFailed()
+
+    reportSummary(summary) {
+        console.log();
+
+        if (summary.anyWereRun) {
+            if (summary.allDidPass) {
+                console.log(this.#passedSummary(this.#toFullWidth(" Test run succeeded.")));
+            }
+            else {
+                console.log(this.#failedSummary(this.#toFullWidth(" Test run failed.")));
+            }
+        }
+
+        console.log(this.#summary(this.#toFullWidth(` ${ summary.summary }`)));
+    }
+
+    #toFullWidth(text) {
+        text = text || "";
+        let width = process.stdout.columns;
+
+        return text.padEnd(width, "\u00A0");
+    }
+
+    // endregion ATestReporter
+
+}

package/public/javascript/TestFrameChooser.js

@@ -0,0 +1,95 @@
+/**/
+
+export class TestFrameChooser {
+    // Used for special test cases.
+    constructorName = "constructor";
+    staticName = "static";
+    throwName = "throw";
+    
+    frames;
+    
+    constructor(frameSource) /* verified */ {
+        this.frames = frameSource;
+    }
+
+    supplyTestFrame(test) /* passed */ {
+        // If `.and` includes "static", a call of a static member 
+        // is made, and the actual is its return value.
+        if (this.doesAddressStatics(test)) {
+            if (this.isThrowTest(test)) {
+                return this.frames.testThrowResultAfterStaticCall;
+            }
+        
+            // If .from, a static call is made, then the actual is 
+            // retrieved from a named code element or custom code.
+            if (this.isRetrievalTest(test)) {
+                return this.frames.testCodeElementAfterStaticCall;
+            }
+
+            // Otherwise, the return value 
+            // of the static call is used.
+            return this.frames.testReturnValueOfStaticCall;
+        }
+
+        // Constructors are a special case; no second call should 
+        // be made, and actual must be retrieved from property.
+        if (test.of === this.constructorName) {
+            return this.frames.testCodeElementAfterConstruction;
+        }
+        
+        if (this.isThrowTest(test)) {
+            return this.frames.testThrowResultAfterCall;
+        }
+
+        // If .from, a call of the target is made, then the actual 
+        // is retrieved from a named code element or custom code.
+        if (this.isRetrievalTest(test)) {
+            return this.frames.testCodeElementAfterCall;
+        }
+
+        // The most common case: the target is called, 
+        // and the actual is its return value.
+        return this.frames.testReturnValueOfCall;
+    }
+
+    doesAddressStatics(test) /* passed */ {
+        if (typeof test.and === "string") {
+            if (test.and.includes(this.staticName)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+    
+    isThrowTest(test) /* passed */ {
+        if (typeof test.and === "string") {
+            if (test.and.includes(this.throwName)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    isRetrievalTest(test) /* passed */ {
+        // Falsy code elements never are a retrieval.
+        if (!test.from) {
+            return false;
+        }
+        
+        // If a (non-falsy) string, must be a retrieval.
+        if (typeof test.from === "string") {
+            return true;
+        }
+        
+        // If a function, is a retrieval.
+        if (test.from instanceof Function) {
+            return true;
+        }
+        
+        // Anything else is not a retrieval.
+        return false;
+    }
+
+}