skn_utils 5.4.0 → 5.8.0

data/spec/lib/skn_utils/concurrent_jobs_spec.rb

@@ -0,0 +1,279 @@
+##
+# spec/lib/skn_utils/as_human_size_spec.rb
+#
+
+
+describe SknUtils::ConcurrentJobs, 'Run Multiple Jobs' do
+
+  let(:commands) {
+    [
+        SknUtils::CommandJSONPost.call(full_url: "http://example.com/posts", payload: {one: 1}, headers: {'my-header'=> "header-value"}),
+        SknUtils::CommandFORMPost.call(full_url: "http://example.com/posts", payload: {one: 1}),
+        SknUtils::CommandJSONGet.call(full_url: "http://example.com/posts/1"),
+        SknUtils::CommandJSONPut.call(full_url: "http://example.com/posts", payload: {one: 1}),
+        SknUtils::CommandFORMDelete.call(full_url: "http://example.com/posts/1")
+    ]
+  }
+
+  let(:test_proc) {
+    ->(cmd) { SknSuccess.(cmd.uri.request_uri, "Ok") }
+  }
+
+  let(:inline_failure_proc) {
+    ->(cmd) { SknFailure.(cmd.uri.request_uri, "Failure") }
+  }
+
+  let(:catastrophic_proc) {
+    ->(cmd) { SomeUnkownThing.(cmd.uri.request_uri, "Catastrophic") }
+  }
+
+  context "HTTP Requests " do
+    it "Job Commands will provide a valid http request object" do
+      expect(commands.any?(&:request)).to be true
+    end
+
+    it "Performs Http Post Requests" do
+      test_url = "http://jsonplaceholder.typicode.com/users"
+      stub_request(:post, test_url).
+          to_return(status: 200, body: "{\"message\":\"me\"}", headers: {})
+
+      cmd = SknUtils::CommandJSONPost.call(full_url: test_url, payload: {"one" => 1})
+
+      provider = SknUtils::ConcurrentJobs.call
+      provider.register_job do
+        SknUtils::JobWrapper.call(cmd, SknUtils::HttpProcessor)
+      end
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be true
+      expect(result.values.size).to eq(1)
+      expect(result.values[0]).to be_a(SknSuccess)
+      expect(result.values[0].value).to be_a(Hash)
+      expect(result.values[0].value["message"]).to eq("me")
+    end
+
+    it "Performs Http Form Post Requests" do
+      test_url = "http://jsonplaceholder.typicode.com/users"
+      stub_request(:post, test_url).
+          to_return(status: 200, body: "message=me", headers: {})
+
+      cmd = SknUtils::CommandFORMPost.call(full_url: test_url, payload: {"one" => 1})
+
+      provider = SknUtils::ConcurrentJobs.call
+      provider.register_job do
+        SknUtils::JobWrapper.call(cmd, SknUtils::HttpProcessor)
+      end
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be true
+      expect(result.values.size).to eq(1)
+      expect(result.values[0]).to be_a(SknSuccess)
+      expect(result.values[0].value).to be_a(String)
+      expect(result.values[0].value).to eq("message=me")
+    end
+
+    it "Performs Http Get Requests" do
+      test_url = "http://jsonplaceholder.typicode.com/users"
+      stub_request(:get, test_url).
+          to_return(status: 200, body: "{\"message\":\"me\"}", headers: {})
+
+      cmd = SknUtils::CommandJSONGet.call(full_url: test_url)
+
+      provider = SknUtils::ConcurrentJobs.call
+      provider.register_job do
+        SknUtils::JobWrapper.call(cmd, SknUtils::HttpProcessor)
+      end
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be true
+      expect(result.values.size).to eq(1)
+      expect(result.values[0]).to be_a(SknSuccess)
+      expect(result.values[0].value).to be_a(Hash)
+      expect(result.values[0].value["message"]).to eq("me")
+    end
+
+    it "Performs Http Put Requests" do
+      test_url = "http://jsonplaceholder.typicode.com/users"
+      stub_request(:put, test_url).
+          to_return(status: 200, body: "{\"message\":\"me\"}", headers: {})
+
+      cmd = SknUtils::CommandJSONPut.call(full_url: test_url, payload: {"one" => 1})
+
+      provider = SknUtils::ConcurrentJobs.call
+      provider.register_job do
+        SknUtils::JobWrapper.call(cmd, SknUtils::HttpProcessor)
+      end
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be true
+      expect(result.values.size).to eq(1)
+      expect(result.values[0]).to be_a(SknSuccess)
+      expect(result.values[0].value).to be_a(Hash)
+      expect(result.values[0].value["message"]).to eq("me")
+    end
+
+    it "Performs Http Form Delete Requests" do
+      test_url = "http://jsonplaceholder.typicode.com/users"
+      stub_request(:delete, test_url).
+          to_return(status: 200, body: "message=me", headers: {})
+
+      cmd = SknUtils::CommandFORMDelete.call(full_url: test_url, payload: {"one" => 1})
+
+      provider = SknUtils::ConcurrentJobs.call
+      provider.register_job do
+        SknUtils::JobWrapper.call(cmd, SknUtils::HttpProcessor)
+      end
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be true
+      expect(result.values.size).to eq(1)
+      expect(result.values[0]).to be_a(SknSuccess)
+      expect(result.values[0].value).to be_a(String)
+      expect(result.values[0].value).to eq("message=me")
+    end
+  end
+
+  context "Asynchronous" do
+    it "Runs Jobs" do
+      provider = SknUtils::ConcurrentJobs.call
+      provider.register_jobs(commands, test_proc)
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be true
+      expect(result.values.size).to eq(commands.size)
+      expect(result.values[0]).to be_a(SknSuccess)
+    end
+    it "Runs Jobs and handles inline failures" do
+      provider = SknUtils::ConcurrentJobs.call
+
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[0], test_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[1], inline_failure_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[2], inline_failure_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[3], inline_failure_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[4], test_proc)
+      end
+
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be false
+      expect(result.values.size).to eq(commands.size)
+      expect(result.values[1]).to be_a(SknFailure)
+      expect(result.values[1].message).to eq("Failure")
+    end
+    it "Runs Jobs and handles catastrophic failures" do
+      provider = SknUtils::ConcurrentJobs.call
+      provider.register_job do
+        SknUtils::JobWrapper.call(command[0], test_proc)
+      end
+      provider.register_job do  # notice `command` vs `commands`
+        SknUtils::JobWrapper.call(command[1], inline_failure_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(command[2], catastrophic_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[3], catastrophic_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[4], test_proc)
+      end
+
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be false
+      expect(result.values.size).to eq(commands.size)
+      expect(result.values.last).to be_a(SknSuccess)
+      expect(result.values[3].value).to eq("NameError")
+      expect(result.values[2]).to be_a(SknFailure)
+      expect(result.values[1]).to be_a(SknFailure)
+      expect(result.values[0]).to be_a(SknFailure)
+      expect(result.values[0].value).to eq("Unknown")
+    end
+  end
+
+  context "Synchronous" do
+    it "Runs Jobs" do
+      provider = SknUtils::ConcurrentJobs.call(async: false)
+      provider.register_jobs(commands, test_proc)
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be true
+      expect(result.values.size).to eq(commands.size)
+      expect(result.values[0]).to be_a(SknSuccess)
+    end
+    it "Runs Jobs and handles inline failures" do
+      provider = SknUtils::ConcurrentJobs.call
+
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[0], test_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[1], inline_failure_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[2], inline_failure_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[3], inline_failure_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[4], test_proc)
+      end
+
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be false
+      expect(result.values.size).to eq(commands.size)
+      expect(result.values[1]).to be_a(SknFailure)
+      expect(result.values[1].message).to eq("Failure")
+    end
+    it "Runs Jobs and handles catastrophic failures" do
+      provider = SknUtils::ConcurrentJobs.call
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[0], test_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[1], inline_failure_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[2], catastrophic_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[3], catastrophic_proc)
+      end
+      provider.register_job do
+        SknUtils::JobWrapper.call(commands[4], test_proc)
+      end
+
+      result = provider.render_jobs
+
+      expect(result).to be_a(SknUtils::Result)
+      expect(result.success?).to be false
+      expect(result.values.size).to eq(commands.size)
+      expect(result.values[3].value).to eq("NameError")
+      expect(result.values[2]).to be_a(SknFailure)
+      expect(result.values[1]).to be_a(SknFailure)
+      expect(result.values[0]).to be_a(SknSuccess)
+    end
+  end
+
+end

