homerun 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff66481985f29c18e9fa72cb2c695cc5e1a238a996df05030d29c3bc2fb6ce03
-  data.tar.gz: b5b5c2b51fe364828ef8c5505f1633df720ea4c254ebd10a9fa421ee1196e3cd
+  metadata.gz: cb930c5f82071175ed28032b12a529bfe358e1b81a4fade4aba1704834f77f9f
+  data.tar.gz: 8a3febe2c97a12288497b8c5063805263a1610dc9b4a1893d51fa60f00f89272
 SHA512:
-  metadata.gz: 641d66333ee0ce05259320b21deffcd7f9dbc7954410f0f4c7e5832bfc15f4940a13cf8a3121c3af0e1bd5c121afe7eec0811f40e930ab90572be95da7327992
-  data.tar.gz: 377377068c3aff99ba650237349f6194df936fe7167f625e7e1c78c94af1eccae83c711ef34550b04c785609424da7f43a8e61869e335683c0ad682dee0160d1
+  metadata.gz: 1172118936a993829202af5fd1583b032198059f40356283b82933678723767fc56148be371eb0b46299c68e902bd364647057bb7cf249562388ff30d5518414
+  data.tar.gz: 9c638afb6ede813911872919d96e6002bb7e70ee793b17f6581fd9351ab9ebe3f704cca43286b3413c8b254dad980552ebfe90a1a962a147df6a011874a41d26

data/Gemfile.lock

@@ -1,12 +1,17 @@
 PATH
   remote: .
   specs:
-    homerun (0.1.0)
+    homerun (0.1.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    coderay (1.1.2)
+    method_source (0.9.2)
     minitest (5.11.3)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
     rake (10.5.0)
 
 PLATFORMS
@@ -16,6 +21,7 @@ DEPENDENCIES
   bundler (~> 1.17)
   homerun!
   minitest (~> 5.0)
+  pry (~> 0.12)
   rake (~> 10.0)
 
 BUNDLED WITH

data/README.md

@@ -1,8 +1,22 @@
 # Homerun
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/homerun`. To experiment with that code, run `bin/console` for an interactive prompt.
+Sometimes you need to execute sequence of commands,
+depends on execution result you want to do some redirection in execution,
+even retry execution of some part of sequence.
+"homerun" gem is exactly what you want.
 
-TODO: Delete this and the text above, and describe your gem
+```ruby
+class A < Homerun::Instruction
+    step ->(ctx) { ctx[:greetings] += " hello" }
+    step ->(ctx) { ctx[:greetings] += " my"; false }, failure: :end
+    step ->(ctx) { ctx[:greetings] += " dear" }
+    step ->(ctx) { ctx[:greetings] += " friend" }, name: :end
+end
+
+A.call(greetings: "Oh,")
+
+=> "Oh, hello my friend"
+```
 
 ## Installation
 
@@ -22,7 +36,75 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### plain execution of sequence
+```ruby
+  class A < Homerun::Instruction
+    step ->(ctx) { ctx[:var] += 1  }
+    step ->(ctx) { ctx[:var] += 1  }
+    step ->(ctx) { ctx[:var] += 1  }
+  end
+
+  A.call(var: 0)
+  => { var: 3, _pass: true }
+```
+
+### false step catch & redirection to another step
+```ruby
+  class B < Homerun::Instruction
+    step ->(ctx) { false  }, failure: :recover
+    step ->(ctx) { ctx[:var] += 3  }
+    step ->(ctx) { ctx[:var] += 1  }, name: :recover
+  end
+
+  B.call(var: 0)
+  => { var: 1, _pass: true }
+```
+
+### true step catch & redirection to another step
+```ruby
+  class B < Homerun::Instruction
+    step ->(ctx) { true  }, success: :recover
+    step ->(ctx) { ctx[:var] += 3  }
+    step ->(ctx) { ctx[:var] += 1  }, name: :recover
+  end
+
+  B.call(var: 0)
+  => { var: 1, _pass: true }
+```
+### _pass as a result state (true/false)
+```ruby
+  class C < Homerun::Instruction
+    step ->(ctx) { false  }
+    step ->(ctx) { ctx[:var] += 3  }
+    step ->(ctx) { ctx[:var] += 1}
+  end
+
+  C.call(var: 0)
+  => { var: 0, _pass: false }
+
+  class D < Homerun::Instruction
+    step ->(ctx) { ctx[:var] += 1 }
+    step ->(ctx) { ctx[:var] += 1 }
+    step ->(ctx) { false }
+  end
+
+  D.call(var: 0)
+  => { var: 2, _pass: false }
+```
+
+### block execution on _pass == true
+```ruby
+  class C < Homerun::Instruction
+    step ->(ctx) { ctx[:var] += 1 }
+    step ->(ctx) { ctx[:var] += 1 }
+  end
+
+  C.call(var: 0) do |ctx|
+    ctx[:var] += 1
+  end
+
+  => { var: 3, _pass: true }
+```
 
 ## Development
 

data/homerun.gemspec

@@ -38,5 +38,6 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "bundler", "~> 1.17"
   spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "pry", "~> 0.12"
   spec.add_development_dependency "minitest", "~> 5.0"
 end

data/lib/homerun.rb

@@ -1,5 +1,6 @@
 require "homerun/version"
 require 'singleton'
+require 'pry'
 
 module Homerun
   class Error < StandardError; end
@@ -7,25 +8,33 @@ module Homerun
   class Instruction
     include Singleton
 
-    attr_reader :steps, :context
+    attr_reader :steps, :ctx
 
     def initialize
       super
 
       @steps = []
-      @context = {}
+      @ctx = { _pass: true }
     end
 
     def add_step(step)
       @steps << step
     end
 
+    def set_ctx(_ctx)
+      @ctx = { **ctx, **_ctx }
+    end
+
+    def set_pass(val)
+      @ctx[:_pass] = val
+    end
+
     def self.step(item, failure: nil, success: nil, name: nil)
       instance.add_step({ item: item, failure: failure, success: success, name: name })
     end
 
-    def self.call(ctx)
-      @context = ctx.dup
+    def self.call(_ctx)
+      instance.set_ctx(_ctx)
 
       cur = 0
 
@@ -36,7 +45,7 @@ module Homerun
           instance.steps.index(instance.steps.find { |x| x[:name] == _name })
         }
 
-        if step[:item].call(instance.context)
+        if step[:item].call(instance.ctx)
           if step[:success]
             cur = pos.call(step[:success])
             next
@@ -48,10 +57,17 @@ module Homerun
             cur = pos.call(step[:failure])
             next
           else
+            instance.set_pass(false)
             cur = instance.steps.count
           end
         end
       end
+
+      if block_given?
+        yield(instance.ctx) if instance.ctx[:_pass]
+      end
+
+      instance.ctx
     end
   end
 end

data/lib/homerun/version.rb

@@ -1,3 +1,3 @@
 module Homerun
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: homerun
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - skcc321
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-01-24 00:00:00.000000000 Z
+date: 2019-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement