razorrisk-razor-connectivity-testdoubles 0.4.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ddb802b853e69ca0a5bc6a07fae98d11752f440a
+  data.tar.gz: edf572120faaa841a323c470e80b3067902244bc
+SHA512:
+  metadata.gz: d3ada8649bae663a3876dd6559646ea825559e9bac5fb6bd3328e2b32fea9093ff8c5ef4b7a8039b33533c750cd28f5f69c5b51849eb38e556e1b7f1bad453c8
+  data.tar.gz: eec9e137718ff1e5787831176880ad9cfca244efbc37fa40916ce3c4cae59b504f1816d226a93bb88f74ced1dad531eeaa04096011ebb502fd2fb00f1dac5d64

data/Rakefile

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+# ######################################################################## #
+#
+#  Copyright (c) 2019 Razor Risk Technologies Pty Limited. All rights reserved.
+#
+# ######################################################################## #
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), 'lib')
+
+# ##########################################################
+# bundler
+
+require 'rubygems'
+require 'bundler/setup'
+
+# ######################################################################## #
+# requires
+
+require 'razor_risk/razor/control/rake_helpers/diagnostic_tasks'
+require 'razor_risk/razor/control/rake_helpers/gem_tasks'
+require 'razor_risk/razor/control/rake_helpers/task_helpers'
+
+require 'rake'
+require 'rake/clean'
+
+# ##########################################################
+# includes
+
+include ::RazorRisk::Razor::Control # rubocop:todo Style/MixinUsage
+include ::Pantheios # rubocop:todo Style/MixinUsage
+
+# ##########################################################
+# Constants
+
+Spec = ::Gem::Specification.load(Dir['*.gemspec'].first)
+LogDir = 'log' # rubocop:todo Naming/ConstantName
+# rubocop:todo Naming/ConstantName
+LogThresholds = %i[informational informational].freeze
+# rubocop:enable Naming/ConstantName
+
+# ##########################################################
+# clean/clobber
+
+Dir[
+    'log',
+    'doc',
+].each { |f| CLEAN << f }
+Dir[
+    '.bundle',
+    'vendor',
+    'GEM_HOME',
+    '*.gem',
+].each { |f| CLOBBER << f }
+
+# ##########################################################
+# Tasks
+
+desc 'Run tests'
+task test: [:'gem:unit_test']
+
+desc 'Build gem'
+task :build_gem, [:path] => :'gem:build'
+
+desc 'Builds the Razor EntityConnector Gem'
+task :build, [:path] => [:build_gem]
+
+desc 'Push the gem to the gem server.'
+task deploy: :'gem:push'
+
+# ##########################################################
+# Hooks
+
+task :default do
+  puts 'Run \'bundler exec rake --tasks\' to see available tasks'
+end
+
+task :first do
+  ::Rake::Task[:'diagnostics:init'].execute(
+    name: Spec.name,
+    version: Spec.version.to_s,
+    directory: LogDir,
+    thresholds: LogThresholds
+  )
+end
+
+RakeHelpers::TaskHelpers.add_hooks
+
+# ############################## end of file ############################# #

data/lib/razor_risk/razor/connectivity/test_doubles/razor_requester/raises_on_send.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+# ######################################################################## #
+# File:         lib/razor_risk/razor/connectivity/test_doubles/razor_requester/raises_on_send.rb
+#
+# Purpose:      Stub module
+#
+# Created:      21st March 2018
+# Updated:      14th August 2018
+#
+# Author:       Matthew Wilson
+#
+# Copyright (c) 2018, Razor Risk Technologies Pty Ltd
+# All rights reserved.
+#
+# ######################################################################## #
+
+require 'razor_risk/razor/connectivity/test_doubles/razor_requester/stub'
+
+module RazorRisk
+  module Razor
+    module Connectivity
+      module TestDoubles
+        module RazorRequester
+          # Stub for RazorRequester, which throws an exception when the +send_request+
+          # method is invoked
+          class RaisesOnSend
+            include Stub
+
+            # Creates an instance, according to the given +options+
+            #
+            # === Signature
+            #
+            # * *Options:*
+            #
+            # @option +:exception+ (::Class) An exception class to be thrown. If not
+            #   specified an instance of +::RuntimeError+ will be thrown
+            # @option +:exception_message+ (::String) A string to be used as the
+            #   thrown exception's message. If not specified, the message
+            #   +'expected'+ will be used
+            #
+            def initialize(config, environment, **options)
+              super
+
+              @exception = check_option(options, :exception, type: ::Class, allow_nil: true) || ::RuntimeError
+
+              @exception_message = check_option(options, :exception_message, type: ::String, allow_nil: true) || 'expected'
+            end
+
+            # Emulates a send-request, subject to the given options
+            #
+            # === Signature
+            #
+            # * *Parameters:*
+            #
+            # * *Options:*
+            #
+            # @option +:check_request+:: Determines whether the request should be
+            #   checked. If truey, then the following values are recognised: +:xml+
+            #   means that the request must be valid XML
+            def send_request(request, **options)
+              super
+
+              raise @exception, @exception_message
+            end
+            # rubocop:todo Style/CommentedKeyword
+          end # class RaisesOnSend
+          # rubocop:enable Style/CommentedKeyword
+          # rubocop:todo Style/CommentedKeyword
+        end # module RazorRequester
+        # rubocop:enable Style/CommentedKeyword
+      end
+    end
+  end
+end
+
+# ############################## end of file ############################# #

