ponominalu 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e0874352084fa0f25f93070346e2fbe698c120d8
+  data.tar.gz: fc304746e61dc9f077ee0467b25aabd1f633fbfa
+SHA512:
+  metadata.gz: f639a3397dc6b5b53d50a9a1326da6cb1a5658ff007982bff6744394a39e2142d1e6d7e6f3f2fbc3f69b3dbc2c942536e716fca1e547048773fcc51ca3249ed5
+  data.tar.gz: a6948cb2478101635fe93a78de2446afc0478cbe6a4e1ac659495ada868418c10e84e33f2f6e638f1deb4f414e16525a5bb4c7755419ca5883f3cadc9601f278

data/.gitignore

@@ -0,0 +1,16 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.2
+script: bundle exec rake spec

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ponominalu.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Dmitry Kovalevsky
+
+MIT License
+
+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

@@ -0,0 +1 @@
+## ponominalu [![Build Status](https://travis-ci.org/crossaidi/ponominalu.svg?branch=master)](https://travis-ci.org/crossaidi/ponominalu) [![Code Climate](https://codeclimate.com/github/crossaidi/ponominalu.png)](https://codeclimate.com/github/crossaidi/ponominalu) [![Dependency Status](https://gemnasium.com/crossaidi/ponominalu.png)](https://gemnasium.com/crossaidi/ponominalu.png)

data/Rakefile

@@ -0,0 +1,16 @@
+require 'rake'
+require 'bundler/gem_tasks'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+desc 'Turn on the console with preloaded ponominalu'
+task :debug do
+  sh 'pry -I ./lib -r ./lib/ponominalu'
+end
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec

data/lib/generators/ponominalu/install/USAGE

@@ -0,0 +1,2 @@
+Description:
+    Create a ponominalu config file in config/initializers/ponominalu.rb.

data/lib/generators/ponominalu/install/install_generator.rb

@@ -0,0 +1,9 @@
+# A rails generator `ponominalu:install`. It creates a config file in `config/initializers/ponominalu.rb`.
+class Ponominalu::InstallGenerator < Rails::Generators::Base
+  source_root File.expand_path('../templates', __FILE__)
+
+  # Creates the config file.
+  def create_initializer
+    copy_file 'initializer.rb', 'config/initializers/ponominalu.rb'
+  end
+end

data/lib/generators/ponominalu/install/templates/initializer.rb

@@ -0,0 +1,22 @@
+Ponominalu.configure do |config|
+  # config.session = '123'
+
+  # Faraday adapter to make requests with:
+  # config.adapter = :net_http
+
+  # HTTP verb for API methods (:get or :post)
+  # config.http_verb = :get
+
+  # Logging parameters:
+  # log everything through the rails logger
+  config.logger = Rails.logger
+
+  # log requests' URLs
+  # config.log_requests = true
+
+  # log response JSON after errors
+  # config.log_errors = true
+
+  # log response JSON after successful responses
+  # config.log_responses = false
+end

data/lib/ponominalu.rb

@@ -0,0 +1,25 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'yaml'
+require 'hashie'
+require 'oj'
+
+require 'ponominalu/configuration'
+require 'ponominalu/helpers'
+require 'ponominalu/middleware'
+require 'ponominalu/api'
+require 'ponominalu/response'
+require 'ponominalu/error'
+
+module Ponominalu
+  extend Configuration
+
+  class << self
+    def method_missing(method, *args, &block)
+      API.call_method(method, *args, &block)
+    end
+  end
+
+  # Register alias
+  Object.const_set(:Pn, Ponominalu)
+end

data/lib/ponominalu/api.rb

