risei 3.3.1 → 3.3.3

package/README.md

@@ -3,12 +3,12 @@
 
 ## Overview
 
-Risei is a new way to write unit tests that's easier and faster, more dependable, and keeps your tests from standing in the way of redesigns.
+Risei is a new way to write unit tests that's easier, faster, and more readable.   Tests made with Risei aren't a source of errors or a drag on redesigns.
 
 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.
@@ -40,15 +40,15 @@ And they have a summary bar at the bottom:
 
 ![https://deusware.com/risei/images/Summary-example.png](https://deusware.com/risei/images/Summary-example.png)
 
-- This bar is red when any tests fail, much as you'd expect.
+- This bar is red when any tests fail, just as you'd expect.
 
 
 
 ## Status
 
-Risei's major features are now complete, but new enhancements or fixes may appear from time to time.   The latest release, **3.3.1**, fixes an edge case with addressing properties.
+Risei's major features are now complete, but new enhancements or fixes may appear from time to time.
 
-Check out the [full list of changes](#version-history).
+The latest release, **3.3.3**, adds `async` capabilities to poly-testing, the last place they were missing.
 
 
 
@@ -121,7 +121,8 @@ 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.**
+  - 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.
 
@@ -216,51 +217,6 @@ If errors are thrown while testing, gold bars listing them appear at the bottom,
 
 
 
-## Version history
-
-- 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.
-
-
-- Release **3.2.0** (January, 2025) contains all the changes from **3.1.1** and **3.1.0**, plus this change:
-  - Risei's self-dependency for its own self-testing has been moved back to the development-only scope.
-
-
-- Release **3.1.1** (January, 2025) contains these changes:
-  - Extra commas and non-objects in arrays of test objects are disregarded, and no longer cause a throw.
-  - Throws in wider scopes are now listed at the end, like others already found there.
-
-
-- Release **3.1.0** (January, 2025) contains these changes:
-  - Accessor properties (formally _accessor descriptors_) are now compared for test results and displayed in test outputs.
-    - Any accessor properties that throw errors during display are displayed as `(threw)`.
-  - Throws in tested code and in test framing code are now listed at the end, and also displayed amid the tests.
-  - `File` objects now have a succinct custom display in outputs.
-  - **(Breaking change)**&nbsp;  In `constructor` tests, constructed instances are available in `.from` functions only as `actual` / `test.actual`.
-    - **(Breaking change)**&nbsp;  In `constructor` tests, `test.target` is now the `prototype` of the tested class.
-  - Widespread internal reengineering of other kinds.
-
-
-> Older releases are dropped from this list progressively over time.&nbsp;  Using the latest release is recommended.
-
-</details>
-
-
-
 ## Known issues and workarounds
 
 There are the known minor issues:
@@ -270,10 +226,10 @@ There are the known minor issues:
 
 
 - Spoofing accessor properties only works when they have both a getter and a setter.
-  - The workaround is to find another way to produce the property values you need.
+  - There is no specific workaround for this, but you may look for other ways 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.
+- Custom versions of JavaScript methods like `toString()` may not be recognized, nor any instance methods with the same names as static methods.
   - The workaround is to use an `.and` value of `"instance"` for any methods like these that you test.
 
 
@@ -285,7 +241,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.1",
+  "version": "3.3.3",
   "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.3.0"
+    "risei": "^3.3.2"
   }
 }

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