lib/soaspec/exchange_handlers/exchange_handler.rb in soaspec-0.0.87 vs lib/soaspec/exchange_handlers/exchange_handler.rb in soaspec-0.0.88

- old
+ new

@@ -1,104 +1,104 @@ - -require_relative 'handler_accessors' - -module Soaspec - - # Inherit this for a class describing how to implement a particular exchange. - # Has basic methods common for methods defining RSpec tests in YAML - class ExchangeHandler - extend Soaspec::HandlerAccessors - - # Retrieve the name of the template file to be used in the API request - attr_reader :template_name - - # Explicitly defined elements for which a path has been predefined - def elements - public_methods.select { |i| i[/__custom_path_.+/] } - end - - # Set the default hash representing data to be used in making a request - # This will set the @request_option instance variable too - def default_hash=(hash) - @request_option = :hash - @default_hash = Soaspec.always_use_keys? ? hash.transform_keys_to_symbols : hash - end - - # Set instance variable name - # @param [String, Symbol] name Name used when describing API test - # @param [Hash] options Parameters defining handler. Used in descendants - def initialize(name = self.class.to_s, options = {}) - use - @name = name - end - - # Set Api handler used by Exchange class to this handler - # @return [Self] - def use - Soaspec.api_handler = self - self - end - - # Sets api handler variable globally. This is used in 'Exchange' class - # @return [String] Name set upon initialisation - def to_s - use - @name.to_s - end - - # Set the request option type and the template name - # Erb is used to parse the template file, executing Ruby code in `<%= %>` blocks to work out the final request - # @param [String] name Name of file inside 'template' folder excluding extension - def template_name=(name) - @request_option = :template - @template_name = name - end - - # Will be used in 'success_scenarios' shared examples. - # Set though 'mandatory_elements' method - # @return [Array] Array of symbols specifying element names - def expected_mandatory_elements - [] - end - - # Change this through 'mandatory_xpath_values' method to specify xpath results that must be present in the response - # Will be used in 'success_scenarios' shared examples - # @return [Hash] Hash of 'xpath' => 'expected value' pairs - def expected_mandatory_xpath_values - {} - end - - # Change this through 'mandatory_json_values' method to specify json results that must be present in the response - # Will be used in 'success_scenarios' shared examples - # @return [Hash] Hash of 'json/path' => 'expected value' pairs - def expected_mandatory_json_values - {} - end - - # @return [Boolean] Whether all xpaths will be done with XML that is converted to lower case - def convert_to_lower? - false - end - - # Stores a value in a method that can be accessed by the provided name - # @param [Symbol] name Name of method to use to access this value within handler - # @param [String] value Value to store - def store(name, value) - define_singleton_method('__stored_val__' + name.to_s) do - value - end - end - - # Set instance variable and remove it from Hash - def set_remove_key(hash, key) - return unless hash.key? key - __send__("#{key}=", hash[key]) - hash.delete key - end - - # @return [Boolean] Whether to remove namespaces in xpath assertion automatically - def strip_namespaces? - false - end - - end + +require_relative 'handler_accessors' + +module Soaspec + + # Inherit this for a class describing how to implement a particular exchange. + # Has basic methods common for methods defining RSpec tests in YAML + class ExchangeHandler + extend Soaspec::HandlerAccessors + + # Retrieve the name of the template file to be used in the API request + attr_reader :template_name + + # Explicitly defined elements for which a path has been predefined + def elements + public_methods.select { |i| i[/__custom_path_.+/] } + end + + # Set the default hash representing data to be used in making a request + # This will set the @request_option instance variable too + def default_hash=(hash) + @request_option = :hash + @default_hash = Soaspec.always_use_keys? ? hash.transform_keys_to_symbols : hash + end + + # Set instance variable name + # @param [String, Symbol] name Name used when describing API test + # @param [Hash] options Parameters defining handler. Used in descendants + def initialize(name = self.class.to_s, options = {}) + use + @name = name + end + + # Set Api handler used by Exchange class to this handler + # @return [Self] + def use + Soaspec.api_handler = self + self + end + + # Sets api handler variable globally. This is used in 'Exchange' class + # @return [String] Name set upon initialisation + def to_s + use + @name.to_s + end + + # Set the request option type and the template name + # Erb is used to parse the template file, executing Ruby code in `<%= %>` blocks to work out the final request + # @param [String] name Name of file inside 'template' folder excluding extension + def template_name=(name) + @request_option = :template + @template_name = name + end + + # Will be used in 'success_scenarios' shared examples. + # Set though 'mandatory_elements' method + # @return [Array] Array of symbols specifying element names + def expected_mandatory_elements + [] + end + + # Change this through 'mandatory_xpath_values' method to specify xpath results that must be present in the response + # Will be used in 'success_scenarios' shared examples + # @return [Hash] Hash of 'xpath' => 'expected value' pairs + def expected_mandatory_xpath_values + {} + end + + # Change this through 'mandatory_json_values' method to specify json results that must be present in the response + # Will be used in 'success_scenarios' shared examples + # @return [Hash] Hash of 'json/path' => 'expected value' pairs + def expected_mandatory_json_values + {} + end + + # @return [Boolean] Whether all xpaths will be done with XML that is converted to lower case + def convert_to_lower? + false + end + + # Stores a value in a method that can be accessed by the provided name + # @param [Symbol] name Name of method to use to access this value within handler + # @param [String] value Value to store + def store(name, value) + define_singleton_method('__stored_val__' + name.to_s) do + value + end + end + + # Set instance variable and remove it from Hash + def set_remove_key(hash, key) + return unless hash.key? key + __send__("#{key}=", hash[key]) + hash.delete key + end + + # @return [Boolean] Whether to remove namespaces in xpath assertion automatically + def strip_namespaces? + false + end + + end end \ No newline at end of file