skn_utils 2.0.3 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6db99e4aeb953f51c21ff313dee110b9af305691
-  data.tar.gz: 32a906192681346ab40052157e833ddd73d40bac
+  metadata.gz: eb76906e8c9a9acc4a24c4f3d901a82a4a75551e
+  data.tar.gz: 5c837b3b0237136a0d26f9819360c5223b49f0e6
 SHA512:
-  metadata.gz: 0e6e5be4b0308853f81798dc2f0c599bd909c4353de6842e60d4f43cf6b09f58bda1e651845adc98f9338f7194b0ceacbf51638fe20349b2a96fb94acc0b9c72
-  data.tar.gz: bf41ea172ab26025e58e2242ab9e7498f0cdaa42ddb4cac661de862c0d83ae85cae3ad19e3d863278ad5cd17a214086f4e2c0cbc29ed0a79f64cd91a8eb658a5
+  metadata.gz: 17ae5f8c61d19c3aed3e5b4915c68b341a2ac4f45da80b8a2841bafc620a88af72c245b45271782d3d748abce12406e712a53d7004b800c87bb75f82ed88c5b7
+  data.tar.gz: 3baa78fcdb3f07c458a5b9b5b378d971ec68a7b9828489e1971386a14dafce68929eef868c16ed790a80919d26e574a1fd4551b0ee2fb46a125b722d2a784b4e

data/README.rdoc

@@ -23,6 +23,10 @@ into the input params key ':enable_serialization' set to true.  It defaults to f
 === New Features
 --------------------------------
 