data/lib/razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_response.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+# ######################################################################## #
+# File:         lib/razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_response.rb
+#
+# Purpose:      Stub module
+#
+# Created:      7th June 2018
+# Updated:      14th August 2018
+#
+# Author:       Matthew Wilson
+#
+# Copyright (c) 2018, Razor Risk Technologies Pty Ltd
+# All rights reserved.
+#
+# ######################################################################## #
+
+require 'razor_risk/razor/connectivity/test_doubles/razor_requester/stub'
+
+module RazorRisk
+  module Razor
+    module Connectivity
+      module TestDoubles
+        module RazorRequester
+          # rubocop:todo Style/Documentation
+          class ReturnsGivenResponse
+            include Stub
+
+            ACCEPTED_OPTIONS = %w[
+
+              allow_nil
+              given_response
+            ].map(&:to_sym)
+
+            # Creates an instance, according to the given +options+
+            #
+            # === Signature
+            #
+            # * *Options:*
+            #
+            # @option +:given_response+:: (::Object) An object whose string form will
+            #   be emitted. May not be +nil+, unless +options[:allow_nil]+
+            # @option +:allow_nil+:: (boolean) Determines whether the value of
+            #   +:given_response+ may be +nil+
+            #
+            def initialize(config, environment, **options)
+              super
+
+              @given_response = check_option(options, :given_response, allow_nil: options[:allow_nil])
+
+              @latest_request = nil
+            end
+
+            # The latest request submitted to +#send_request+
+            attr_reader :latest_request
+
+            # Emulates a send-request, subject to the given options
+            #
+            # === Signature
+            #
+            # * *Parameters:*
+            #
+            # * *Options:*
+            #
+            # @option +:check_request+:: Determines whether the request should be
+            #   checked. If truey, then the following values are recognised: +:xml+
+            #   means that the request must be valid XML
+            def send_request(request, **options)
+              super
+
+              @latest_request = request
+
+              case options[:check_request]
+              when :xml
+
+                raise ::ArgumentError, 'request may not be nil' if request.nil?
+                unless %w[Nokogiri::XML::Document Nokogiri::XML::Element Nokogiri::XML::Node].include? request.class.to_s
+                  raise ::TypeError, 'request must be instance of Nokogiri XML node'
+              end
+              end
+
+              @given_response
+            end
+            # rubocop:todo Style/CommentedKeyword
+          end # class ReturnsGivenResponse
+          # rubocop:enable Style/CommentedKeyword
+          # rubocop:enable Style/Documentation
+          # rubocop:todo Style/CommentedKeyword
+        end # module RazorRequester
+        # rubocop:enable Style/CommentedKeyword
+      end
+    end
+  end
+end
+
+# ############################## end of file ############################# #