@@ -0,0 +1,48 @@
+module Ponominalu
+  module API
+    # Base part of Ponominalu API endpoint url.
+    BASE_URL = 'http://api.cultserv.ru/jtransport'.freeze
+
+    class << self
+      # API method call.
+      # @param [String] method_name A name of the method.
+      # @param [Hash] args Method arguments.
+      # @return [Hashie::Mash] Mashed server response.
+      def call_method(method_name, args = {}, &block)
+        method_name_str = method_name.to_s
+        url = create_url(method_name_str)
+        args = Helpers.flatten(args)
+
+        response = connection(url).send(Ponominalu.http_verb,
+          method_name_str, args).body
+        Response.process(response, block)
+      end
+
+      # Faraday connection.
+      # @param [String] url Connection URL (either full or just prefix).
+      # @return [Faraday::Connection] Created connection.
+      def connection(url)
+        Faraday.new(url, Ponominalu.faraday_options) do |faraday|
+          faraday.request  :multipart
+          faraday.request  :url_encoded
+          faraday.request  :retry, Ponominalu.max_retries
+          faraday.response :ponominalu
+          faraday.adapter  Ponominalu.adapter
+        end
+      end
+
+      private
+        # Creates a complete url from prefixes and the method name
+        # @param [String] method_name A name of the method.
+        # @return [String] url
+        def create_url(method_name)
+          filename = File.expand_path('../simple_methods.yml', __FILE__)
+          simple_methods = YAML.load_file(filename)
+          url_prefix = simple_methods.include?(method_name) ? '/simple/' :
+            '/partner/'
+          BASE_URL + url_prefix
+        end
+    end
+  end
+end
+

data/lib/ponominalu/configuration.rb

@@ -0,0 +1,60 @@
+require 'logger'
+
+module Ponominalu
+  module Configuration
+    # Default global options
+    DEFAULT_OPTIONS = {
+      adapter: Faraday.default_adapter,
+      session: '123',
+      max_retries: 2,
+      empty_strict: false,
+      raw_json: false,
+      logger: ::Logger.new(STDOUT),
+      log_requests: true,
+      log_responses: false,
+      wrap_response: false,
+      http_verb: :post,
+      faraday_options: {}
+    }.freeze
+
+    attr_accessor *DEFAULT_OPTIONS.keys
+
+    alias_method :log_requests?,  :log_requests
+    alias_method :log_responses?, :log_responses
+
+    # A global configuration set via the block or hash.
+    # @param [Hash] options Hash of options
+    # @example
+    #   Ponominalu.configure do |config|
+    #     config.adapter = :net_http
+    #     config.logger  = Rails.logger
+    #   end
+    def configure(options={})
+      configure_by_hash(options) unless options.empty?
+      yield self if block_given?
+      self
+    end
+
+    # Reset configuration options to default values.
+    def reset
+      DEFAULT_OPTIONS.each do |k, v|
+        send("#{k}=", v)
+      end
+    end
+
+    # Set configuration options to their default values,
+    # when this module is extended.
+    def self.extended(base)
+      base.reset
+    end
+
+    private
+      # Configures global options via hash
+      # @param [Hash] options Hash of options
+      def configure_by_hash(options)
+        DEFAULT_OPTIONS.keys.each do |k|
+          send("#{k}=", options[k])
+        end
+      end
+  end
+end

data/lib/ponominalu/error.rb

@@ -0,0 +1,32 @@
+module Ponominalu
+  # An exception raised by `Ponominalu::Response` when given a response with an error.
+  class Error < StandardError
+    # An error code.
+    # @return [Fixnum]
+    attr_reader :error_code
+    # An exception is initialized by the data from response mash.
+    # @param [Hash] data Error data.
+    def initialize(data)
+      @error_code   = data.code
+      @error_msg    = data.message
+      @method_name  = data.method_name
+      @session      = data.session
+      @params       = data.params
+    end
+
+    # A full description of the error.
+    # @return [String]
+    def message
+      message = "Ponominalu returned an error #{@error_code}: '#{@error_msg}'"\
+                " after calling method '#{@method_name}'"
+
+      if (@params.empty?)
+        message << " without parameters."
+      else
+        message << " with parameters #{@params.inspect}."
+      end
+      message << " App session is '#{@session}'."
+      message
+    end
+  end
+end

data/lib/ponominalu/helpers.rb

@@ -0,0 +1,27 @@
+module Ponominalu
+  module Helpers
+    class << self
+      # Flattens enumerable values of user param
+      # (for example "exclude")
+      # @param [Hash] Hash of unflatten arguments
+      # @return [Hash] Result hash
+      def flatten(args)
+        args.inject({}) do |hash, (k, v)|
+          hash[k] = v.respond_to?(:join) ? v.join(',') : v
+          hash
+        end
+      end
+
+      # Converts params string to hash
+      # @param [String] Part of the request url with user params
+      # @return [Hash] Hash of user params
+      def parse_params(params_str)
+        params_str.split('&').inject({}) do |hash, part|
+          key_value = part.split('=')
+          hash[key_value.first] = key_value.last
+          hash
+        end
+      end
+    end
+  end
+end