data/spec/lib/skn_utils/configurable_spec.rb

@@ -2,51 +2,20 @@
 # spec/lib/skn_utils/configurable_spec.rb
 #
 
-class MyApp
-  include SknUtils::Configurable.with( :app_id, :title, :cookie_name, enable_root: true) # No options hash defaults to true
-  # - and accept defaults for #env=, #root=, #registry=, and #logger=
-
-  # notice: self.logger=, the self is required when assigning values
-  self.logger = Object.new
-  self.registry = Object.new
-
-  configure do
-    app_id 'some app'
-    title 'My Title'
-    cookie_name 'Chocolate'
-  end
-
-  def null_value
-    @app_id.dup
-  end
-end
-
-module MyMod
-  include SknUtils::Configurable.with(:app_id, :title, :cookie_name,  enable_root: false)
-
-  def self.null_value
-    @app_id.dup
-  end
-end
-
-MyMod.configure do
-  app_id 'some module'
-  title 'Some Title'
-  cookie_name 'Caramel'
-end
+require "support/configurables"
 
 
 describe SknUtils::Configurable, "Gem Configuration module." do
 
   let(:my_app) { MyApp.new }
 
-  context "Top Level AppClass Extra Operational Features. " do
+  context "MyApp: Top Level AppClass Extra Operational Features. " do
 
     it "MyApp.env.test? returns expected value. " do
       expect( MyApp.env.test? ).to be true
     end
     it "MyApp.root returns expected value. " do
