Merge pull request #37 from nathanl/add-triggerable-events-method

Add triggerable_events to list events available from current state

README.md

@@ -92,7 +92,13 @@ transitions will give you unexpected results.
 Finally, you can list possible events or states:
 
 ``` ruby
+# All possible events
 machine.events #=> [:confirm, :ignore, :reset]
+
+# All events triggerable from the current state
+machine.triggerable_events #=> [:confirm, :ignore]
+
+# All possible states
 machine.states #=> [:new, :confirmed, :ignored]
 ```
 

lib/micromachine.rb

@@ -37,6 +37,10 @@ def events
     transitions_for.keys
   end
 
+  def triggerable_events
+    events.select { |event| trigger?(event) }
+  end
+
   def states
     transitions_for.values.map(&:to_a).flatten.uniq
   end

test/introspection.rb

@@ -14,6 +14,10 @@
   assert_equal [:confirm, :ignore, :reset], machine.events
 end
 
+test "list the available events for the current state" do |machine|
+  assert_equal [:confirm, :ignore], machine.triggerable_events
+end
+
 test "returns an array with the defined states" do |machine|
   assert_equal [:pending, :confirmed, :ignored], machine.states
 end