apimatic_core 0.1.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c581361453ae63c619ca7b7bcc5b2e4cb5cd2afe4ab1f7584462a0698ab8be3d
-  data.tar.gz: 51c745d2ac8600da653324628f1cf4e00e2059ceb12e22f150f49ec2ed3a9f03
+  metadata.gz: d29b21091f739c5f0023b01fd70b174a41b6b25637248a02f5be3283874a25eb
+  data.tar.gz: f21de623d02c62af2818602f81657983883d0885187836e609b16ddf890d0d3c
 SHA512:
-  metadata.gz: 1a87d5f62193c6f46e4fda2289d5c4a8cae5d716ee35723f030d6ad97ffc569ffec23019e89065a5882ea806aec791ea121bc8f0e326496a923a49feb0c1b484
-  data.tar.gz: 44acde48930a6e621608d30fb646e9f467e0fba89c07520016e55e2b017b17f239ede9bcc0de1e79537e5303da469b91f1fd2f1844a212f10bd92a40b48cd103
+  metadata.gz: abd28994bd548acfd533bcdd1879d2d8c5ebf67198b97d3172f559d537a1ea9e688c0b5ff076849c4d818d32389814f0b5e42090d11aaf3866de73e626ff1ea6
+  data.tar.gz: 011162e182da68a14d8e820ddf3ca2932f2658afc0e2a15836f042a02d104476888d90c4ce0932f6d47ee8e3df5c5bc23b489bd16bf9f628551ff9183492dcf9

data/LICENSE

@@ -1,26 +1,21 @@
-APIMATIC REFERENCE SOURCE LICENSE
-
-This license governs the use of the accompanying software. If you use the software, you accept this license. If you do not accept the license, do not use the software.
-
-1. Definitions
-The terms "reproduce," "reproduction" and "distribution" have the same meaning here as under U.S. copyright law.
-
-"You" means the licensee of the software.
-
-"Your company" means the company you worked for when you downloaded the software.
-
-"Reference use" means the use of the software within your company as a reference, in read-only form, for the sole purposes of debugging your products, maintaining your products, or enhancing the interoperability of your products with the software, and specifically excludes the right to distribute the software outside of your company.
-
-"Licensed patents" means any Licensor patent claims which read directly on the software as distributed by the Licensor under this license.
-
-2. Grant of Rights
-(A) Copyright Grant- Subject to the terms of this license, the Licensor grants you a non-transferable, non-exclusive, worldwide, royalty-free copyright license to reproduce the software for reference use.
-
-(B) Patent Grant- Subject to the terms of this license, the Licensor grants you a non-transferable, non-exclusive, worldwide, royalty-free patent license under licensed patents for reference use.
-
-3. Limitations
-(A) No Trademark License- This license does not grant you any rights to use the Licensor's name, logo, or trademarks.
-
-(B) If you begin patent litigation against the Licensor over patents that you think may apply to the software (including a cross-claim or counterclaim in a lawsuit), your license to the software ends automatically.
-
-(C) The software is licensed "as-is." You bear the risk of using it. The Licensor gives no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the Licensor excludes the implied warranties of merchantability, fitness for a particular purpose and non-infringement.
+MIT License
+
+Copyright (c) 2023 APIMatic Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,8 +1,8 @@
 # apimatic-core
