transition_through 1.0.0.pre.beta.1 → 1.0.0.pre.rc.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 245765e994574db116dd542c12e40bd84fe6487f130f647761fc542a19745b45
-  data.tar.gz: fd51b8b84f3c552abb310b6e8912c657449474b80e481f05d4f08b5eb8bca266
+  metadata.gz: 450fffb697c0dde12e5cb3bd846514b9596665442ef8e3dd49561949cf8362dc
+  data.tar.gz: dac34fae2af7fc17a55f5ff76c0547e1d74fff70215273584ba9d06ed6aa8157
 SHA512:
-  metadata.gz: 9b671d76bcece48f74db7248870a0182b841dc52484007802128d727a5ea2d5d075f66b202953450c19207527d99a88d70d0ebf481d0e999c99d049e0d8f3007
-  data.tar.gz: ca866a6ef2d58f7ca14c9b4a46218e445dd205c3df0f42f7170044127fb8de43cf4818edf1bb1bd68b1fb57dbcd4f72699c7ce4c52a7eb1fb0ca242114ffda77
+  metadata.gz: 0bb05c7e740418950526aa9bc825a9d45da390175df7788a3f2ec6ed0a6a43f5268251151eca92098a610941fbdccbb9509fdf25346aa7006e5e07c472d3328c
+  data.tar.gz: f13f636bb6988f1bffb3fb2174d686b3cbbcd692720eeded7b8749618166d28a35dc4d637637a0e2281d79da42a9f5e6f4de4ea8f889e24eda41216e95d2b80a

data/README.md

@@ -40,7 +40,16 @@ $ gem install transition_through
 
 ```ruby
 it 'should transition through' do
-  expect { counter.increment(3) }.to transition { counter.count }.through 0..3
+  counter = Counter.new
+  count   = -> {
+    counter.count = 0
+    counter.increment
+    counter.count  = counter.count + 3
+    counter.count -= 2
+    counter.decrement(by: 2)
+  }
+
+  expect { count.call }.to transition { counter.count }.through [0, 1, 4, 2, 0]
 end
 ```
 

data/lib/transition_through/matcher.rb

@@ -19,6 +19,8 @@ module TransitionThrough
 
     def supports_block_expectations? = true
     def matches?(expect_block)
+      raise InvalidExpressionError, 'transition block is required' if state_block.nil?
+
       path, start_line = state_block.source_location
 
       # walk the ast until we find our transition expression
@@ -27,14 +29,14 @@ module TransitionThrough
 
       ast.value.accept(exp)
 
-      # raise if the expression is empty
-      raise InvalidExpressionError if
+      # raise if the expression is too complex or empty
+      raise InvalidExpressionError, 'complex or empty transition expressions are not supported' if
         exp.result.nil? || exp.result.receiver.nil? || exp.result.method_name.nil?
 
       # get the actual transitioning object from the state block's binding
       receiver = state_block.binding.eval(exp.result.receiver.name.to_s)
 
-      raise InvalidExpressionError unless
+      raise InvalidExpressionError, "expected accessor #{receiver.class}##{exp.result.method_name} but it's missing" unless
         receiver.respond_to?(:"#{exp.result.method_name}=") &&
         receiver.respond_to?(exp.result.method_name)
 
@@ -59,12 +61,16 @@ module TransitionThrough
       @actual_states == @expected_states
     end
 
+    # assert state changes across array or range of values
     def through(*values)
       @expected_states = values.flatten(1)
 
-      self
+      self # allow chaining
     end
 
+    # noop because no change is default assertion
+    def nowhere = self
+
     def failure_message
       "expected block to transition through #{@expected_states.inspect} but it transitioned through #{@actual_states.inspect}"
     end

data/lib/transition_through/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TransitionThrough
-  VERSION = '1.0.0-beta.1'
+  VERSION = '1.0.0-rc.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: transition_through
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.beta.1
+  version: 1.0.0.pre.rc.1
 platform: ruby
 authors:
 - Zeke Gabrielse