risei 1.1.2 → 1.2.0

package/README.md

@@ -8,11 +8,7 @@
 * Refactor or replace existing designs without worrying about the cost in past or future test time.
 * Create tests with immediate confidence, because you can't introduce mistakes in test code you write.
 
-> Risei is under active development.   To see the latest changes, check out [What's new in Risei](#whats-new-in-risei).
-> 
-> For a list of any known bugs and workarounds, see [Known bugs and workarounds](#known-bugs-and-workarounds).   To see which JavaScript features Risei doesn't address yet, check out [Limitations in Risei](#limitations-in-risei).
-
-Risei may be referred to as **Rs** here for brevity.   A dotted `.name` here means a property, just like a `name()` with parens is a method or function.
+Risei may be referred to as **Rs** here for brevity.
 
 
 
@@ -31,9 +27,12 @@ Here is the terminal output of these two example tests.   Tests are grouped
 ![https://deusware.com/Output-example.png](https://deusware.com/Output-example.png)
 
 
-An individual test may appear on one line or multiple lines, depending on how wide the terminal window is.   Any failing tests appear in light red. 
+- An individual test may appear on one line or multiple lines, depending on how wide the terminal window is.
+- Any failing tests appear in light red.
+- Your latest-edited tests always sort to the bottom, so you can see your current test results at a glance.
+
 
-Test runs also feature a title bar, as well as a summary bar at the bottom:
+Test runs also feature a title bar at the top, as well as a summary bar at the bottom:
 
 ![https://deusware.com/Summary-example.png](https://deusware.com/Summary-example.png)
 
@@ -42,6 +41,8 @@ Test runs also feature a title bar, as well as a summary bar at the bottom:
 
 ## Using Risei
 
+Risei is under active development.   If you've been here before, check out [what's new in Risei](#whats-new-in-risei) for the latest.   Also see [known bugs and workarounds](#known-bugs-and-workarounds) and [limitations in Risei](#limitations-in-risei).
+
 ### Installation
 
 Install Risei for development time only:
@@ -160,9 +161,7 @@ Or write a `package.json` script that does the same:
 
 ```json
 "scripts": {
-  ...
-  "test": "node ./node_modules/risei/index.js",
-  ...
+  "test": "node ./node_modules/risei/index.js"
 }
 ```
 
@@ -475,8 +474,7 @@ Most problems with using Risei are minor mistakes in syntax, or omissions in tes
 | `"Test loading failed for...  SyntaxError: Unexpected token ':'"`   | Missing comma in your tests in the named file                                                                                                                                                               |
 | `"Test loading failed for...  SyntaxError: Unexpected token '.'"`   | Using `this.tests = []` instead of `tests = []` in the file named                                                                                                                                           |
 | Other `... Unexpected token ...` errors                             | Some other syntax error in the file named, most likely a missing or extra delimiter                                                                                                                         |
-| Unexpected actual values, or unexpected passes / fails in test runs | Spoofs, retrievals, or special conditions from previous tests not replaced or reset with `[ ]`<br>&mdash; or &mdash;<br>Tested method mutates `.in` or `.with` args: preventable by using a function to supply those args<br>&mdash; or &mdash;<br>Pre-listed test properties produce extra tests: preventable by restating class in `.on` 
-|
+| Unexpected actual values, or unexpected passes / fails in test runs | Spoofs, retrievals, or special conditions from previous tests not replaced or reset with `[ ]`<br>&mdash; or &mdash;<br>Tested method mutates `.in` or `.with` args: preventable by using a function to supply those args<br>&mdash; or &mdash;<br>Pre-listed test properties produce extra tests: preventable by restating class in `.on` |
 
 
 
@@ -507,14 +505,15 @@ One known unexpected result (not quite a bug) exists:
 
 ## What's new in Risei
 
-Release **1.1.2** of Risei (January, 2024) fixes two problems:
-- Classes were sometimes displayed in output as their entire definition, instead of just the class name.
-- All `Date` instances were considered equal, regardless of their actual value.
+- Release **1.2.0** (January, 2024) changes sorting of test files.&nbsp;  Previously they were displayed in the order found.&nbsp;  Now the last-edited file is moved to the bottom, making it easy to see the latest test results.
+
 
-Development of Risei is ongoing, including internal improvements, problem fixes, and additional options for testing.
+- Release **1.1.2** of Risei (January, 2024) fixes two problems:
+  - Classes were sometimes displayed in output as their entire definition.&nbsp;  Now just the class name is displayed.
+  - All `Date` instances were considered equal, regardless of their actual value.&nbsp;  Now they only are considered equal when they actually are.
 
 
-> Do not use release **1.1.1**, because it contains an internal path error.
+> Don't use release **1.1.1**, which contains an internal path error.
 
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "risei",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Risei is the framework that allows you to write unit tests as collections of values in JavaScript objects, so it's easy and fast, and tests don't serve as a drag on redesigns.",
   "keywords": [
     "unit test",
@@ -28,7 +28,8 @@
     "test": "clear; node ./node_modules/risei/index.js"
   },
   "risei": {
-    "tests": "**.rt.js"
+    "tests": "**.rt.js",
+    "sort": "normal"
   },
   "exports": {
     ".": "./index.js",

package/system/Risei.js

@@ -69,7 +69,7 @@ console.log();
 
 // Test-system objects and their relationships.
 const finder = new ChosenTestFinder();
-const runner = new TestRunner(finder.findAllTests());
+const runner = new TestRunner();
 const reporter = new TerminalReporter();
 
 const caller = new LocalCaller(finder, runner, reporter);

package/system/TestFinder.js

@@ -35,12 +35,14 @@ export class TestFinder extends ATestFinder {
         let source = this.sourceBySearch();
         this.#sought = source.tests;
         let testPaths = this.pathsFromTargetingSource();
-        
+
+        testPaths = this.sortTestPaths(testPaths);
+
         let tests = [];
 
         for (let testPath of testPaths) {
             // Contents of test sources have to be loaded.
-            let sources = await this.convertPathToClassInstances(testPath);
+            let sources = await this.convertPathToClassInstances(testPath.path);
             
             // Any test classes in each source have to be loaded.
             for (let source of sources) {
@@ -99,7 +101,9 @@ export class TestFinder extends ATestFinder {
             // This level: any test files.
             if (entry.isFile()) {
                 if (minimatch(entry.path, this.#sought, { matchBase: true })) {
-                    paths.push(entry.path);
+                    // Test file's last-edited time stored with path for some sortings.
+                    let stats = fs.statSync(entry.path);
+                    paths.push({ path: entry.path, changed: stats.mtimeMs });
                 }
             }
             
@@ -110,6 +114,18 @@ export class TestFinder extends ATestFinder {
         }
     }
 
+    sortTestPaths(testPaths) /* passed */ {
+        // Latest is found for placing at end.
+        let latest = testPaths.reduce((prior, now) => { return now.changed > prior.changed ? now : prior; });
+
+        // Copy made with latest removed, which is added at end.
+        let sorted = testPaths.filter(x => x !== latest);
+        sorted.push(latest);
+
+        // Back to caller.
+        return sorted;
+    }
+
     async convertPathToClassInstances(classPath) {
         // Each test source may have multiple test classes.
         let testSources = [];

package/system/TestRunner.js

@@ -259,7 +259,7 @@ export class TestRunner {
             this.#numberFailed++;
         }
 
-        this.#allDidPass &= test.didPass;
+        this.#allDidPass &&= test.didPass;
     }
 
     // endregion Dependencies of runOneTest()