-      expect( MyApp.root.realdirpath.to_s ).to eq( Dir.pwd )
+      expect( MyApp.root ).to eq( Dir.pwd )
     end
     it "MyApp.logger returns expected value. " do
       expect( MyApp.logger ).to be_instance_of(Object) # eq('No Logger Assigned.')
@@ -60,9 +29,11 @@ describe SknUtils::Configurable, "Gem Configuration module." do
 
     it "my_app#config.title returns expected value. " do
       expect( MyApp.config.title ).to eq( "My Title" )
+      expect( MyApp.config[:title] ).to eq( "My Title" )
     end
-    it "my_app#config.app_id returns expected value. " do
-      expect( MyApp.config.app_id ).to eq( "some app" )
+    it "my_app#config[:value] accepts and returns expected value. " do
+      expect( MyApp.config[:value]="New Attribute" ).to eq( "New Attribute" )
+      expect( MyApp.config[:value] ).to eq( "New Attribute" )
     end
 
     it "MyMod#config.app_id  returns expected value. " do
@@ -70,6 +41,11 @@ describe SknUtils::Configurable, "Gem Configuration module." do
     end
     it "MyMod#config.cookie_name returns expected value. " do
       expect( MyMod.config.cookie_name ).to eq( 'Caramel' )
+      expect( MyMod.config[:cookie_name] ).to eq( 'Caramel' )
+    end
+    it "MyMod#config[:value] accepts and returns expected value. " do
+      expect( MyMod.config[:value]="New Attribute" ).to eq( "New Attribute" )
+      expect( MyMod.config[:value] ).to eq( "New Attribute" )
     end
 
     it "MyMod#logger raises NoMethodError as expected. " do
@@ -78,4 +54,15 @@ describe SknUtils::Configurable, "Gem Configuration module." do
 
   end
 
+  context "#config instance vars are accessable as expected. " do
+
+    it "MyApp#null_value to return expected value" do
+      expect(my_app.null_value).to eq "some app"
+      expect{ MyApp.null_value }.to raise_error(NoMethodError)
+    end
+
+    it "MyMod#null_value to return expected value" do
+      expect( MyMod.null_value ).to eq "some module"
+    end
+  end
 end

data/spec/lib/skn_utils/registry_spec.rb

@@ -127,4 +127,26 @@ describe SknRegistry, "IoC Lite Container class." do
     end
   end
 
+
+  context "When used for testing " do
+
+    it "#register_mock Registers a temporary mock." do
+      services.register_mock(:service_c, "Testing" )
+
+      expect(services.resolve(:service_c)).to eq "Testing"
+      services.restore!
+    end
+
+    it "#unregister_mocks! Remove all mocks and restores previous entries if present." do
+      original = services.resolve(:service_c)
+      services.substitute(:service_c, "Testing")
+      expect(services.resolve(:service_c)).to eq "Testing"
+
+      services.unregister_mocks!
+
+      services.resolve(:service_c)
+      expect(services.resolve(:service_c)).to eq original
+    end
+  end
+
 end

data/spec/lib/skn_utils/wrappers_spec.rb

@@ -0,0 +1,80 @@
+# ##
+#
+
+module Powered
+  def make_noise
+    puts "Powering up"
+    super
+    puts "Shutting down"
+  end
+end
+
+class Machine
+  extend SknUtils::Wrappable
+
+  wrap Powered
+
+  def make_noise
+    puts "Buzzzzzz"
+  end
+end
+
+
+module Logging
+  def make_noise
+    puts "Started making noise"
+    super
+    puts "Finished making noise"
+  end
+end
+
+class Bird
+  extend SknUtils::Wrappable
+
+  wrap Logging
+
+  def make_noise
+    puts "Chirp, chirp!"
+  end
+end
+
+
+module Flying
+  def make_noise
+    super
+    puts "Is flying away"
+  end
+end
+
+class Pigeon < Bird
+  wrap Flying
+
+  def make_noise
+    puts "Coo!"
+  end
+end
+
+describe 'SknUtils::Wrappable Module Handles Inheritance properly ' do
+
+  it '#make_noise handles Bird module. ' do
+    expect do
+      obj = Bird.new
+      obj.make_noise
+    end.to output("Started making noise\nChirp, chirp!\nFinished making noise\n").to_stdout
+  end
+
+  it '#make_noise handles Pigeon module. ' do
+    expect do
+      obj = Pigeon.new
+      obj.make_noise
+    end.to output("Started making noise\nCoo!\nFinished making noise\nIs flying away\n").to_stdout
+  end
+
+  it '#make_noise handles Machine module. ' do
+    expect do
+      obj = Machine.new
+      obj.make_noise
+    end.to output("Powering up\nBuzzzzzz\nShutting down\n").to_stdout
+  end
+
+end