statecraft 0.7.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b91fc7675cab350149a2e58679893b18ccdfa779cc84e2eb5a7d28c5591c265c
-  data.tar.gz: c751611f88af3a85738877185b68de734578a353818aa130c19206d40b498b82
+  metadata.gz: 70f23cb88e677af1d36d2acf31fc39a1688f90a46c99d6eebef3e76c49ca4f8e
+  data.tar.gz: f38e777eed1a3fa3109da01a9f56eeb09f8c181c9d13e899ab33e3334c372d8b
 SHA512:
-  metadata.gz: 42c744386532cf91f06374dc3695c4e2ee3e64602fbb428045e3b588c27dc32843959552dea944be5d98834f28036baf1d712da2c25008dba8b16766ca23310b
-  data.tar.gz: 86822e6c1fba14b00e6a8e18efc586a7f92f35280490a168e4d96d063a6d3ecd471eac6fe877c512b9972359d1d14f4d344521dc6f0fea56235075df2bae975b
+  metadata.gz: 636c11b89dabc3d977f13d503ea7cc311c59dd4c677bfea917b333de36f37c045b1b1ddfec2a1f4643131c0f160dad33651ebf4371c32a365783b8e4c7f1df5f
+  data.tar.gz: e09b76e0ca7552f014259429ee4f16ce5ee64b75f4cd829dbffa391ec0604901ba2d9b5a23dd3375bc79f95dc3abe4ca4a77c483634de0343ed2601694bde538

data/README.md

@@ -373,6 +373,20 @@ not with the block matcher.
 it names record-layer guards only. An input-reading `guard:` has no name
 there, and the failure message says so instead of guessing.
 
+Under [`versioning:`](#stale-transitions-versioning-against-aba) the block
+matcher folds the version into the same assertion — a matching transition
+must also have incremented the version column — and every failure message
+prints the record's standing with its version
+(`Order in state :pending (state_version 3)`). Staleness stays an
+exception, exactly as in production: assert the refusal of a stale token
+with `raise_error`, not with a prediction matcher —
+
+<!-- illustrative -->
+```ruby
+expect { order.cancel!(seen: stale_token) }
+  .to raise_error(Statecraft::StaleTransition)
+```
+
 ## Metadata
 
 Metadata is normalized on pipeline entry with a full JSON round-trip —

data/lib/statecraft/rspec/state_report.rb

@@ -14,7 +14,12 @@ module Statecraft
       end
 
       def standing(record)
-        "#{record.class.name} in state #{current_state(record).inspect}"
+        "#{record.class.name} in state #{current_state(record).inspect}#{version_standing(record)}"
+      end
+
+      def version_standing(record)
+        column = record.class.statecraft_mounting.version_column
+        column ? " (#{column} #{record[column]})" : ""
       end
 
       def machine(record)

data/lib/statecraft/rspec/transition.rb

@@ -7,7 +7,8 @@ module Statecraft
     #
     # The transition through the eyes of a test: the state column moved to
     # the target AND exactly one log row was appended with the matching
-    # from/to/event/metadata. A non-bang call that returned false leaves
+    # from/to/event/metadata — and under versioning: the version column
+    # incremented together with the state. A non-bang call that returned false leaves
     # both untouched — the matcher fails and explains why, from the same
     # introspection the pipeline consulted. Exceptions of the bang forms
     # fly through, like with the change matcher: refusals are asserted
@@ -45,10 +46,13 @@ module Statecraft
       def matches?(block)
         raise ArgumentError, "transition(record).to(:state) — the .to target is required" unless @to_state
 
+        @version_column = @record.class.statecraft_mounting.version_column
         @before_state = StateReport.current_state(@record)
+        @before_version = @record[@version_column] if @version_column
         appended_before = @record.history.count
         block.call
         @after_state = StateReport.current_state(@record)
+        @after_version = @record[@version_column] if @version_column
         @appended = @record.history.offset(appended_before).to_a
         collect_failures
         @failures.empty?
@@ -84,6 +88,15 @@ module Statecraft
           @failures << "the record ended in #{@after_state.inspect}, not #{@to_state.inspect}"
         end
         collect_row_mismatches(@appended.last)
+        collect_version_mismatch
+      end
+
+      def collect_version_mismatch
+        return unless @version_column
+        return if @after_version == @before_version + 1
+
+        @failures << "the #{@version_column} column went from #{@before_version} to #{@after_version}, " \
+                     "expected #{@before_version + 1}: a versioned transition increments the version with the state"
       end
 
       def collect_row_mismatches(row)

data/lib/statecraft/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Statecraft
-  VERSION = "0.7.1"
+  VERSION = "0.8.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: statecraft
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.0
 platform: ruby
 authors:
 - Igor Pugachev