spectus 6.0.0 → 6.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92e8a3d87559a6f4c65aba5de5bb1a4430a97643a575fdf6bfae472089c3d735
-  data.tar.gz: f6e072160332e5f43b49e90030a2ab285f91ce5a3d62787212a795de41e28919
+  metadata.gz: 9f26d85caf30a154e45b9a762ac0e53b447fed54f37485c5f6f75d0900c4d071
+  data.tar.gz: 1f94678946741fd58dde08354927a1a7e6fde7b608fc19f0243a1ba78c1a1b2c
 SHA512:
-  metadata.gz: 538a2ad991c57d8e5c93abc35985a2e0eef3e1dcee66cc80e73e31a7916f7aa33d1fcecfc6d5ed4ecbd2bb54948d5e1f5df25222a27b5a9492518df16c67513f
-  data.tar.gz: 053e1923192a01dd17eb3fd5fe4b34b810d8b2f66891fc74d09d5e4c5d7483604b591f6302a204e2a0d556c4b71c54a4fb1a253818409a897f0070ac7d56c3d4
+  metadata.gz: 89257bafa377028371d0d1c5da31c8ee454fa23012c565efdf29dba5cbb6350ba145b1636b7b96607aab30463d306f1f687274bd7c0db1c2c2440494fbe613c4
+  data.tar.gz: f6955ba82d49192279a172ed5026b40656af8f655d1dad09345423c6c3d7d7ac8f0bad700cf189d39da6642ded47276d01bcf2f37288c4a4074d321f71d2f04b

data/README.md

@@ -62,7 +62,7 @@ A `Spectus::Result` is plain data, frozen: symbols, booleans and frozen strings
 | `negate`        | `true` or `false` |
 | `outcome`       | `:success`, `:warning`, `:info`, `:failure` or `:error` |
 | `description`   | the matcher, as its `to_s` wrote it: `eq 42` |
-| `actual`        | the value the block returned, as its `inspect` wrote it, or the exception it raised, whether the matcher rescued it or not; `nil` when the matcher did not call the block |
+| `actual`        | the value the block returned, as its `inspect` wrote it, or the exception it raised, whether the matcher rescued it or not; `nil` when the matcher did not call the block, or when the block raised an exception Defi does not keep and the matcher rescued it |
 | `error_class`   | the class of the exception that came out of `match?`, or `TypeError` for an answer that was not `true` or `false`; `nil` otherwise |
 | `error_message` | its message |
 | `backtrace`     | its backtrace, when it has one, library frames included: a runner filters by path |
@@ -73,10 +73,14 @@ The texts are read defensively: an `inspect` or a `message` that raises or does
 
 ## Exceptions
 
-`call` raises `ArgumentError` without a block and `TypeError` when the `to_s` of the matcher is not a `String`; the matcher is test code, trusted, and what its `to_s` raises goes through. The block and `match?` run under the policy of Defi: the exceptions a method raises on its own, a `StandardError`, a `ScriptError` (such as `NotImplementedError`), a `SystemStackError` or the `SystemExit` of an `exit`, end in the result (as an error, or as an info for a MAY), while an `Interrupt`, a `SignalException`, a `NoMemoryError`, the exception a `Timeout` uses to end its block and any other subclass of `Exception` go through, whether the block or the matcher raised them. Spectus never sees what a matcher rescues itself: in matchi 5.0, `Matchi::RaiseException` rescues `Exception`, so an `exit` inside its block is not an error.
+`call` raises `ArgumentError` without a block and `TypeError` when the `to_s` of the matcher is not a `String`; the matcher is test code, trusted, and what its `to_s` raises goes through. The block and `match?` run under the policy of Defi: the exceptions a method raises on its own, a `StandardError`, a `ScriptError` (such as `NotImplementedError`), a `SystemStackError` or the `SystemExit` of an `exit`, end in the result (as an error, or as an info for a MAY), while an `Interrupt`, a `SignalException`, a `NoMemoryError`, the exception a `Timeout` uses to end its block and any other subclass of `Exception` go through, whether the block or the matcher raised them. Spectus never sees what a matcher rescues itself: `Matchi::RaiseException` rescues a `SystemExit`, so an `exit` inside its block is a failed match, not an error, and `Matchi::RaiseException.new(Interrupt)` rescues an `Interrupt`, a success without an actual value.
 
 The block runs inside `match?`, as many times as the matcher calls it, and without arguments: a lambda that expects some raises `ArgumentError`, which ends in the result. `actual` is the block's last value. The exception it raises is raised again inside the matcher, the same object with its own cause, as Defi does it.
 
+## Changes in 6.0.1
+
+- Documentation: `actual` is also `nil` when the block raised an exception Defi does not keep and the matcher rescued it, as `Matchi::RaiseException.new(Interrupt)` does; what `Matchi::RaiseException` rescues is described as of matchi 6.0.
+
 ## Changes in 6.0
 
 Compared with 5.0.2:

data/lib/spectus/result.rb

@@ -19,7 +19,8 @@ module Spectus
   #   @return [String, nil] the value the block produced, as its `inspect`
   #     wrote it, or the exception it raised (which is also the error when
   #     the matcher let it through); `nil` when the matcher did not call the
-  #     block
+  #     block, or the block raised an exception Defi does not keep and the
+  #     matcher rescued it
   # @!attribute [r] error_class
   #   @return [String, nil] the class of the exception that came out of
   #     `match?`, or `TypeError` for an answer that was not true or false

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spectus
 version: !ruby/object:Gem::Version
-  version: 6.0.0
+  version: 6.0.1
 platform: ruby
 authors:
 - Cyril Kato
@@ -41,7 +41,7 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/fixrb/spectus/issues
-  changelog_uri: https://github.com/fixrb/spectus#changes-in-60
+  changelog_uri: https://github.com/fixrb/spectus#changes-in-601
   documentation_uri: https://rubydoc.info/gems/spectus
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/fixrb/spectus