risei 3.3.0 → 3.3.2

package/README.md

@@ -8,7 +8,7 @@ Risei is a new way to write unit tests that's easier and faster, more dependable
 Risei does all this by replacing hand-coded tests with simple declarative syntax.
 
 - Risei has many convenient and time-saving [features](#features-of-risei).
-- Risei works with object-oriented JavaScript in modules.
+- Risei works with class-based JavaScript in modules.
 - Risei works with TypeScript after just a few [tweaks](https://deusware.com/risei/index.html#typescript-with-risei).
 
 You can find a longer version of this read-me at [https://deusware.com/risei](https://deusware.com/risei/index.html).   It expands greatly on the information here.
@@ -46,7 +46,8 @@ And they have a summary bar at the bottom:
 
 ## Status
 
-Risei's major features are now complete, but new enhancements or fixes may appear from time to time.   The latest release, **3.3.0**, brings further significant improvements and bug fixes on top of the major improvements in other recent releases.
+Risei's major features are now complete, but new enhancements or fixes may appear from time to time. \
+The latest release, **3.3.2**, adds `async` capabilities formerly missing from the `.from` feature.
 
 Check out the [full list of changes](#version-history).
 
@@ -91,33 +92,9 @@ And add Risei's metadata to `package.json`:
 }
 ```
 
-## Testing Risei
-
-To test Risei, you clone it from a parallel [repository](https://gitlab.com/riseimaker/risei-public.git), install its dependencies, and run its self-tests.   See the full explanation [here](https://deusware.com/risei/index.html#self-testing).
-
-
-## Running Tests
-
-Once you have some tests written, you can run them manually:
-
-```bash
-node ./node_modules/risei/index.js
-```
-
-Or write a script in `package.json` that does the same:
-
-```json
-"scripts": {
-  "test": "node ./node_modules/risei/index.js"
-}
-```
-
-And then run that script:
-
-```bash
-npm test
-```
+## Testing Risei Itself
 
+To test Risei itself, you clone it from a parallel [repository](https://gitlab.com/riseimaker/risei-public.git), install its dependencies, and run its self-tests.   See the full explanation [here](https://deusware.com/risei/index.html#self-testing).
 
 
 ## Writing Tests
@@ -145,14 +122,38 @@ tests = [ ...
 ... ];
 ```
 
-- Asynchronous code with `async` and `await` keywords can tested with no changes at all to this syntax.
+- **Asynchronous / awaitable code can tested with no changes at all to this syntax.**
+  - And you use `async` and `await` normally if you define functions within tests.
 - Use empty arrays for `.in` or `.with` when there are no args to pass.
 - You can use [long names](https://deusware.com/risei/index.html#long-names) for properties if you want.
 
 
+## Running Tests
+
+Once you have some tests written, you can run them manually:
+
+```bash
+node ./node_modules/risei/index.js
+```
+
+Or write a script in `package.json` that does the same:
+
+```json
+"scripts": {
+  "test": "node ./node_modules/risei/index.js"
+}
+```
+
+And then run that script:
+
+```bash
+npm test
+```
+
+
 ## Basic collapsing forward example
 
-You can state test properties once and let them _collapse forward_ across subsequent tests to save time and make tests easier to read.
+You can state repeated test properties just once, and let them _collapse forward_ across subsequent tests to save time and make tests easier to read.
 
 Risei collapses values together from partial or full test objects until it has a full test to run.   Every property collapses forward until it is changed or wiped out:
 
@@ -219,10 +220,25 @@ If errors are thrown while testing, gold bars listing them appear at the bottom,
 
 ## Version history
 
+- Release **3.3.2** (September, 2025) contains this change:
+  - You can now use asynchronous / awaitable code in `.from` using `async` and `await` normally.
+    - You already could use awaitable code with the normal syntax in `.plus`, `.do`, and `.undo`.
+
+
+- Release **3.3.1** (February, 2025) contains this change:
+  - You can now spoof and otherwise address value properties (formally _data descriptors_) that don't have an initial value, whether they are static or instance class members.
+
+
 - Release **3.3.0** (January, 2025) adds this change to those of other recent releases:
   - You can now test instance members with the same names as static members using a new `.and` option of `"instance"`.
 
 
+
+<details>
+<summary>
+Older releases
+</summary>
+
 - Release **3.2.1** (January, 2025) contains all the changes from **3.2.0**, **3.1.1**, and **3.1.0**, plus this change:
   - Risei's mistaken nominal dependency on **npm** has been removed.
 
@@ -246,34 +262,6 @@ If errors are thrown while testing, gold bars listing them appear at the bottom,
   - Widespread internal reengineering of other kinds.
 
 
-
-<details>
-<summary>
-Older releases
-</summary>
-
-- Release **3.0.0** (August, 2024) contained all of these changes:
-  - Asynchronous code with `async` syntax is now supported, with no special test syntax.
-  - **(Breaking change)**&nbsp;  `.from` functions now take `test` and `actual` as parameters, rather than `target` and `test`.
-    - If you need to work with the target of the test (usually an instance of the class being tested), it's available as `test.target`.
-  - You can now call target code more than once in one test using an `.and` of `"poly"` (AKA _poly-calling_).
-
-
-- Release **2.0.0** / **2.0.1** (August, 2024) contained all of these changes:
-  - Risei now can determine automatically if tested methods are static.
-  - You can now directly test properties just like methods.
-    - Risei can also determine automatically if these are static.
-    - Directly tested properties appear in the output in the form `.name`.
-  - You can now spoof properties on the targeted class instance, and static properties on the target class itself.
-  - You can now perform arbitrary operations, if needed, with the two-part `.do` property and one-part `.undo` property.
-  - You can now change test properties without accidentally creating a new test using `.just`.
-  - You can now directly test for `undefined` in `.out` using `this.undef` / `ATestSource.undefSymbol`.
-  - `Error` objects are now compared accurately.
-  - You can now identify member types with `.`, `:`, and `()` in any of `.of`, `.plus`, and `.from`, though it isn't necessary.
-  - **(Breaking change)**&nbsp;  The actual for throw tests is now the entire thrown object (usually an `Error`), rather than the `Error`'s message text.
-  - **(Breaking change)**&nbsp;  `ATestSource` is now a default export, changing its imports from `import { ATestSource } from` to `import ATestSource from`.
-  - Major internal re-engineering.
-
 > Older releases are dropped from this list progressively over time.&nbsp;  Using the latest release is recommended.
 
 </details>
@@ -282,7 +270,7 @@ Older releases
 
 ## Known issues and workarounds
 
-There are two minor issues:
+There are the known minor issues:
 
 - If args for a test are mutated by tested code, the mutated args are used when collapsing forward.
   - The workaround is just to restate those args for each test.
@@ -292,6 +280,10 @@ There are two minor issues:
   - The workaround is to find another way to produce the property values you need.
 
 
+- Predefined JavaScript methods like `toString()` may not be recognized, nor any instance method that has the same name as a static method.
+  - The workaround is to use an `.and` value of `"instance"` for any methods like these that you test.
+
+
 
 ## Exclusions from Risei
 
@@ -300,7 +292,7 @@ At present, there are a few things Risei doesn't support.&nbsp;  Some of these m
 - You can see the whole list [here](https://deusware.com/risei/index.html#exclusions-from-risei).
 
 
-Risei can be run alongside other test frameworks, so if you can't test all of your code with Risei, you can still save a lot of time by using Risei to test the bulk of it.
+You can save a lot of time by using Risei for most of your code, but another framework for whatever it doesn't support.
 
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "risei",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "Risei allows you to write unit tests as simple JavaScript objects, so it's easy and fast, with no drag on redesign.",
   "keywords": [
     "unit test",
@@ -15,6 +15,10 @@
     "objects",
     "declarative",
     "javascript",
+    "class",
+    "modules",
+    "object-oriented",
+    "object oriented",
     "typescript"
   ],
   "author": "Ed Fallin <riseimaker@gmail.com>",
@@ -50,6 +54,6 @@
     "fs": "^0.0.1-security",
     "mocha": "^10.0.0",
     "morgan": "~1.9.1",
-    "risei": "^3.2.1"
+    "risei": "^3.3.1"
   }
 }

package/system/MethodSpoofer.js

@@ -80,7 +80,7 @@ export default class MethodSpoofer extends ASpoofingFixture {
         // Map of Maps: by type, then by method.
         for (let def of spoofDefs) {
             let spoofsByTarget = this.#supplyMemberMap(this.#spoofsByClass, def.target);
-            
+
             // A single-method spoof is set for later use.
             if (def.method) {
                 spoofsByTarget.set(def.method, def.output);
@@ -104,7 +104,7 @@ export default class MethodSpoofer extends ASpoofingFixture {
             
             // Saving originals in the Map for later.
             for (let name of names) {
-                let original = TypeAnalyzer.isInstanceMember(type, name)
+               let original = TypeAnalyzer.isInstanceMember(type, name)
                     ? type.prototype[name]
                     : type[name];
 

package/system/PropertySpoofer.js

@@ -78,7 +78,7 @@ export default class PropertySpoofer extends ASpoofingFixture {
         // Stripping spoofs of any sigils.
         propertySpoofs.forEach(x => x.method = NameAnalyzer.plainNameOf(x.method));
 
-        // Storing new values for setting.
+        // Storing spoofing definitions.
         this.#settables = propertySpoofs;
 
         // Storing original values for restoring later.

package/system/SpoofDef.js

@@ -42,29 +42,17 @@ export default class SpoofDef {
 
     /* These short names make JSON-like definitions easier. */
 
-    get on() {
-        return this.target;
-    }
+    get on() { return this.target; }
 
-    set on(value) {
-        this.target = value;
-    }
+    set on(value) { this.target = value; }
 
-    get of() {
-        return this.method;
-    }
+    get of() { return this.method; }
 
-    set of(value) {
-        this.method = value;
-    }
+    set of(value) { this.method = value; }
 
-    get as() {
-        return this.output;
-    }
+    get as() { return this.output; }
 
-    set as(value) {
-        this.output = value;
-    }
+    set as(value) { this.output = value; }
 
     // endregion Spoof definition, short names