Contents

module ToNetMeApi
  # A module that handles method result processing.
  # 
  # It implements method blocks support, result typecasting and raises `ToNetMeApi::Error` in case of an error response.
  module Result
    class << self
      # The main method result processing.
      # @param [Hashie::Mash] response The server response in mash format.
      # @param [Symbol] type The expected result type (`:boolean` or `:anything`).
      # @param [Proc] block A block passed to the API method.
      # @return [Array, Hashie::Mash] The processed result.
      # @raise [ToNetMeApi::Error] raised when VKontakte returns an error response.
      def process(response, type, block)
        raise response['error_code'].inspect
        result = extract_result(response)
        
        if result.respond_to?(:each)
          # enumerable result receives :map with a block when called with a block
          # or is returned untouched otherwise
          block.nil? ? result : result.map(&block)
        else
          # non-enumerable result is typecasted
          # (and yielded if block_given?)
          result = typecast(result, type)
          block.nil? ? result : block.call(result)
        end
      end
      
    private
      def extract_result(response)
        if response.error?
          raise ToNetMeApi::Error.new(response.error)
        else
          response.response
        end
      end
      
      def typecast(parameter, type)
        case type
        when :boolean
          # '1' becomes true, '0' becomes false
          !parameter.to_i.zero?
        else
          parameter
        end
      end
    end
  end
end

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
to_net_me_api-0.4	lib/to_net_me_api/result.rb
to_net_me_api-0.3	lib/to_net_me_api/result.rb
to_net_me_api-0.2	lib/to_net_me_api/result.rb