data/lib/razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_responses.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+# ######################################################################## #
+# File:         lib/razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_responses.rb
+#
+# Purpose:      Stub module
+#
+# Created:      10th August 2018
+# Updated:      14th August 2018
+#
+# Author:       Matthew Wilson
+#
+# Copyright (c) 2018, Razor Risk Technologies Pty Ltd
+# All rights reserved.
+#
+# ######################################################################## #
+
+require 'razor_risk/razor/connectivity/test_doubles/razor_requester/stub'
+
+module RazorRisk
+  module Razor
+    module Connectivity
+      module TestDoubles
+        module RazorRequester
+          # rubocop:todo Style/Documentation
+          class ReturnsGivenResponses
+            include Stub
+
+            ACCEPTED_OPTIONS = %w[
+
+              given_responses
+            ].map(&:to_sym)
+
+            # Creates an instance, according to the given +options+
+            #
+            # === Signature
+            #
+            # * *Options:*
+            #
+            #  @option +:given_responses+:: (::Array) An array of objects that will
+            #   be emitted in a wrapping sequence. May not be nil or empty
+            #
+            def initialize(config, environment, **options)
+              super
+
+              @given_responses    =   check_option(options, :given_responses, type: ::Array, reject_empty: true)
+              @response_count     =   0
+
+              @requests = []
+            end
+
+            # The latest request submitted to +#send_request+
+            attr_reader :requests
+
+            # Emulates a send-request, subject to the given options
+            #
+            # === Signature
+            #
+            # * *Parameters:*
+            #
+            # * *Options:*
+            #
+            # @option +:check_request+:: Determines whether the request should be
+            #   checked. If truey, then the following values are recognised: +:xml+
+            #   means that the request must be valid XML
+            # rubocop:todo Metrics/MethodLength
+            def send_request(request, **options)
+              super
+
+              @requests << request
+
+              options = @options.merge options
+
+              case options[:check_request]
+              when :xml
+
+                raise ::ArgumentError, 'request may not be nil' if request.nil?
+                unless %w[Nokogiri::XML::Document Nokogiri::XML::Element Nokogiri::XML::Node].include? request.class.to_s
+                  raise ::TypeError, 'request must be instance of Nokogiri XML node'
+              end
+              end
+
+              r = @given_responses[@response_count % @given_responses.size]
+
+              @response_count += 1
+
+              r
+            end
+            # rubocop:enable Metrics/MethodLength
+            # rubocop:todo Style/CommentedKeyword
+          end # class ReturnsGivenResponses
+          # rubocop:enable Style/CommentedKeyword
+          # rubocop:enable Style/Documentation
+          # rubocop:todo Style/CommentedKeyword
+        end # module RazorRequester
+        # rubocop:enable Style/CommentedKeyword
+      end
+    end
+  end
+end
+
+# ############################## end of file ############################# #

data/lib/razor_risk/razor/connectivity/test_doubles/razor_requester/stub.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+# ######################################################################## #
+# File:         lib/razor_risk/razor/connectivity/test_doubles/razor_requester/stub.rb
+#
+# Purpose:      Stub module
+#
+# Created:      14th August 2018
+# Updated:      14th August 2018
+#
+# Author:       Matthew Wilson
+#
+# Copyright (c) 2018, Razor Risk Technologies Pty Ltd
+# All rights reserved.
+#
+# ######################################################################## #
+
+require 'xqsr3/quality/parameter_checking'
+
+module RazorRisk
+  module Razor
+    module Connectivity
+      module TestDoubles
+        module RazorRequester
+          # Mixin for RazorRequester stubs, providing +config+, +environment+,
+          # +init_options+, +send_options+, +merge_options+, +latest_request+, as well
+          # as checking unknown initialisation options
+          module Stub
+            include ::Xqsr3::Quality::ParameterChecking
+
+            # Initialises the instance
+            #
+            # === Signature
+            #
+            # * *Parameters:*
+            # @param config (::String) The configuration
+            # @param environment (::String) The environment
+            # @param options (::Hash) Options
+            #
+            # * *Options:*
+            #
+            # @option +:exception+ (::Class) An exception class to be thrown. If not
+            #   specified an instance of +::RuntimeError+ will be thrown
+            # @option +:exception_message+ (::String) A string to be used as the
+            #   thrown exception's message. If not specified, the message
+            #   +'expected'+ will be used
+            #
+            def initialize(config, environment, **options)
+              if self.class.const_defined? :ACCEPTED_OPTIONS
+
+                invalid_options = options.keys - self.class::ACCEPTED_OPTIONS
+
+                unless invalid_options.empty?
+                  warn "#{self.class}##{__method__}() : options contains one or more invalid keys: #{invalid_options}"
+              end
+              end
+
+              @config = config
+
+              @environment = environment
+
+              @options = {}.merge options
+
+              @init_options = options.dup
+            end
+
+            # The +config+ passed to the initialiser
+            attr_reader :config
+            # The +environment+ passed to the initialiser
+            attr_reader :environment
+            # The options passed to the initialiser
+            attr_reader :init_options
+            # The options passed to the +send_request+
+            attr_reader :send_options
+            # The merging of +send_request+ options and initialiser options
+            attr_reader :merged_options
+
+            # Emulates a send-request, subject to the given options
+            #
+            # === Signature
+            #
+            # * *Parameters:*
+            #
+            # * *Options:*
+            #
+            # @option +:check_request+:: Determines whether the request should be
+            #   checked. If truey, then the following values are recognised: +:xml+
+            #   means that the request must be valid XML
+            def send_request(_request, **options)
+              @send_options = options.dup
+
+              @merged_options = @options.merge @send_options
+            end
+          end # module Stub # rubocop:todo Style/CommentedKeyword
+          # rubocop:todo Style/CommentedKeyword
+        end # module RazorRequester
+        # rubocop:enable Style/CommentedKeyword
+      end # module TestDoubles # rubocop:todo Style/CommentedKeyword
+    end # module Connectivity # rubocop:todo Style/CommentedKeyword
+  end
+end
+
+# ############################## end of file ############################# #