data/lib/ponominalu/middleware.rb

@@ -0,0 +1,58 @@
+module Ponominalu
+  # Faraday middleware for a passing the session param to the request
+  # and config data to the response under the hood.
+  # Also it handles errors
+  class Middleware < Faraday::Response::Middleware
+    # Passes the session param
+    # @param [Hash] env Request data.
+    def initialize(app)
+      super(app)
+      @session = Ponominalu.session
+      @logger = Ponominalu.logger
+    end
+
+    def call(env)
+      # Parse the params and the method name from request body
+      @method_name = env.url.to_s.split('/').last
+      @params = Helpers.parse_params(env.body)
+
+      if Ponominalu.log_requests?
+        @logger.debug "Ponominalu: #{@method_name.upcase} #{env.url.to_s}"
+        @logger.debug "session: #{@session} params: #{@params}"
+      end
+
+      # Add the session to the user request params
+      env.body << "&session=#{@session}"
+      super
+    end
+
+    # Passes the user params and handle request errors
+    # @param [Hash] env Response data.
+    def on_complete(env)
+      if env.status != 200
+        @logger.error "Request failed with status code #{env.status}."
+        raise "Request failed with status code #{env.status}."
+      end
+
+      config_data = {
+        method_name: @method_name,
+        params: @params,
+        session: @session
+      }
+
+      env.body = Hashie::Mash.new(Oj.load(env.body).merge(config_data))
+
+      if env.body.code.zero? && !Ponominalu.empty_strict
+        @logger.warn 'Nothing was found. Result is empty.'
+      elsif env.body.code < 1
+        @logger.error "#{env.body.code}: #{env.body.message}."
+        raise Ponominalu::Error.new(env.body)
+      else
+        @logger.debug "body: #{env.body}" if Ponominalu.log_responses?
+      end
+    end
+  end
+end
+
+Faraday::Response.register_middleware ponominalu:
+  Ponominalu::Middleware

data/lib/ponominalu/response.rb

@@ -0,0 +1,39 @@
+module Ponominalu
+  module Response
+    class << self
+      # The main method result processing.
+      # @param [Hashie::Mash] response The server response in mash format.
+      # @param [Proc] block A block passed to the API method.
+      # @return [Array, Hashie::Mash] The processed result.
+      # @raise [Ponominalu::Error] raised when Ponominalu returns
+      # an error response.
+      def process(response, block)
+        result = get_result(response)
+        result = Oj.dump(result) if Ponominalu.raw_json
+
+        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 yielded if block_given?)
+          block.nil? ? result : block.call(result)
+        end
+      end
+
+    private
+      def get_result(response)
+        # an empty array is returned if error code is 0 (not found)
+        # and empty_strict option is false
+        if response.code.zero? && !Ponominalu.empty_strict
+          []
+        else
+          # if wrap_response option is true response is returned
+          # as element of response wrapper with api status code
+          # and params
+          Ponominalu.wrap_response ? response : response.message
+        end
+      end
+    end
+  end
+end

data/lib/ponominalu/simple_methods.yml

@@ -0,0 +1,2 @@
+- get_movies
+- get_movies_by_venue

data/lib/ponominalu/version.rb

@@ -0,0 +1,4 @@
+# current gem version
+module Ponominalu
+  VERSION = '0.1.0'
+end

data/ponominalu.gemspec

@@ -0,0 +1,32 @@
+# encoding: utf-8
+$: << File.expand_path('../lib', __FILE__)
+require 'ponominalu/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'ponominalu'
+  s.version     = Ponominalu::VERSION
+  s.summary     = "Ponominalu gem"
+  s.description = "Ponominalu API Ruby wrapper"
+  s.authors     = ["Dmitry Kovalevsky"]
+  s.email       = 'crossonrails@gmail.com'
+  s.files       = ["lib/ponominalu.rb"]
+  s.homepage    = 'https://github.com/crossaidi/ponominalu'
+  s.license       = 'MIT'
+
+  s.files         = `git ls-files`.split($/)
+  s.executables   = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ['lib']
+
+  s.required_ruby_version = '>= 1.9.2'
+
+  s.add_runtime_dependency 'faraday',                     '~> 0.8'
+  s.add_runtime_dependency 'faraday_middleware',          '~> 0.8'
+  s.add_runtime_dependency 'hashie',                      '~> 2.0'
+  s.add_runtime_dependency 'oj',                          '~> 2.8'
+
+  s.add_development_dependency 'bundler',                 '~> 1.3'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'pry'
+  s.add_development_dependency 'rspec'
+end

