direct 1.2.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20440d5b3580056507598e8506d9a6e8e26623601dc07ed6cfc443ee2e4dee04
-  data.tar.gz: 981844bd5ede5b4b889ed19ee5ca16cc2c6cdcaa898f166bc3e3132d8034e962
+  metadata.gz: 812ea6d0360b4161fba6c6fcd38d409715900ff08cdd57f3d4cf4df5df2de900
+  data.tar.gz: b3b95cafabb8381687d8a033f4c14b9d57164b101236c61a4faa960a5b73890b
 SHA512:
-  metadata.gz: d7207fd5bd4c1447f4686deff93bddd8d9802722accaa37118979afd0fc46afe75f616a73ffa24628ccfb111c3121ff92319346484c914931f753cce4102059f
-  data.tar.gz: 628cd5d0416be38cdfe79a7a50473c0b59944af35d3b6c01264562dfc0d7f11287d13908ef1c63d9ddc30f870aefdf1a8327c38765c3e246aea7db9d8c28aa8c
+  metadata.gz: 737c8f8dfd54bef81cb284c5bf0fceb02b8ff53df4b9fa31231bbd78d1b9f86bcf83f34e60befce7ed87d368843b63e35de73de16a6578aae5f09cc1a60d5f56
+  data.tar.gz: fffe7ce4459bd5ea399d4103a19ed561955b4e5c241a407c772d4f03669cf9328f108e5fbf704c664dcafd06ccbcdf826b50235e870e7f8522a40f0004ef3e2e

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## Version 2.0.0
+
+A bug in deferred execution did not return the success/failure results. Fixes test names that cause a collision and incorrect test scenarios.
+
 ## Version 1.2.1
 
 Provide an 'object:' to a Direct.defer or Direct.strict_defer to be sent as the third parameter in the executed blocks.

data/Gemfile

@@ -2,4 +2,7 @@ source "https://rubygems.org"
 
 gemspec
 
-gem 'simplecov', require: false, group: :test
+gem "rake", "~> 12.3"
+gem "minitest", "~> 5.11"
+gem "pry-byebug"
+gem "simplecov", require: false, group: :test

data/README.md

@@ -8,7 +8,53 @@ outside of your objects and just tell them what to do.
 ## Usage
 
 ```ruby
+require 'direct'
 class SomeClass
+  def procedure
+    Direct.defer(object: self){
+      # return a truthy or falsey object
+      # to execute success or failure blocks
+    }
+  end
+end
+
+SomeClass.new.procedure.success{ |deferred_object, result, object|
+  puts "it worked!"
+}.failure { |deferred_object, result, object|
+  puts "it failed :-("
+}.execute
+```
+
+If the example `procedure` method above raises an exception instead of just returning a falsey object, the `failure` block will be run.
+
+But you can specify what to do when an exception is raised instead:
+
+```ruby
+SomeClass.new.procedure.success{ |deferred_object, result, object|
+  puts "it worked!"
+}.failure { |deferred_object, result, object|
+  puts "it failed :-("
+}.exception{ |deferred_object, exception, object|
+  puts "Oh no! An exception was raised!"
+}.execute
+```
+
+By default it will handle `StandardError` execeptions but you can be more specific if you like:
+
+```ruby
+SomeClass.new.procedure.success{ |deferred_object, result, object|
+  puts "it worked!"
+}.failure { |deferred_object, result, object|
+  puts "it failed :-("
+}.exception(SomeLibrary::SomeSpecialError){ |deferred_object, exception, object|
+  puts "Oh no! An exception was raised!"
+}.execute
+```
+
+The `defer` method uses built-in classes but you can build your own to manage executing named blocks
+
+```ruby
+class DeferrableClass
   include Direct
 
   def save
@@ -19,11 +65,9 @@ class SomeClass
   end
 end
 
-# Somewhere else
-
-SomeClass.new.direct(:success){|something, *data|
+DeferrableClass.new.direct(:success){|instance, *data|
   STDOUT.puts data
-}.direct(:failure){|something, *errors|
+}.direct(:failure){|instance, *errors|
   STDERR.puts errors
 }.save
 ```

data/direct.gemspec

@@ -22,7 +22,4 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "concurrent-ruby", ">= 1.0"
-
-  spec.add_development_dependency "rake", "~> 12.3"
-  spec.add_development_dependency "minitest", "~> 5.11"
 end

data/lib/direct/executable.rb

@@ -104,9 +104,9 @@ module Direct
     def value
       result = execution.()
       if result
-        as_directed(:success, result, object)
+        as_directed(:success, result, object) || result
       else
-        as_directed(:failure, result, object)
+        as_directed(:failure, result, object) || result
       end
     rescue *exception_classes => exception
       run_exception_block(exception)

data/lib/direct/version.rb

@@ -1,3 +1,3 @@
 module Direct
-  VERSION = "1.2.1"
+  VERSION = "2.0.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: direct
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Jim Gay
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-03-07 00:00:00.000000000 Z
+date: 2020-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -24,34 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '12.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '12.3'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.11'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.11'
 description: Direct objects to perform arbitrary blocks by name
 email:
 - jim@saturnflyer.com
@@ -79,7 +51,7 @@ homepage: https://github.com/saturnflyer/direct
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -94,9 +66,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: Direct objects to perform arbitrary blocks by name
 test_files: []