-[//]: # ([![PyPI][rubygems-version]][rubygems-apimatic-faraday-client-adapter-url])
+
+[![Gem Version](https://badge.fury.io/rb/apimatic_core.svg)](https://badge.fury.io/rb/apimatic_core)
 [![Tests][test-badge]][test-url]
 [![Linting][lint-badge]][lint-url]
-[![Maintainability][maintainability-url]][code-climate-url]
 [![Test Coverage][test-coverage-url]][code-climate-url]
 [![Ruby Style Guide](https://img.shields.io/badge/code_style-rubocop-brightgreen.svg)](https://github.com/rubocop/rubocop)
 [![Licence][license-badge]][license-url]
@@ -86,10 +86,8 @@ gem 'apimatic_core'
 | [`XmlHelper`](lib/apimatic-core/utilities/xml_helper.rb )              | A Helper class that holds utility methods for xml serialization and deserialization. |
 
 ## Links
-* [apimatic_core_interfaces](link here)
+* [apimatic_core_interfaces](https://rubygems.org/gems/apimatic_core_interfaces)
 
-[rubygems-version]: https://img.shields.io/pypi/v/apimatic-requests-client-adapter
-[rubygems-apimatic-faraday-client-adapter-url]: https://pypi.org/project/apimatic-requests-client-adapter/
 [test-badge]: https://github.com/apimatic/core-lib-ruby/actions/workflows/test-runner.yml/badge.svg
 [test-url]: https://github.com/apimatic/core-lib-ruby/actions/workflows/test-runner.yml
 [lint-badge]: https://github.com/apimatic/core-lib-ruby/actions/workflows/lint-runner.yml/badge.svg
@@ -97,5 +95,5 @@ gem 'apimatic_core'
 [code-climate-url]: https://codeclimate.com/github/apimatic/core-lib-ruby
 [maintainability-url]: https://api.codeclimate.com/v1/badges/85d658cd4e879f057e7d/maintainability
 [test-coverage-url]: https://api.codeclimate.com/v1/badges/85d658cd4e879f057e7d/test_coverage
-[license-badge]: https://img.shields.io/badge/licence-APIMATIC-blue
+[license-badge]: https://img.shields.io/badge/licence-MIT-blue
 [license-url]: LICENSE

data/lib/apimatic-core/api_call.rb

@@ -7,6 +7,9 @@ module CoreLibrary
       ApiCall.new(@global_configuration, logger: @endpoint_logger.logger)
     end
 
+    # Initializes a new instance of ApiCall.
+    # @param [GlobalConfiguration] global_configuration An instance of GlobalConfiguration.
+    # @param logger An optional logger to log execution of program.
     def initialize(global_configuration, logger: nil)
       @global_configuration = global_configuration
       @request_builder = RequestBuilder.new

data/lib/apimatic-core/authentication/header_auth.rb

@@ -1,6 +1,8 @@
 module CoreLibrary
   # This class is responsible for adding authentication in request header parameter.
   class HeaderAuth < Authentication
+    # Initializes a new instance of HeaderAuth.
+    # @param [Hash] auth_params Auth params for header auth.
     def initialize(auth_params)
       @auth_params = auth_params
       @error_message = nil

data/lib/apimatic-core/authentication/multiple/and_auth_group.rb

@@ -7,6 +7,8 @@ module CoreLibrary
       @error_messages.join(' and ')
     end
 
+    # Initializes a new instance of And.
+    # @param [String | AuthGroup] auth_group AuthGroup instance or string.
     def initialize(*auth_group)
       super auth_group
       @is_valid_group = true

data/lib/apimatic-core/authentication/multiple/auth_group.rb

@@ -4,6 +4,8 @@ module CoreLibrary
   class AuthGroup < Authentication
     attr_accessor :auth_participants, :mapped_group, :error_messages, :is_valid_group
 
+    # Initializes a new instance of AuthGroup.
+    # @param [String | AuthGroup] auth_group AuthGroup instance or string.
     def initialize(auth_group)
       @auth_participants = []
       auth_group.each do |auth_participant|

data/lib/apimatic-core/authentication/multiple/or_auth_group.rb

@@ -7,6 +7,8 @@ module CoreLibrary
       @error_messages.join(' or ')
     end
 
+    # Initializes a new instance of Or.
+    # @param [String | AuthGroup] auth_group AuthGroup instance or string.
     def initialize(*auth_group)
       super auth_group
       @is_valid_group = false

data/lib/apimatic-core/authentication/multiple/single_auth.rb

@@ -7,6 +7,8 @@ module CoreLibrary
       "[#{@error_message}]"
     end
 
+    # Initializes a new instance of Single.
+    # @param [String] auth_participant Auth participant name.
     def initialize(auth_participant)
       @auth_participant = auth_participant
       @mapped_auth = nil

data/lib/apimatic-core/authentication/query_auth.rb

@@ -1,6 +1,8 @@
 module CoreLibrary
   # This class is responsible for adding authentication in request query parameter.
   class QueryAuth < Authentication
+    # Initializes a new instance of QueryAuth.
+    # @param [Hash] auth_params Auth params for query auth.
     def initialize(auth_params)
       @auth_params = auth_params
       @error_message = nil

data/lib/apimatic-core/configurations/global_configuration.rb

@@ -3,6 +3,8 @@ module CoreLibrary
   class GlobalConfiguration
     attr_reader :client_configuration
 
+    # Initializes a new instance of GlobalConfiguration.
+    # @param [HttpClientConfiguration] client_configuration Current HttpClientConfiguration.
     def initialize(client_configuration: HttpClientConfiguration.new)
       @client_configuration = client_configuration
       @global_errors = {}
@@ -29,11 +31,14 @@ module CoreLibrary
     end
 
     # Sets the current SDK module core library is being used for.
+    # @return [GlobalConfiguration] Current Instance.
     def sdk_module(sdk_module)
       @sdk_module = sdk_module
       self
     end
 
+    # Getter for the current SDK module the core library is being used for.
+    # @return [Module] Current SDK module.
     def get_sdk_module
       @sdk_module
     end

data/lib/apimatic-core/http/configurations/http_client_configuration.rb

@@ -3,6 +3,19 @@ module CoreLibrary
   class HttpClientConfiguration < ClientConfiguration
     attr_reader :http_client, :http_callback
 
+    # Initializes a new instance of HttpClientConfiguration.
+    # @param connection Connection information
+    # @param adapter Adapter configuration
+    # @param [Integer] timeout Timeout value
+    # @param [Integer] max_retries Max retries values
+    # @param [Integer] retry_interval Retry interval value, in seconds
+    # @param [Integer] backoff_factor Backoff factor
+    # @param [Array] retry_statuses An integer array of http status codes
+    # @param [Hash] retry_methods A string array of methods
+    # @param [Boolean] cache Should cache be enabled
+    # @param [Boolean] verify Should verification be enabled.
+    # @param http_callback A method to be used as http callback
+    # @param [HttpClient] http_client An instance of HttpClient
     def initialize(
       connection: nil, adapter: :net_http_persistent, timeout: 60,
       max_retries: 0, retry_interval: 1, backoff_factor: 2,

data/lib/apimatic-core/logger/endpoint_logger.rb

@@ -3,6 +3,8 @@ module CoreLibrary
   class EndpointLogger
     attr_reader :logger
 
+    # Initializes a new instance of EndpointLogger.
+    # @param logger A logger with methods info, debug and error.
     def initialize(logger)
       @logger = logger
     end

data/lib/apimatic-core/request_builder.rb

@@ -1,6 +1,7 @@
 module CoreLibrary
   # This class is the builder of the http request for an API call.
   class RequestBuilder
+    # Creates an instance of RequestBuilder.
     def initialize
       @server = nil
       @path = nil

data/lib/apimatic-core/response_handler.rb

@@ -1,6 +1,7 @@
 module CoreLibrary
-  # This class is for handling of the http response for an API call.
+  # Creates an instance of ResponseHandler.
   class ResponseHandler
+    # Creates an instance of ResponseHandler.
     def initialize
       @deserializer = nil
       @convertor = nil
@@ -44,13 +45,27 @@ module CoreLibrary
       self
     end
 
-    # Sets local_errors hash key value.
+    # Registers an entry with error message in the local errors hash.
     # @param [String] error_code The error code to check against.
-    # @param [String] description The reason for the exception.
+    # @param [String] error_message The reason for the exception.
     # @param [ApiException] exception_type The type of the exception to raise.
     # @return [ResponseHandler] An updated instance of ResponseHandler.
-    def local_error(error_code, description, exception_type)
-      @local_errors[error_code.to_s] = ErrorCase.new.description(description).exception_type(exception_type)
+    def local_error(error_code, error_message, exception_type)
+      @local_errors[error_code.to_s] = ErrorCase.new
+                                                .error_message(error_message)
+                                                .exception_type(exception_type)
+      self
+    end
+
+    # Registers an entry with error template in the local errors hash.
+    # @param [String] error_code The error code to check against.
+    # @param [String] error_message_template The reason template for the exception.
+    # @param [ApiException] exception_type The type of the exception to raise.
+    # @return [ResponseHandler] An updated instance of ResponseHandler.
+    def local_error_template(error_code, error_message_template, exception_type)
+      @local_errors[error_code.to_s] = ErrorCase.new
+                                                .error_message_template(error_message_template)
+                                                .exception_type(exception_type)
       self
     end
 
@@ -186,34 +201,16 @@ module CoreLibrary
     end
     # rubocop:enable Style/OptionalBooleanParameter
 
-    # Validates the response provided and throws an error from global_errors if it fails.
-    # @param response The received response.
-    # @param global_errors Global errors hash.
+    # Validates the response provided and throws an error against the configured status code.
+    # @param [HttpResponse] response The received response.
+    # @param [Hash] global_errors Global errors hash.
+    # @raise [ApiException] Throws the exception when the response contains errors.
     def validate(response, global_errors)
-      return unless response.status_code < 200 || response.status_code > 208
-
-      actual_status_code = response.status_code.to_s
-
-      contains_local_errors = (!@local_errors.nil? and !@local_errors[actual_status_code].nil?)
-      if contains_local_errors
-        error_case = @local_errors[actual_status_code]
-        raise error_case.get_exception_type.new error_case.get_description, response
-      end
-
-      contains_local_default_error = (!@local_errors.nil? and !@local_errors['default'].nil?)
-      if contains_local_default_error
-        error_case = @local_errors['default']
-        raise error_case.get_exception_type.new error_case.get_description, response
-      end
+      return unless response.status_code < 200 || response.status_code > 299
 
-      contains_global_errors = (!global_errors.nil? and !global_errors[actual_status_code].nil?)
-      if contains_global_errors
-        error_case = global_errors[actual_status_code]
-        raise error_case.get_exception_type.new error_case.get_description, response
-      end
+      validate_against_error_cases(response, @local_errors)
 
-      error_case = global_errors['default']
-      raise error_case.get_exception_type.new error_case.get_description, response unless error_case.nil?
+      validate_against_error_cases(response, global_errors)
     end
 
     # Applies xml deserializer to the response.
@@ -265,5 +262,31 @@ module CoreLibrary
 
       deserialized_value
     end
+
+    # Validates the response against the provided error cases hash, if matches, it raises the exception.
+    # @param [HttpResponse] response The received response.
+    # @param [Hash] error_cases The error cases hash.
+    # @raise [ApiException] Raises the APIException when configured error code matches.
+    def validate_against_error_cases(response, error_cases)
+      actual_status_code = response.status_code.to_s
+
+      # Handling error case when configured as explicit error code
+      error_case = error_cases[actual_status_code]
+      error_case&.raise_exception(response)
+
+      # Handling error case when configured as explicit error codes range
+      default_range_entry = error_cases&.filter do |error_code, _|
+        error_code.match?("^#{actual_status_code[0]}XX$")
+      end
+
+      default_range_error_case = default_range_entry&.map { |_, error_case_instance| error_case_instance }
+
+      default_range_error_case[0].raise_exception(response) unless
+        default_range_error_case.nil? || default_range_error_case.empty?
+
+      # Handling default error case if configured
+      default_error_case = error_cases['default']
+      default_error_case&.raise_exception(response)
+    end
   end
 end

data/lib/apimatic-core/types/error_case.rb

@@ -1,23 +1,27 @@
 module CoreLibrary
   # This data class represents the expected errors to be handled after the API call.
   class ErrorCase
+    # Initializes a new instance of ErrorCase.
     def initialize
-      @description = nil
+      @error_message = nil
+      @error_message_template = nil
       @exception_type = nil
     end
 
     # The setter for the description of the error message.
-    # @param [String] description The description of the error message.
+    # @param [String] error_message The error message.
     # @return [ErrorCase] An updated instance of ErrorCase.
-    def description(description)
-      @description = description
+    def error_message(error_message)
+      @error_message = error_message
       self
     end
 
-    # The getter for the description of the error message.
-    # @return [String] The description of the error message.
-    def get_description
-      @description
+    # The setter for the description of the error message.
+    # @param [String] error_message_template The error message template.
+    # @return [ErrorCase] An updated instance of ErrorCase.
+    def error_message_template(error_message_template)
+      @error_message_template = error_message_template
+      self
     end
 
     # The setter for the type of the exception to be thrown.
@@ -28,10 +32,48 @@ module CoreLibrary
       self
     end
 
-    # The getter for the type of the exception to be thrown.
-    # @return [Object] The type of the exception to be thrown.
-    def get_exception_type
-      @exception_type
+    # Getter for the error message for the exception case. This considers both error message
+    # and error template message. Error message template has the higher precedence over an error message.
+    # @param response The received http response.
+    # @return [String] The resolved exception message.
+    def get_error_message(response)
+      return _get_resolved_error_message_template(response) unless @error_message_template.nil?
+
+      @error_message
+    end
+
+    # Raises the exception for the current error case type.
+    # @param response The received response.
+    def raise_exception(response)
+      raise @exception_type.new get_error_message(response), response
+    end
+
+    # Updates all placeholders in the given message template with provided value.
+    # @param response The received http response.
+    # @return [String] The resolved template message.
+    def _get_resolved_error_message_template(response)
+      placeholders = @error_message_template.scan(/{\$.*?\}/)
+
+      status_code_placeholder = placeholders.select { |element| element == '{$statusCode}' }.uniq
+      header_placeholders = placeholders.select { |element| element.start_with?('{$response.header') }.uniq
+      body_placeholders = placeholders.select { |element| element.start_with?('{$response.body') }.uniq
+
+      # Handling response code placeholder
+      error_message_template = ApiHelper.resolve_template_placeholders(status_code_placeholder,
+                                                                       response.status_code.to_s,
+                                                                       @error_message_template)
+
+      # Handling response header placeholder
+      error_message_template = ApiHelper.resolve_template_placeholders(header_placeholders, response.headers,
+                                                                       error_message_template)
+
+      # Handling response body placeholder
+      response_payload = ApiHelper.json_deserialize(response.raw_body, true)
+      error_message_template = ApiHelper.resolve_template_placeholders_using_json_pointer(body_placeholders,
+                                                                                          response_payload,
+                                                                                          error_message_template)
+
+      error_message_template
     end
   end
 end

data/lib/apimatic-core/types/parameter.rb

@@ -1,6 +1,7 @@
 module CoreLibrary
   # This data class represents the parameter to be sent in the request.
   class Parameter
+    # Initializes a new instance of Parameter.
     def initialize
       @key = nil
       @value = nil
@@ -87,12 +88,16 @@ module CoreLibrary
       @default_content_type
     end
 
-    # Template in case of oneOf or anyOf
+    # Template setter in case of oneOf or anyOf.
+    # @param [String] template Template for the parameter.
+    # @return [Parameter] An updated instance of Parameter.
     def template(template)
       @template = template
       self
     end
 
+    # Template getter in case a template is set.
+    # @return [Parameter] Returns template for the parameter.
     def get_template
       @template
     end

data/lib/apimatic-core/types/sdk/file_wrapper.rb

@@ -3,6 +3,9 @@ module CoreLibrary
   class FileWrapper
     attr_reader :content_type, :file
 
+    # Initializes a new instance of FileWrapper.
+    # @param [File] file File to enclose within file wrapper.
+    # @param [String] content_type Content type of file.
     def initialize(file, content_type: 'application/octet-stream')
       @file = file
       @content_type = content_type

data/lib/apimatic-core/types/xml_attributes.rb

@@ -1,35 +1,45 @@
 module CoreLibrary
   # The class to hold the configuration for XML parameter in request and response.
   class XmlAttributes
+    # Initializes a new instance of XmlAttributes.
     def initialize
       @value = nil
       @root_element_name = nil
       @array_item_name = nil
     end
 
+    # Value setter for XML parameter.
+    # @return [XmlAttributes] An updated instance of XmlAttributes.
     def value(value)
       @value = value
       self
     end
 
+    # Setter for root_element_name of XmlAttributes.
+    # @return [XmlAttributes] An updated instance of XmlAttributes.
     def root_element_name(root_element_name)
       @root_element_name = root_element_name
       self
     end
 
+    # Setter for array item name in XmlAttributes.
+    # @return [XmlAttributes] An updated instance of XmlAttributes.
     def array_item_name(array_item_name)
       @array_item_name = array_item_name
       self
     end
 
+    # Getter for root element of XmlAttributes.
     def get_root_element_name
       @root_element_name
     end
 
+    # Getter for value of XmlAttributes.
     def get_value
       @value
     end
 
+    # Getter for the set array item name in XmlAttributes.
     def get_array_item_name
       @array_item_name
     end

data/lib/apimatic-core/utilities/api_helper.rb

@@ -1,4 +1,6 @@
 require 'erb'
+require 'json-pointer'
+
 module CoreLibrary
   # API utility class involved in executing an API
   class ApiHelper
@@ -230,9 +232,13 @@ module CoreLibrary
     # @param [String] json A JSON string.
     # rubocop:disable Style/OptionalBooleanParameter
     def self.json_deserialize(json, should_symbolize = false)
-      JSON.parse(json, symbolize_names: should_symbolize)
-    rescue StandardError
-      raise TypeError, 'Server responded with invalid JSON.'
+      return if json.nil?
+
+      begin
+        JSON.parse(json, symbolize_names: should_symbolize)
+      rescue StandardError
+        raise TypeError, 'Server responded with invalid JSON.'
+      end
     end
     # rubocop:enable Style/OptionalBooleanParameter
 
@@ -547,5 +553,54 @@ module CoreLibrary
        TrueClass, FalseClass, Date,
        DateTime, Array, Hash, Object]
     end
+
+    # Updates all placeholders in the given message template with provided value.
+    # @param [String] placeholders The placeholders that need to be searched and replaced in the given template value.
+    # @param [String] value The dictionary containing the actual values to replace with.
+    # @param [String] template The template string containing placeholders.
+    # @@return [String] The resolved template value.
+    def self.resolve_template_placeholders_using_json_pointer(placeholders, value, template)
+      placeholders.each do |placeholder|
+        extracted_value = ''
+        if placeholder.include? '#'
+          # pick the 2nd chunk then remove the last character (i.e. `}`) of the string value
+          node_pointer = placeholder.split('#')[1].delete_suffix('}')
+          value_pointer = JsonPointer.new(value, node_pointer, symbolize_keys: true)
+          extracted_value = json_serialize(value_pointer.value) if value_pointer.exists?
+        elsif !value.nil?
+          extracted_value = json_serialize(value)
+        end
+        template.gsub!(placeholder, extracted_value)
+      end
+
+      template
+    end
+
+    # Updates all placeholders in the given message template with provided value.
+    # @param [List] placeholders The placeholders that need to be searched and replaced in the given template value.
+    # @param [Hash|String] values The value which refers to the actual values to replace with.
+    # @param [String] template The template string containing placeholders.
+    # @@return [String] The resolved template value.
+    def self.resolve_template_placeholders(placeholders, values, template)
+      values = values.map { |key, value| [key.to_s, value.to_s] }.to_h if values.is_a? Hash
+
+      placeholders.each do |placeholder|
+        extracted_value = ''
+        if values.is_a? Hash
+          # pick the last chunk then strip the last character (i.e. `}`) of the string value
+          key = if placeholder.include? '.'
+                  placeholder.split('.')[-1].delete_suffix('}')
+                else
+                  placeholder.delete_prefix('{').delete_suffix('}')
+                end
+          extracted_value = values[key] unless values[key].nil?
+        else
+          extracted_value = values unless values.nil?
+        end
+        template.gsub!(placeholder, extracted_value.to_s)
+      end
+
+      template
+    end
   end
 end

data/lib/apimatic-core/utilities/comparison_helper.rb

@@ -2,7 +2,7 @@ module CoreLibrary
   # A utility that perform the comparison of the Response body and headers.
   class ComparisonHelper
 
-    # Class method to compare the received headers with the expected headers.
+    # Compares the received headers with the expected headers.
     # @param [Hash] expected_headers A hash of expected headers (keys in lower case).
     # @param [Hash] actual_headers A hash of actual headers.
     # @param [Boolean, optional] allow_extra A flag which determines if we allow extra headers.
@@ -24,7 +24,7 @@ module CoreLibrary
       return true
     end
 
-    # Class method to compare the received body with the expected body.
+    # Compares the received body with the expected body.
     # @param [Dynamic] expected_body The expected body.
     # @param [Dynamic] actual_body The actual body.
     # @param [Boolean, optional] check_values A flag which determines if we check values in dictionaries.

data/lib/apimatic-core/utilities/xml_helper.rb

@@ -4,9 +4,10 @@ module CoreLibrary
   # A utility class for handling xml parsing.
   class XmlHelper
     class << self
-      # Serialized the provided value to XML.
-      # @param root_element_name Root element for the XML provided.
-      # @param value Value to convert to XML.
+      # Serializes the provided value to XML.
+      # @param [String] root_element_name Root element for the XML provided.
+      # @param [String] value Value to convert to XML.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format The format to convert the date time into.
       def serialize_to_xml(root_element_name, value, datetime_format: nil)
         doc = Nokogiri::XML::Document.new
         add_as_subelement(doc, doc, root_element_name, value,
@@ -14,10 +15,11 @@ module CoreLibrary
         doc.to_xml
       end
 
-      # Serialized the provided array value to XML.
-      # @param root_element_name Root element for the xml provided.
-      # @param item_name Item name for XML.
+      # Serializes the provided array value to XML.
+      # @param [String] root_element_name Root element for the xml provided.
+      # @param [String] item_name Item name for XML.
       # @param value Value to convert to XML.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format The format to convert the date time into.
       def serialize_array_to_xml(root_element_name, item_name, value,
                                  datetime_format: nil)
         doc = Nokogiri::XML::Document.new
@@ -27,8 +29,10 @@ module CoreLibrary
         doc.to_xml
       end
 
-      # Serialized the provided hash to XML.
-      # @param root_element_name Root element for the XML provided.
+      # Serializes the provided hash to XML.
+      # @param [string] root_element_name Root element for the XML provided.
+      # @param [Hash] entries Entries to convert to XML.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format The format to convert the date time into.
       def serialize_hash_to_xml(root_element_name, entries,
                                 datetime_format: nil)
         doc = Nokogiri::XML::Document.new
@@ -38,6 +42,10 @@ module CoreLibrary
       end
 
       # Adds the value as an attribute.
+      # @param [REXML::Element] root Root element of the XML to add the attribute to.
+      # @param [string] name Attribute name.
+      # @param [string] value Attribute value.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format The format to convert the date time into.
       def add_as_attribute(root, name, value, datetime_format: nil)
         return if value.nil?
 
@@ -47,6 +55,11 @@ module CoreLibrary
       end
 
       # Adds hash as a sub-element.
+      # @param [Nokogiri::XML::Document] doc Document to add the hash to.
+      # @param [REXML::Element] root Root element of the XML to add the attribute to.
+      # @param [string] name Attribute name.
+      # @param [Hash] entries Hash to add as value.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format The format to convert the date time into.
       def add_hash_as_subelement(doc, root, name, entries,
                                  datetime_format: nil)
         return if entries.nil?
@@ -61,6 +74,12 @@ module CoreLibrary
       end
 
       # Adds array as a sub-element.
+      # @param [Nokogiri::XML::Document] doc Document to add the hash to.
+      # @param [REXML::Element] root Root element of the XML to add the attribute to.
+      # @param [String] item_name Individual array item names.
+      # @param [Array] items Array of items.
+      # @param [String] wrapping_element_name Main array item name.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format The format to convert the date time into.
       def add_array_as_subelement(doc, root, item_name, items,
                                   wrapping_element_name: nil,
                                   datetime_format: nil)
@@ -80,6 +99,11 @@ module CoreLibrary
       end
 
       # Adds as a sub-element.
+      # @param [Nokogiri::XML::Document] doc Document to add the hash to.
+      # @param [REXML::Element] root Root element of the XML to add the attribute to.
+      # @param [String] name Item name.
+      # @param [Array] value Item value.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format The format to convert the date time into.
       def add_as_subelement(doc, root, name, value, datetime_format: nil)
         return if value.nil?
 
@@ -95,8 +119,8 @@ module CoreLibrary
       end
 
       # Converts datetime to string of a specific format.
-      # @param value Value to convert to string.
-      # @param datetime_format Datetime format for the converted string.
+      # @param [DateTime] value Value to convert to string.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format Datetime format to use for conversion..
       def datetime_to_s(value, datetime_format)
         case datetime_format
         when 'UnixDateTime'
@@ -109,9 +133,10 @@ module CoreLibrary
       end
 
       # Deserializes XML to a specific class.
-      # @param xml The XML value to deserialize.
-      # @param root_element_name Root element name for the XML provided.
-      # @param clazz The class to convert the XML into.
+      # @param [String] xml The XML value to deserialize.
+      # @param [String] root_element_name Root element name for the XML provided.
+      # @param [Class] clazz The class to convert the XML into.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format Datetime format to use for conversion..
       def deserialize_xml(xml, root_element_name, clazz, datetime_format = nil)
         doc = Nokogiri::XML::Document.parse xml
         from_element(doc, root_element_name, clazz,
@@ -119,10 +144,10 @@ module CoreLibrary
       end
 
       # Deserializes XML to an array of a specific class.
-      # @param xml The XML value to deserialize.
-      # @param root_element_name Root element name for the XML provided.
-      # @param item_name Item name for XML.
-      # @param clazz The class to convert the XML into.
+      # @param [String] xml The XML value to deserialize.
+      # @param [String] root_element_name Root element name for the XML provided.
+      # @param [String] item_name Item name for XML.
+      # @param [Class] clazz The class to convert the XML into.
       def deserialize_xml_to_array(xml, root_element_name, item_name, clazz,
                                    datetime_format = nil)
         doc = Nokogiri::XML::Document.parse xml
@@ -132,8 +157,10 @@ module CoreLibrary
       end
 
       # Deserializes XML to an array of a specific class.
-      # @param xml The XML value to deserialize.
-      # @param root_element_name Root element name for the XML provided.
+      # @param [String] xml The XML value to deserialize.
+      # @param [String] root_element_name Root element name for the XML provided.
+      # @param [Class] clazz The class to convert the XML into.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format Datetime format to use for conversion..
       def deserialize_xml_to_hash(xml, root_element_name, clazz,
                                   datetime_format = nil)
         doc = Nokogiri::XML::Document.parse xml
@@ -142,6 +169,10 @@ module CoreLibrary
       end
 
       # Converts attribute to a specific class.
+      # @param [String] parent Parent XML.
+      # @param [String] name Attribute name.
+      # @param [Class] clazz Attribute class.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format Datetime format to use for conversion..
       def from_attribute(parent, name, clazz, datetime_format: nil)
         attribute = parent[name]
         return nil if attribute.nil?
@@ -150,6 +181,10 @@ module CoreLibrary
       end
 
       # Converts element to a specific class.
+      # @param [String] parent Parent XML.
+      # @param [String] name Attribute name.
+      # @param [Class] clazz Attribute class.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format Datetime format to use for conversion..
       def from_element(parent, name, clazz, datetime_format: nil)
         element = parent.at_xpath(name)
         return nil if element.nil?
@@ -159,6 +194,11 @@ module CoreLibrary
       end
 
       # Converts element to an array.
+      # @param [String] parent Parent XML.
+      # @param [String] item_name Element name.
+      # @param [Class] clazz Element class.
+      # @param [String] wrapping_element_name Main element name.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format Datetime format to use for conversion..
       def from_element_to_array(parent, item_name, clazz,
                                 wrapping_element_name: nil,
                                 datetime_format: nil)
@@ -182,6 +222,11 @@ module CoreLibrary
       end
 
       # Converts element to hash.
+      # @param [Nokogiri::XML::Document] parent Parent document.
+      # @param [String] name Element name.
+      # @param [Class] clazz Hash class to convert to.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format Datetime format to use for conversion.
+      # @return [Object] Converted value.
       def from_element_to_hash(parent, name, clazz,
                                datetime_format: nil)
         entries = parent.at_xpath(name)
@@ -197,6 +242,10 @@ module CoreLibrary
       end
 
       # Basic convert method.
+      # @param [String] value Value to convert type of.
+      # @param [Class] clazz Type to convert into.
+      # @param [CoreLibrary::DateTimeFormat] datetime_format Datetime format to use for conversion..
+      # @return [Object] Converted value.
       def convert(value, clazz, datetime_format)
         if clazz == DateTime
           return DateTime.rfc3339(value) if datetime_format == 'RFC3339DateTime'

data/lib/apimatic_core.rb

@@ -3,6 +3,7 @@ require 'json'
 require 'certifi'
 require 'apimatic_core_interfaces'
 require 'cgi'
+require 'json-pointer'
 
 require_relative 'apimatic-core/request_builder'
 require_relative 'apimatic-core/response_handler'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: apimatic_core
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.2
 platform: ruby
 authors:
 - APIMatic Ltd.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-12-28 00:00:00.000000000 Z
+date: 2023-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: apimatic_core_interfaces
@@ -78,6 +78,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: json-pointer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -190,7 +204,7 @@ files:
 - lib/apimatic_core.rb
 homepage: https://apimatic.io
 licenses:
-- APIMATIC REFERENCE SOURCE LICENSE
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -207,7 +221,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.4.6
 signing_key: 
 specification_version: 4
 summary: A library that contains apimatic-apimatic-core logic and utilities for consuming