data/lib/razor_risk/razor/connectivity/test_doubles/razor_requester.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'razor_risk/razor/connectivity/test_doubles/razor_requester/raises_on_send'
+require 'razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_response'

data/lib/razor_risk/razor/connectivity/test_doubles/version.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# ##########################################################################
+#
+# Version for RazorRisk.Core.Razor.Connectivity.TestDoubles library
+#
+# Copyright (c) 2018 Razor Risk Technologies Pty Limited. All rights reserved.
+#
+# ##########################################################################
+
+module RazorRisk
+  module Razor
+    module Connectivity
+      module TestDoubles # rubocop:todo Style/Documentation
+        # Current version of the RazorRisk::Razor::Connectivity::TestDoubles library
+        VERSION = '0.4.5'
+
+        private # rubocop:todo Lint/UselessAccessModifier
+
+        VERSION_PARTS_ = VERSION.split(/[.]/).collect(&:to_i)
+
+        public # rubocop:todo Lint/UselessAccessModifier
+
+        # Major version of the RazorRisk::Razor::Connectivity::TestDoubles library
+        VERSION_MAJOR  = VERSION_PARTS_[0]
+        # Minor version of the RazorRisk::Razor::Connectivity::TestDoubles library
+        VERSION_MINOR  = VERSION_PARTS_[1]
+        # Patch version of the RazorRisk::Razor::Connectivity::TestDoubles library
+        VERSION_PATCH  = VERSION_PARTS_[2]
+        # Commit version of the RazorRisk::Razor::Connectivity::TestDoubles library
+        VERSION_COMMIT = VERSION_PARTS_[3] || 0
+
+        # The description of the framework
+        DESCRIPTION    = "Razor Risk's Cassini Web-framework's Initialisation Daemon"
+      end # module TestDoubles # rubocop:todo Style/CommentedKeyword
+    end # module Connectivity # rubocop:todo Style/CommentedKeyword
+  end # module Razor # rubocop:todo Style/CommentedKeyword
+end # module RazorRisk # rubocop:todo Style/CommentedKeyword
+
+# ############################## end of file ############################# #

data/test/unit/razor_requester/tc_raises_on_send.rb

