direct 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98778b7710dd0641ba88486adc2888551cd823ec4be17494857d42555af8e72a
-  data.tar.gz: b0216ba7745d33ff0f6cf3f1018472d19a8ec3df00b2678bcda68f4074a125d4
+  metadata.gz: b177e702ac1b7caafa4430f8e552336d07997d7ecdb0cc7eb21eda814c5b10a1
+  data.tar.gz: 8236f43a4a784720af82eab4b5cbaea76182373cf329a2162001086fa3c8fc64
 SHA512:
-  metadata.gz: 1fd862dec144d24f9268574cc91a1fae0a9b90052598d2c3f221b5cc23cd383d60966d600db20ba8551751bd11344a2ca8f79b9563cd834dce941569dc08e0cf
-  data.tar.gz: 734e1c4f6095c2c5d7566ba607a438000298e28b1c2d352ba9c93a17ea3e7249956119b69b9e1d6184716006fc158ad5394b03e139c44f5f7f7f0972d549af97
+  metadata.gz: a065bf3c181084b8fe3418af13dd9b7ea096bd7cb8e6b717e3264457271021591d4bff17eae4e9bb3bb69a4acc4f2304c262a670b77cf69b08d16834ba458e39
+  data.tar.gz: 4fe6b632e7c6d6b7204af70efd1cd5e00b53d86a19d5e0cc03f59023bbb9b1c52205693ade062cd3e5a51d2a1eb28c0776d5bb20f77da2d9115f58d74201c63d

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## Version 1.2.0
+
+Provide a Direct.defer and Direct.strict_defer to allow deferring blocks without success and failure procedures.
+
 ## Version 1.1.1
 
 Include Direct.allow_missing_directions to allow as_directed to be ignored when missing.

data/lib/direct.rb

@@ -1,7 +1,4 @@
 require "direct/version"
-require "direct/executable"
-require "direct/group"
-
 # Include this module in your classes to provide a way for
 # your objects to handle named scenarios with blocks of code.
 module Direct
@@ -32,20 +29,44 @@ module Direct
   def self.allow_missing_directions
     AllowMissing
   end
+end
+
+require "direct/executable"
+require "direct/strict_executable"
+require "direct/group"
 
+module Direct
   # Wrap a block of code to return an object for handling
-  # success or failure.
+  # success or failure. Raises exceptions when directions
+  # are not provided
   #
   # Example:
   #
   #   def do_it
-  #     Direct.defer{
+  #     Direct.strict_defer{
   #       [true, false].sample
   #     }
   #   end
   #   do_it.
   #     success{|result| puts "it worked!" }.
-  #     failure{|result| puts "it failed!" }
+  #     failure{|result| puts "it failed!" }.
+  #     value
+  #
+  def self.strict_defer(&block)
+    StrictExecutable.new(&block)
+  end
+
+  # Wrap a block of code to return an object for handling
+  # success or failure.
+  #
+  # Example:
+  #
+  #   def do_it
+  #     Direct.defer{
+  #       [true, false].sample
+  #     }
+  #   end
+  #   do_it.value
   #
   def self.defer(&block)
     Executable.new(&block)

data/lib/direct/executable.rb

@@ -1,6 +1,6 @@
 module Direct
   class Executable
-    include Direct
+    include Direct.allow_missing_directions
 
     # It is intended that you initialize objects via Direct.defer
     # and not directly initializing this class.

data/lib/direct/strict_executable.rb

@@ -0,0 +1,91 @@
+module Direct
+  class StrictExecutable
+    include Direct
+
+    # It is intended that you initialize objects via Direct.strict_defer
+    # and not directly initializing this class.
+    #
+    # You may initialize this class and provide an object which
+    # responds to "call" or a block to execute.
+    #
+    # Example:
+    #
+    #   Direct.strict_defer do
+    #     puts "see ya later!"
+    #   end
+    #
+    #   Direct.strict_defer(->{ "call me, maybe" })
+    #
+    def initialize(callable=nil, &block)
+      @execution = callable || block
+      @exception_classes = [StandardError]
+    end
+    attr_reader :execution, :exception_classes
+
+    # Tell the object what to do for a success path
+    #
+    # Returns itself
+    #
+    def success(callable=nil, &block)
+      direct(:success, (callable || block))
+      self
+    end
+
+    # Tell the object what to do for a failure path
+    #
+    # Returns itself
+    #
+    def failure(callable=nil, &block)
+      direct(:failure, (callable || block))
+      self
+    end
+
+    # Tell the object what to do for an exception path.
+    #
+    # You may optionally provide a list of modules rescued by
+    # the value method in the case of an exception.
+    #
+    # Returns itself
+    #
+    # Example:
+    #
+    #   Direct.strict_defer {
+    #      # something...
+    #   }.exception(NoMethodError) { |deferred, exception|
+    #      ExceptionNotifier.notify(exception)
+    #   }
+    #
+    def exception(*classes, &block)
+      unless classes.empty?
+        @exception_classes = classes
+      end
+      direct(:exception, block)
+      self
+    end
+
+    def run_exception_block(exception)
+      if __directions.key?(:exception)
+        as_directed(:exception, exception)
+      else
+        as_directed(:failure, exception)
+      end
+    end
+    private :run_exception_block
+
+    # Return the value of the success or failure path
+    # and rescue from StandardError or from the modules
+    # provided to the exception path.
+    #
+    def value
+      result = execution.()
+      if result
+        as_directed(:success, result)
+      else
+        as_directed(:failure, result)
+      end
+    rescue *exception_classes => exception
+      run_exception_block(exception)
+    end
+    alias execute value
+  end
+end

data/lib/direct/version.rb

@@ -1,3 +1,3 @@
 module Direct
-  VERSION = "1.1.1"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: direct
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Jim Gay
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-02-21 00:00:00.000000000 Z
+date: 2019-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -73,6 +73,7 @@ files:
 - lib/direct.rb
 - lib/direct/executable.rb
 - lib/direct/group.rb
+- lib/direct/strict_executable.rb
 - lib/direct/version.rb
 homepage: https://github.com/saturnflyer/direct
 licenses: