supporting instance level inspection for states

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 
+ * supporting instance level inspection for states
  * added autocreation of constants for each state ([@jherdman](https://github.com/jherdman))
 
 ## 3.0.16

README.md

@@ -304,6 +304,24 @@ class AddJobState < ActiveRecord::Migration
 end
 ```
 
+## Inspection ##
+
+AASM supports a couple of methods to find out which states or events are provided or permissible.
+
+Given the `Job` class from above:
+
+```ruby
+job = Job.new
+
+job.states
+=> [:sleeping, :running, :cleaning]
+
+job.events
+=> [:run, :clean, :sleep]
+```
+
+
+
 ## Installation ##
 
 ### Manually from RubyGems.org ###

lib/aasm/instance_base.rb

@@ -30,6 +30,10 @@ module AASM
       AASM::Localizer.new.human_state_name(@instance.class, current_state)
     end
 
+    def states
+      @instance.class.aasm.states
+    end
+
     # QUESTION: shouldn't events and permissible_events be the same thing?
     # QUESTION: shouldn't events return objects instead of strings?
     def events(state=current_state)

spec/unit/inspection_spec.rb

@@ -27,6 +27,24 @@ describe 'inspection for common cases' do
     Foo.aasm.events.should include(:null)
   end
 
+  context "instance level inspection" do
+    it "delivers all states" do
+      foo = Foo.new
+      states = foo.aasm.states
+      states.should include(:open)
+      states.should include(:closed)
+    end
+
+    it "delivers all events" do
+      foo = Foo.new
+      events = foo.aasm.events
+      events.should include(:close)
+      events.should include(:null)
+      foo.close
+      foo.aasm.events.should be_empty
+    end
+  end
+
   it 'should list states in the order they have been defined' do
     Conversation.aasm.states.should == [:needs_attention, :read, :closed, :awaiting_response, :junk]
   end
@@ -67,17 +85,6 @@ describe :aasm_from_states_for_state do
   end
 end
 
-describe :aasm_events_for_current_state do
-  let(:foo) {Foo.new}
-
-  it 'work' do
-    foo.aasm.events.should include(:close)
-    foo.aasm.events.should include(:null)
-    foo.close
-    foo.aasm.events.should be_empty
-  end
-end
-
 describe 'permissible events' do
   let(:foo) {Foo.new}