@@ -0,0 +1,105 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: true
+
+# ##########################################################################
+#
+# Copyright (c) 2018 Razor Risk Technologies Pty Limited. All rights reserved.
+#
+# ##########################################################################
+
+# ##########################################################
+# load path
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), *(['..'] * 3), 'lib')
+
+# ##########################################################
+# diagnostics
+
+unless $DEBUG
+
+  require 'pantheios/globals'
+  require 'pantheios/services/null_log_service'
+
+  ::Pantheios::Globals.INITIAL_SERVICE_CLASSES = [::Pantheios::Services::NullLogService]
+end
+
+# ##########################################################
+# code coverage
+
+require 'simplecov'
+
+# ##########################################################
+# requires
+
+require 'razor_risk/razor/connectivity/test_doubles/razor_requester/raises_on_send'
+
+require 'xqsr3/extensions/test/unit'
+
+require 'test/unit'
+
+# ##########################################################
+# tests
+
+# rubocop:todo Style/Documentation
+# rubocop:todo Naming/ClassAndModuleCamelCase
+class Test_RazorRequester_RaisesOnSend_types_exist < Test::Unit::TestCase
+  include ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester
+
+  def test_has_RazorRisk_module # rubocop:todo Naming/MethodName
+    assert Object.const_defined? :RazorRisk
+  end
+
+  def test_has_RazorRisk_Risk_module # rubocop:todo Naming/MethodName
+    assert ::RazorRisk.const_defined? :Razor
+  end
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_module
+    assert ::RazorRisk::Razor.const_defined? :Connectivity
+  end
+  # rubocop:enable Naming/MethodName
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_TestDoubles_module
+    assert ::RazorRisk::Razor::Connectivity.const_defined? :TestDoubles
+  end
+  # rubocop:enable Naming/MethodName
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_TestDoubles_RazorRequester_module
+    assert ::RazorRisk::Razor::Connectivity::TestDoubles.const_defined? :RazorRequester
+  end
+  # rubocop:enable Naming/MethodName
+
+  def test_has_RaisesOnSend_class # rubocop:todo Naming/MethodName
+    assert ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester.const_defined? :RaisesOnSend
+  end
+
+  def test_has_RaisesOnSend_is_a_class # rubocop:todo Naming/MethodName
+    assert_kind_of ::Class, ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester::RaisesOnSend
+  end
+end
+# rubocop:enable Naming/ClassAndModuleCamelCase
+# rubocop:enable Style/Documentation
+
+# rubocop:todo Style/Documentation
+# rubocop:todo Naming/ClassAndModuleCamelCase
+class Test_RazorRequester_RaisesOnSend < Test::Unit::TestCase
+  include ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester
+
+  def test_raises_default_exception_and_default_message
+    assert_raise_with_message(::RuntimeError, 'expected') { RaisesOnSend.new(nil, nil).send_request(nil) }
+  end
+
+  def test_raises_default_exception_and_custom_message
+    assert_raise_with_message(::RuntimeError, 'unexpected') { RaisesOnSend.new(nil, nil, exception_message: 'unexpected').send_request(nil) }
+  end
+
+  def test_raises_custom_exception_and_default_message
+    assert_raise_with_message(::ArgumentError, 'expected') { RaisesOnSend.new(nil, nil, exception: ::ArgumentError).send_request(nil) }
+  end
+end
+# rubocop:enable Naming/ClassAndModuleCamelCase
+# rubocop:enable Style/Documentation
+
+# ############################## end of file ############################# #

data/test/unit/razor_requester/tc_returns_given_response.rb