data/spec/ponominalu/api_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+describe Ponominalu::API do
+  let(:connection) do
+    Faraday.new do |builder|
+      builder.adapter  :test do |stub|
+        stub.post('/api_method') do
+          [200, {}, double('Response')]
+        end
+      end
+    end
+  end
+
+  describe ".call_method" do
+
+    before(:each) do
+      subject.stub(:connection).and_return(connection)
+    end
+
+    it "calls a connection" do
+      Ponominalu::Response.stub(:process)
+      expect(subject).to receive(:connection)
+      subject.call_method('api_method', { some: :params })
+    end
+
+    it "returns the response body" do
+      response = connection.send(Ponominalu.http_verb, 'api_method', {}).body
+      Ponominalu::Response.stub(:process).and_return(response)
+
+      expect(subject.call_method('api_method')).to eq(response)
+    end
+
+    it "gets an HTTP verb from Ponominalu.http_verb" do
+      Ponominalu::Response.stub(:process)
+      http_verb = double("HTTP verb")
+      Ponominalu.http_verb = http_verb
+
+      response = double("Response", body: double)
+      expect(connection).to receive(:send).with(http_verb, 'api_method', {}).and_return(response)
+      subject.call_method('api_method')
+    end
+
+    after(:each) do
+      Ponominalu.reset
+    end
+  end
+
+  describe '.connection' do
+    let(:url) { double('URL') }
+    let(:faraday_options) { double('Faraday options') }
+
+    it 'initiliazes new Faraday connection' do
+      Ponominalu.stub(:faraday_options).and_return(faraday_options)
+      expect(Faraday).to receive(:new).with(url, faraday_options)
+      subject.connection(url)
+    end
+  end
+end

data/spec/ponominalu/configuration_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+describe Ponominalu::Configuration do
+
+  class ConfigurationTest
+    extend Ponominalu::Configuration
+  end
+
+  subject { ConfigurationTest }
+
+  describe '.configure' do
+    let(:options) { { session: '321', empty_strict: true, max_retries: 4 } }
+
+    it 'configured by passed hash' do
+      subject.configure(options)
+      expect(subject.session).to eq('321')
+      expect(subject.empty_strict).to be_true
+      expect(subject.max_retries).to eq(4)
+    end
+
+    it 'yields self' do
+      expect(subject).to receive(:option)
+      subject.configure { |pn| pn.option }
+    end
+
+    it 'returns self' do
+      expect(subject.configure).to eq(subject)
+    end
+  end
+
+  it 'defines log params predicates as aliases' do
+    expect { subject.log_requests = false }.to change { subject.log_requests? }
+      .from(true).to(false)
+    expect { subject.log_responses = true }.to change { subject.log_responses? }
+      .from(false).to(true)
+  end
+
+  describe '.reset' do
+    it 'resets options to default values' do
+      subject.reset
+
+      expect(subject.adapter).to eq(:net_http)
+      expect(subject.logger).to be_instance_of(::Logger)
+      expect(subject.session).to eq('123')
+      expect(subject.max_retries).to eq(2)
+      expect(subject.empty_strict).to be_false
+      expect(subject.raw_json).to be_false
+      expect(subject.log_requests).to be_true
+      expect(subject.log_responses).to be_false
+      expect(subject.wrap_response).to be_false
+      expect(subject.http_verb).to eq(:post)
+      expect(subject.faraday_options).to eq({})
+    end
+  end
+end

data/spec/ponominalu/error_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+describe Ponominalu::Error do
+  let(:error_data) do
+    Hashie::Mash.new(
+      {
+        code: -200,
+        message: 'Test error',
+        method_name: 'The method name',
+        session: '123'
+      }
+    )
+  end
+
+  describe '#message' do
+    let(:error) { Ponominalu::Error.new(error_data) }
+
+    it 'includes params message when params are passed' do
+      error_data.params = Hashie::Mash.new({alias: 'alias'})
+
+      message = "Ponominalu returned an error -200: 'Test error'"\
+              " after calling method 'The method name'"
+      message << " with parameters #{error_data.params.inspect}."
+      message << " App session is '123'."
+
+      expect(error.message).to eq(message)
+    end
+
+    it 'does not includes params message when params are not passed' do
+      error_data.params = []
+
+      message = "Ponominalu returned an error -200: 'Test error'"\
+        " after calling method 'The method name'"
+      message << " without parameters."
+      message << " App session is '123'."
+
+      expect(error.message).to eq(message)
+    end
+  end
+end

