lab42_state_machine 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 40cee82db2d88428e2e52f115faa98ccb571020d
-  data.tar.gz: 8a716c44053c53ebbdc2aabfa590c8c9f0543aab
+  metadata.gz: 7794b97f4ada35102cd112f803d049df99e0fcdb
+  data.tar.gz: 5f3f4276da47d24c629f57c9f4e957c9b84e0e21
 SHA512:
-  metadata.gz: a88d6d79918585acd61f4fed0dd0274cbe61c22cf3fd4900d145fd5844dd36231e2f3ec6cf9cddf8ebc66402e238c363050ace782ae999b11421f943bf798c58
-  data.tar.gz: 9f7dc40f0c3a0cd3e887d9048b1574834d5cccdb85c2d81a778b9882fb823f3aa8df9a49f91cebc301a4c79046ed3c412480cd11215e32ac29af6f24feb59bde
+  metadata.gz: 1c5c90bb25e28f7585981f0557ead12e9a2231dc51c47e326d29a7170620b17537b36dfd4bec0fd3ab499b85d13bc222a5d940c91ccd9bc4c36627e8e2aa095f
+  data.tar.gz: 256aef995922fbba3c09d5380f3152fd3d343e7c7418d8566ce94a8c0bbf12edfcdabf6030ae501daee63314f68af7074a84d4da2856a58c7aa6a946ffaa6986

data/README.md

@@ -154,7 +154,30 @@ Really part of the *Runtime API*
 
 `teardown do | last_input, last_state |` Will be called at the very end of the processing cycle.
 
-
 #### transition
 
 `transition a: :b, b: :c do |input, old_state, new_state|` These are execute when the state changes from :a to :b, or :b to :a. Of course only one transition can be indicated (and mostly will be). These handlers are executed *after* the state handlers fot the new states, that is :b or :c in our case.
+
+### Runtime API
+
+#### halt\_machine
+
+```halt_machine``` stops the execution and makes run return the current `subject`
+
+Raises a `StopIteration` and does therefore not make any sense in `setup` or `teardown` handlers
+
+
+#### state
+
+As already mentioned in the Definition and Setup API
+
+This is the (overloaded - for the sake of a slim API) workerbee of the State Machine, it comes in three forms:
+
+##### state querying form (0 params)
+
+
+`state` Query currrent_state of the StateMachine
+
+##### state setter form (1 param)
+
+```state new_state``` Set new state of the StateMachine

data/lib/lab42/state_machine/controller.rb

@@ -2,12 +2,14 @@ module Lab42
   class StateMachine
     class Controller
 
-      def after &block
-        @afters << block
+      def after  block=nil, &blk
+        behavior = get_behavior block, blk
+        @afters << behavior
       end
 
-      def before &block
-        @befores << block
+      def before  block=nil, &blk
+        behavior = get_behavior block, blk
+        @befores << behavior
       end
 
       def run input
@@ -58,7 +60,10 @@ module Lab42
         @state     = st
       end
 
-      def setup &block; @setups << block end
+      def setup  block=nil, &blk
+        behavior = get_behavior block, blk
+        @setups << behavior
+      end
 
       def state *args, &block
         raise ArgumentError, "args.size = #{args.size} instead of 0..1" if args.size > 1
@@ -78,7 +83,10 @@ module Lab42
       private
       def current_transition; [@old_state, @state] end
 
-      def mk_ary_hash; Hash.new{ |h,k| h[k] = [] } end
+      def get_behavior block1, block2
+        raise ArgumentError, "need exactly one block ( or symbol )" unless !!block1 != !!block2
+        mk_block block1 || block2
+      end
 
       def initialize state_machine
         @sm        = state_machine
@@ -93,6 +101,19 @@ module Lab42
         @handlers     = mk_ary_hash
         @transitions  = mk_ary_hash
       end
+
+      def mk_block blocky
+        case blocky
+        when Proc, Method
+          blocky
+        when Symbol, String
+          @sm.method blocky
+        else
+          blocky.to_proc
+        end
+      end
+
+      def mk_ary_hash; Hash.new{ |h,k| h[k] = [] } end
     end # class Controller
   end # class StateMachine
 end # module Lab42

data/lib/lab42/state_machine/version.rb

@@ -1,5 +1,5 @@
 module Lab42
   class StateMachine
-    Version = "0.1.1"
+    Version = "0.1.2"
   end # class StateMachine
 end # module Lab42

data/lib/lab42/state_machine.rb

@@ -8,6 +8,12 @@ module Lab42
 
     forward_all :after, :before, :setup, :state, :teardown, :transition, to: :controller
 
+    def behavior name, &behave
+      class << self; self end. module_eval do
+        define_method name do behave end
+      end
+    end
+
     def halt_machine
       raise StopIteration, "#{self} halted"
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lab42_state_machine
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Robert Dober
@@ -83,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.1.0
 signing_key: 
 specification_version: 4
 summary: A Simple State Machine