@@ -0,0 +1,114 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: true
+
+# ##########################################################################
+#
+# Copyright (c) 2018 Razor Risk Technologies Pty Limited. All rights reserved.
+#
+# ##########################################################################
+
+# ##########################################################
+# load path
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), *(['..'] * 3), 'lib')
+
+# ##########################################################
+# diagnostics
+
+unless $DEBUG
+
+  require 'pantheios/globals'
+  require 'pantheios/services/null_log_service'
+
+  ::Pantheios::Globals.INITIAL_SERVICE_CLASSES = [::Pantheios::Services::NullLogService]
+end
+
+# ##########################################################
+# code coverage
+
+require 'simplecov'
+
+# ##########################################################
+# requires
+
+require 'razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_response'
+
+require 'xqsr3/extensions/test/unit'
+
+require 'test/unit'
+
+# ##########################################################
+# tests
+
+# rubocop:todo Style/Documentation
+# rubocop:todo Naming/ClassAndModuleCamelCase
+class Test_RazorRequester_ReturnsGivenResponse_types_exist < Test::Unit::TestCase
+  include ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester
+
+  def test_has_RazorRisk_module # rubocop:todo Naming/MethodName
+    assert Object.const_defined? :RazorRisk
+  end
+
+  def test_has_RazorRisk_Risk_module # rubocop:todo Naming/MethodName
+    assert ::RazorRisk.const_defined? :Razor
+  end
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_module
+    assert ::RazorRisk::Razor.const_defined? :Connectivity
+  end
+  # rubocop:enable Naming/MethodName
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_TestDoubles_module
+    assert ::RazorRisk::Razor::Connectivity.const_defined? :TestDoubles
+  end
+  # rubocop:enable Naming/MethodName
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_TestDoubles_RazorRequester_module
+    assert ::RazorRisk::Razor::Connectivity::TestDoubles.const_defined? :RazorRequester
+  end
+  # rubocop:enable Naming/MethodName
+
+  def test_has_ReturnsGivenResponse_class # rubocop:todo Naming/MethodName
+    assert ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester.const_defined? :ReturnsGivenResponse
+  end
+
+  # rubocop:todo Naming/MethodName
+  def test_has_ReturnsGivenResponse_is_a_class
+    assert_kind_of ::Class, ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester::ReturnsGivenResponse
+  end
+  # rubocop:enable Naming/MethodName
+end
+# rubocop:enable Naming/ClassAndModuleCamelCase
+# rubocop:enable Style/Documentation
+
+# rubocop:todo Style/Documentation
+# rubocop:todo Naming/ClassAndModuleCamelCase
+class Test_RazorRequester_ReturnsGivenResponse < Test::Unit::TestCase
+  include ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester
+
+  def test_send_request_with_invalid_input
+    assert_raise_with_message(::ArgumentError, /given_response.*nil/) { ReturnsGivenResponse.new('config', 'environment', given_response: nil) }
+    assert_raise_with_message(::ArgumentError, /given_response.*nil/) { ReturnsGivenResponse.new('config', 'environment', given_response: nil, allow_nil: false) }
+  end
+
+  # rubocop:todo Metrics/AbcSize
+  def test_send_request_with_various_simple_contents
+    assert_equal nil, ReturnsGivenResponse.new('config', 'environment', given_response: nil, allow_nil: true).send_request(nil)
+    assert_equal :contents, ReturnsGivenResponse.new('config', 'environment', given_response: :contents).send_request(nil)
+    assert_equal false, ReturnsGivenResponse.new('config', 'environment', given_response: false).send_request(nil)
+    assert_equal true, ReturnsGivenResponse.new('config', 'environment', given_response: true).send_request(nil)
+    assert_equal '', ReturnsGivenResponse.new('config', 'environment', given_response: '').send_request(nil)
+    assert_equal 'contents', ReturnsGivenResponse.new('config', 'environment', given_response: 'contents').send_request(nil)
+    assert_equal '<document />', ReturnsGivenResponse.new('config', 'environment', given_response: '<document />').send_request(nil)
+  end
+  # rubocop:enable Metrics/AbcSize
+
+  def test_; end
+end
+# rubocop:enable Naming/ClassAndModuleCamelCase
+# rubocop:enable Style/Documentation
+
+# ############################## end of file ############################# #

data/test/unit/razor_requester/tc_returns_given_responses.rb