data/spec/ponominalu/helpers_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Ponominalu::Helpers do
+
+  describe '.flatten' do
+    let(:args) { { str_arg: 'string', array_arg: ['str1', 'str2'] } }
+
+    it 'leaves flat arguments untouched and flats a collection' do
+      expect(subject.flatten(args))
+        .to eq({ str_arg: 'string', array_arg: 'str1,str2' })
+    end
+  end
+
+  describe '.parse_params' do
+    let(:param_str) { 'alias=something&id=123&exclude=venue' }
+
+    it 'correctly parses the params' do
+      expect(subject.parse_params(param_str))
+        .to eq({ 'alias' => 'something', 'id' => '123', 'exclude' => 'venue'})
+    end
+  end
+end

data/spec/ponominalu/middleware_spec.rb

@@ -0,0 +1,112 @@
+require 'spec_helper'
+
+describe Ponominalu::Middleware do
+  let(:logger) { double("Logger").as_null_object }
+  let(:app) { double("App").as_null_object }
+  let(:url) { double('URL', to_s: Ponominalu::API::BASE_URL + '/test_method' ) }
+
+  let(:env_request) { double('Env object', body: 'param_1=1&param_2=2',
+      url: url, status: 200) }
+
+  let(:env_success) { double('Env success object',
+    body: double('Body', code: 1) , status: 200) }
+
+  let(:env_empty) { double('Env empty object', body: double('Body', code: 0),
+    status: 200) }
+
+  let(:api_error) { double('API error body', code: -200, message: 'API error',
+    method_name: 'test_method', session: Ponominalu.session, params: {} ) }
+
+  let(:env_api_error) { double('Env api error object', body: api_error,
+    status: 200) }
+
+  let(:env_fail) { double('Env fail object', body: double('Body', code: 1),
+    status: 404) }
+
+  before(:each) do
+    Ponominalu.logger = logger
+    Ponominalu.session = 'test_session'
+    Ponominalu.log_requests  = false
+    Ponominalu.log_responses = false
+  end
+
+  subject { Ponominalu::Middleware.new(app) }
+
+  context 'when request is processing' do
+    it 'calls debug method on the logger with correct messages' do
+      Ponominalu.log_requests = true
+      expect(logger).to receive(:debug)
+        .with('Ponominalu: TEST_METHOD '\
+          'http://api.cultserv.ru/jtransport/test_method')
+      expect(logger).to receive(:debug)
+        .with('session: test_session params: {"param_1"=>"1", "param_2"=>"2"}')
+      subject.call(env_request)
+    end
+
+    it 'adds the session param to the request body' do
+      expect(env_request.body).to receive(:<<)
+        .with('&session=test_session')
+      subject.call(env_request)
+    end
+  end
+
+  context 'when response is processing' do
+    before(:each) do
+      Oj.stub(:load).and_return({})
+    end
+
+    context '(logging)' do
+      before(:each) { subject.stub(:raise) }
+
+      it 'calls warn method on the logger if result is empty' do
+        env_empty.stub(:body=)
+
+        expect(logger).to receive(:warn)
+          .with('Nothing was found. Result is empty.')
+        subject.on_complete(env_empty)
+      end
+
+      it 'calls error method on the logger if API error is returned' do
+        env_api_error.stub(:body=)
+
+        expect(logger).to receive(:error)
+          .with('-200: API error.')
+        subject.on_complete(env_api_error)
+      end
+
+      it 'calls error method on the logger if API error is returned' do
+        env_fail.stub(:body=)
+
+        expect(logger).to receive(:error)
+          .with('Request failed with status code 404.')
+        subject.on_complete(env_fail)
+      end
+
+      it 'calls debug method on the logger if log_responses is true' do
+        env_success.stub(:body=)
+
+        Ponominalu.log_responses = true
+
+        expect(logger).to receive(:debug)
+          .with("body: #{env_success.body}")
+        subject.on_complete(env_success)
+      end
+    end
+
+    context '(error raising)' do
+      it 'raises runtime error if response status is not 200' do
+        env_fail.stub(:body=)
+
+        expect { subject.on_complete(env_fail) }.to \
+          raise_error(RuntimeError, 'Request failed with status code 404.')
+      end
+
+      it 'raises Ponominalu::Error if response code is negative number' do
+        env_api_error.stub(:body=)
+
+        expect { subject.on_complete(env_api_error) }.to \
+          raise_error(Ponominalu::Error)
+      end
+    end
+  end
+end