+    08/2016  V2.0.3
+    Added an exploritory ActionService class and RSpec test, triggered by reading [Kamil Lelonek](https://blog.lelonek.me/what-service-objects-are-not-7abef8aa2f99#.p64vudxq4)
+    I don't support his approach, but the CreateTask class caught my attention as a Rubyist.
+
     12/2015  V2.0  
 	All references to ActiveRecord or Rails has been removed to allow use in non-Rails environments
     as a result serialization is done with standard Ruby Hash serialization methods; by first transforming

data/lib/skn_utils/{action_service.rb → exploring/action_service.rb}

@@ -2,42 +2,44 @@
 #
 # Exploritory Action/Service Class
 # Ref: https://blog.lelonek.me/what-service-objects-are-not-7abef8aa2f99#.p64vudxq4
+#      http://sporto.github.io/blog/2012/11/15/a-pattern-for-service-objects-in-rails/
 #
 # Not a template or abstract class, Just an Example of an Action class
 #
 
 module SknUtils
-  class ActionService
+  module Exploring
+    class ActionService
 
-    def initialize(dependency_injection_arguments)
-      @thingy = dependency_injection_arguments
-    end
-
-    def call(*command_and_params)
-      puts "Called with: #{command_and_params}"
-      value = command_and_params
-      if value.first.is_a?(Symbol)
-        (value.size == 1 ? self.send(value.first) : self.send(value.first, value[1..-1]))
-      else
-        puts('No Action Taken')
+      def initialize(dependency_injection_arguments)
+        @thingy = dependency_injection_arguments
       end
 
-      self
-    end
+      def call(*command_and_params)
+        puts "Called with: #{command_and_params}"
+        if command_and_params.first.is_a?(Symbol)
+          (command_and_params.size == 1 ? self.send(command_and_params.first) : self.send(command_and_params.first, command_and_params[1..-1]))
+        else
+          puts('No Action Taken')
+        end
 
-    private
-    # a bunch of private methods
-    def action_one
-      puts "#{__method__}() #{@thingy}"
-      true
-    end
+        self
+      end
 
-    def action_two(parm)
-      puts "#{__method__} => #{parm} #{@thingy}"
-      true
-    end
+      private
+      # a bunch of private methods
+      def action_one
+        puts "#{__method__}() #{@thingy}"
+        true
+      end
+
+      def action_two(parm)
+        puts "#{__method__} => #{parm} #{@thingy}"
+        true
+      end
 
-  end # end class
+    end # end class
+  end # end module
 end # end module
 
 

data/lib/skn_utils/exploring/commander.rb

@@ -0,0 +1,68 @@
+##
+# <project.root>/lib/skn_utils/exploring/commander.rb
+##
+# ref: https://github.com/saturnflyer/direction
+##
+# Provide a feature like the Forwardable library,
+# but set the return value to self.
+# It provides a class level "command" method to do
+# message forwarding.
+#
+# class SomeClass
+#   extend SknUtils::Commander
+#
+#   command [:print_details, :setup_things] => :collaborator
+#   query [:name, :id] => :collaborator, :type => :@partner
+# end
+#
+# This will define methods on instances that forward to the
+# provided receiver while enforcing encapsulation of the
+# relationship between objects.
+#
+# the collaborator and you must agree on how results can be exchanged
+# you might provide a callback method for it to set its return value on you
+# :callback, develop a protocol to exchange messages with collaborator
+##
+
+
+module SknUtils
+  module Exploring
+    module Commander
+
+      # Forward messages and return self, protecting the encapsulation of the object
+      def command(options)
+        Commander.define_methods(self, options) do |command, accessor|
+          %{
+            def #{command}(*args, &block)
+              #{accessor}.__send__(:#{command}, *args, &block)
+              self
+            end
+          }
+        end
+      end
+
+      # Forward messages and return the result of the forwarded message
+      def query(options)
+        Commander.define_methods(self, options) do |query, accessor|
+          %{
+            def #{query}(*args, &block)
+              #{accessor}.__send__(:#{query}, *args, &block)
+            end
+          }
+        end
+      end
+
+      # Commander's class method
+      def self.define_methods(mod, options)
+        method_defs = []
+        options.each_pair do |method_names, accessor|
+          Array(method_names).map do |message|
+            method_defs.push yield(message, accessor)
+          end
+        end
+        mod.class_eval method_defs.join("\n"), __FILE__, __LINE__
+      end
+
+    end # Commander
+  end # Exploring
+end # SknUtils

data/lib/skn_utils/version.rb

@@ -1,3 +1,14 @@
+# A better way to say it
 module SknUtils
-  VERSION = "2.0.3"
-end
+  class Version
+    MAJOR = 2
+    MINOR = 0
+    PATCH = 4
+
+    def self.to_s
+      [MAJOR, MINOR, PATCH].join('.')
+    end
+  end
+
+  VERSION = Version.to_s
+end

data/lib/skn_utils.rb

@@ -5,8 +5,8 @@ require 'skn_utils/generic_bean'
 require 'skn_utils/page_controls'
 require 'skn_utils/result_bean'
 require 'skn_utils/value_bean'
-require 'skn_utils/commander'
-require 'skn_utils/action_service'
+require 'skn_utils/exploring/commander'
+require 'skn_utils/exploring/action_service'
 
 module SknUtils
   

data/spec/lib/skn_utils/action_service_spec.rb

@@ -1,10 +1,10 @@
 ##
-# spec/lib/skn_utils/action_service_spec.rb
+# spec/lib/skn_utils/exploring/action_service_spec.rb
 #
 
-RSpec.describe SknUtils::ActionService, "Example Service Object class with command interface." do
+RSpec.describe SknUtils::Exploring::ActionService, "Example Service Object class with command interface." do
   let(:action) {
-    SknUtils::ActionService.new('Thingys')
+    SknUtils::Exploring::ActionService.new('Thingys')
   }
 
   context "Handles Bad Input. " do

data/spec/lib/skn_utils/commander_spec.rb

@@ -4,7 +4,7 @@
 #
 
 class Person
-  extend SknUtils::Commander
+  extend SknUtils::Exploring::Commander
   command [:make_me_a_sandwich, :cook, :blocky] => :@friend
   query [:activities, :go, :say_what] => :friend
   attr_accessor :friend
@@ -60,7 +60,7 @@ module Activities
   end
 end
 
-RSpec.describe SknUtils::Commander, 'command' do
+RSpec.describe SknUtils::Exploring::Commander, 'command' do
   let(:friend){ Friend.new }
   let(:person){ person = Person.new
   person.friend = friend
@@ -95,7 +95,7 @@ RSpec.describe SknUtils::Commander, 'command' do
   end
 end
 
-RSpec.describe SknUtils::Commander, 'query' do
+RSpec.describe SknUtils::Exploring::Commander, 'query' do
   let(:friend){ Friend.new }
   let(:person){ person = Person.new
   person.friend = friend

data/spec/spec_helper.rb

@@ -1,6 +1,9 @@
 ENV['RAILS_ENV'] ||= 'test'
 
 require 'skn_utils'
+require 'skn_utils/exploring/commander'
+require 'skn_utils/exploring/action_service'
+
 require 'rspec'
 require 'yaml'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: skn_utils
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.0.4
 platform: ruby
 authors:
 - James Scott Jr
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-27 00:00:00.000000000 Z
+date: 2016-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -91,9 +91,9 @@ files:
 - README.rdoc
 - Rakefile
 - lib/skn_utils.rb
-- lib/skn_utils/action_service.rb
 - lib/skn_utils/attribute_helpers.rb
-- lib/skn_utils/commander.rb
+- lib/skn_utils/exploring/action_service.rb
+- lib/skn_utils/exploring/commander.rb
 - lib/skn_utils/generic_bean.rb
 - lib/skn_utils/nested_result_base.rb
 - lib/skn_utils/page_controls.rb

data/lib/skn_utils/commander.rb

@@ -1,66 +0,0 @@
-##
-# <project.root>/lib/skn_utils/commander.rb
-##
-# ref: https://github.com/saturnflyer/direction
-##
-# Provide a feature like the Forwardable library,
-# but set the return value to self.
-# It provides a class level "command" method to do
-# message forwarding.
-#
-# class SomeClass
-#   extend SknUtils::Commander
-#
-#   command [:print_details, :setup_things] => :collaborator
-#   query [:name, :id] => :collaborator, :type => :@partner
-# end
-#
-# This will define methods on instances that forward to the
-# provided receiver while enforcing encapsulation of the
-# relationship between objects.
-#
-# the collaborator and you must agree on how results can be exchanged
-# you might provide a callback method for it to set its return value on you
-# :callback, develop a protocol to exchange messages with collaborator
-##
-
-
-module SknUtils
-  module Commander
-
-    # Forward messages and return self, protecting the encapsulation of the object
-    def command(options)
-      Commander.define_methods(self, options) do |command, accessor|
-        %{
-          def #{command}(*args, &block)
-            #{accessor}.__send__(:#{command}, *args, &block)
-            self
-          end
-        }
-      end
-    end
-
-    # Forward messages and return the result of the forwarded message
-    def query(options)
-      Commander.define_methods(self, options) do |query, accessor|
-        %{
-          def #{query}(*args, &block)
-            #{accessor}.__send__(:#{query}, *args, &block)
-          end
-        }
-      end
-    end
-
-    # Commander's class method
-    def self.define_methods(mod, options)
-      method_defs = []
-      options.each_pair do |method_names, accessor|
-        Array(method_names).map do |message|
-          method_defs.push yield(message, accessor)
-        end
-      end
-      mod.class_eval method_defs.join("\n"), __FILE__, __LINE__
-    end
-
-  end # Commander
-end # SknUtils