@@ -0,0 +1,131 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: true
+
+# ##########################################################################
+#
+# Copyright (c) 2018 Razor Risk Technologies Pty Limited. All rights reserved.
+#
+# ##########################################################################
+
+# ##########################################################
+# load path
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), *(['..'] * 3), 'lib')
+
+# ##########################################################
+# diagnostics
+
+unless $DEBUG
+
+  require 'pantheios/globals'
+  require 'pantheios/services/null_log_service'
+
+  ::Pantheios::Globals.INITIAL_SERVICE_CLASSES = [::Pantheios::Services::NullLogService]
+end
+
+# ##########################################################
+# code coverage
+
+require 'simplecov'
+
+# ##########################################################
+# requires
+
+require 'razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_responses'
+
+require 'xqsr3/extensions/test/unit'
+
+require 'test/unit'
+
+# ##########################################################
+# tests
+
+# rubocop:todo Style/Documentation
+# rubocop:todo Naming/ClassAndModuleCamelCase
+class Test_RazorRequester_ReturnsGivenResponses_types_exist < Test::Unit::TestCase
+  include ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester
+
+  def test_has_RazorRisk_module # rubocop:todo Naming/MethodName
+    assert Object.const_defined? :RazorRisk
+  end
+
+  def test_has_RazorRisk_Risk_module # rubocop:todo Naming/MethodName
+    assert ::RazorRisk.const_defined? :Razor
+  end
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_module
+    assert ::RazorRisk::Razor.const_defined? :Connectivity
+  end
+  # rubocop:enable Naming/MethodName
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_TestDoubles_module
+    assert ::RazorRisk::Razor::Connectivity.const_defined? :TestDoubles
+  end
+  # rubocop:enable Naming/MethodName
+
+  # rubocop:todo Naming/MethodName
+  def test_has_RazorRisk_Risk_Connectivity_TestDoubles_RazorRequester_module
+    assert ::RazorRisk::Razor::Connectivity::TestDoubles.const_defined? :RazorRequester
+  end
+  # rubocop:enable Naming/MethodName
+
+  def test_has_ReturnsGivenResponses_class # rubocop:todo Naming/MethodName
+    assert ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester.const_defined? :ReturnsGivenResponses
+  end
+
+  # rubocop:todo Naming/MethodName
+  def test_has_ReturnsGivenResponses_is_a_class
+    assert_kind_of ::Class, ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester::ReturnsGivenResponses
+  end
+  # rubocop:enable Naming/MethodName
+end
+# rubocop:enable Naming/ClassAndModuleCamelCase
+# rubocop:enable Style/Documentation
+
+# rubocop:todo Style/Documentation
+# rubocop:todo Naming/ClassAndModuleCamelCase
+class Test_RazorRequester_ReturnsGivenResponses < Test::Unit::TestCase
+  include ::RazorRisk::Razor::Connectivity::TestDoubles::RazorRequester
+
+  def test_send_request_with_invalid_input
+    assert_raise_with_message(::ArgumentError, /given_responses.*nil/) { ReturnsGivenResponses.new('config', 'environment', given_responses: nil) }
+  end
+
+  # rubocop:todo Metrics/AbcSize
+  def test_send_request_with_various_simple_contents
+    assert_equal :contents, ReturnsGivenResponses.new('config', 'environment', given_responses: [:contents]).send_request(nil)
+    assert_equal false, ReturnsGivenResponses.new('config', 'environment', given_responses: [false]).send_request(nil)
+    assert_equal true, ReturnsGivenResponses.new('config', 'environment', given_responses: [true]).send_request(nil)
+    assert_equal '', ReturnsGivenResponses.new('config', 'environment', given_responses: ['']).send_request(nil)
+    assert_equal 'contents', ReturnsGivenResponses.new('config', 'environment', given_responses: ['contents']).send_request(nil)
+    assert_equal '<document />', ReturnsGivenResponses.new('config', 'environment', given_responses: ['<document />']).send_request(nil)
+  end
+  # rubocop:enable Metrics/AbcSize
+
+  def test_send_request_with_multiple_responses
+    rgr = ReturnsGivenResponses.new('config', 'environment', given_responses: %i[first_response second_response third_response])
+
+    assert_equal :first_response, rgr.send_request(nil)
+    assert_equal :second_response, rgr.send_request(nil)
+    assert_equal :third_response, rgr.send_request(nil)
+    assert_equal :first_response, rgr.send_request(nil)
+    assert_equal :second_response, rgr.send_request(nil)
+    assert_equal :third_response, rgr.send_request(nil)
+  end
+
+  def test_send_request_with_many_responses
+    rgr = ReturnsGivenResponses.new('config', 'environment', given_responses: (0..999).to_a)
+
+    10.times do
+      (0..999).each do |n|
+        assert_equal n, rgr.send_request(nil)
+      end
+    end
+  end
+end
+# rubocop:enable Naming/ClassAndModuleCamelCase
+# rubocop:enable Style/Documentation
+
+# ############################## end of file ############################# #

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: razorrisk-razor-connectivity-testdoubles
+version: !ruby/object:Gem::Version
+  version: 0.4.5
+platform: ruby
+authors:
+- Razor Risk
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2022-06-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: razorrisk-core-baseutilities
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: razorrisk-core-diagnostics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: pantheios-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.2
+- !ruby/object:Gem::Dependency
+  name: recls-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+- !ruby/object:Gem::Dependency
+  name: xqsr3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.30'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.30'
+description: Razor Risk's Cassini Web-framework's Initialisation Daemon
+email: operations@razor-risk.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Rakefile
+- lib/razor_risk/razor/connectivity/test_doubles/razor_requester.rb
+- lib/razor_risk/razor/connectivity/test_doubles/razor_requester/raises_on_send.rb
+- lib/razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_response.rb
+- lib/razor_risk/razor/connectivity/test_doubles/razor_requester/returns_given_responses.rb
+- lib/razor_risk/razor/connectivity/test_doubles/razor_requester/stub.rb
+- lib/razor_risk/razor/connectivity/test_doubles/version.rb
+- test/unit/razor_requester/tc_raises_on_send.rb
+- test/unit/razor_requester/tc_returns_given_response.rb
+- test/unit/razor_requester/tc_returns_given_responses.rb
+homepage: https://razor-risk.com/
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14
+signing_key: 
+specification_version: 4
+summary: RazorRisk.Core.Razor.Connectivity.TestDoubles
+test_files: []