data/spec/ponominalu/response_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+describe Ponominalu::Response do
+  let(:block) { proc(&:method) }
+  let(:data_enum) { double('Enumerable data', each: block ) }
+  let(:response_full_enum) { double('Full response', code: 1, message: data_enum) }
+
+  before { Ponominalu.reset }
+
+  describe '.process' do
+    it 'returns a string if the raw_json option is true' do
+      Ponominalu.raw_json = true
+      expect(Oj).to receive(:dump).with(data_enum)
+      subject.process(response_full_enum, nil)
+    end
+
+    context 'when block given' do
+      let(:data_non_enum) { double('Non-enumerable data') }
+      let(:response_full_non_enum) { double('Full response', code: 1, message: data_non_enum) }
+
+      it 'receives :map with a block if it is collection' do
+        subject.stub(:get_result).and_return(data_enum)
+        expect(data_enum).to receive(:map)
+        subject.process(response_full_enum, block)
+      end
+
+      it 'is yielded if result is non-enumerable' do
+        subject.stub(:get_result).and_return(data_non_enum)
+        expect(block).to receive(:call).with(data_non_enum)
+        subject.process(response_full_non_enum, block)
+      end
+    end
+  end
+
+  describe '.get_result' do
+    let(:response_empty) { double('Empty response', code: 0, message: 'empty') }
+
+    it 'returns an empty array if a result is not found' do
+      expect(subject.send(:get_result, response_empty)).to eq([])
+    end
+
+    it 'does not return an empty array if empty_strict is true' do
+      Ponominalu.empty_strict = true
+      expect(subject.send(:get_result, response_empty)).not_to eq([])
+    end
+
+    it 'returns a result if it is not empty' do
+      expect(subject.send(:get_result, response_full_enum))
+        .to eq(response_full_enum.message)
+    end
+
+    it 'returns a result in a wrapper if the wrap_response option is true' do
+      Ponominalu.wrap_response = true
+      expect(subject.send(:get_result, response_full_enum))
+        .to eq(response_full_enum)
+    end
+  end
+end

data/spec/ponominalu_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe Ponominalu do
+  context 'when short alias is registered' do
+    it 'automatically registers the short alias' do
+      expect(subject).to eq(Pn)
+    end
+  end
+
+  context 'when delegating to API module' do
+    it 'delegates methods to API.call_method' do
+      expect(subject::API).to receive(:call_method)
+        .with(:test_method)
+      subject.test_method
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require 'ponominalu'
+
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+  config.color = true
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,191 @@
+--- !ruby/object:Gem::Specification
+name: ponominalu
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dmitry Kovalevsky
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ponominalu API Ruby wrapper
+email: crossonrails@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/generators/ponominalu/install/USAGE
+- lib/generators/ponominalu/install/install_generator.rb
+- lib/generators/ponominalu/install/templates/initializer.rb
+- lib/ponominalu.rb
+- lib/ponominalu/api.rb
+- lib/ponominalu/configuration.rb
+- lib/ponominalu/error.rb
+- lib/ponominalu/helpers.rb
+- lib/ponominalu/middleware.rb
+- lib/ponominalu/response.rb
+- lib/ponominalu/simple_methods.yml
+- lib/ponominalu/version.rb
+- ponominalu.gemspec
+- spec/ponominalu/api_spec.rb
+- spec/ponominalu/configuration_spec.rb
+- spec/ponominalu/error_spec.rb
+- spec/ponominalu/helpers_spec.rb
+- spec/ponominalu/middleware_spec.rb
+- spec/ponominalu/response_spec.rb
+- spec/ponominalu_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/crossaidi/ponominalu
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Ponominalu gem
+test_files:
+- spec/ponominalu/api_spec.rb
+- spec/ponominalu/configuration_spec.rb
+- spec/ponominalu/error_spec.rb
+- spec/ponominalu/helpers_spec.rb
+- spec/ponominalu/middleware_spec.rb
+- spec/ponominalu/response_spec.rb
+- spec/ponominalu_spec.rb
+- spec/spec_helper.rb