imagga 0.0.2

data/.gitignore

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

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx-19mode

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Mart Karu
+
+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,53 @@
+[![Build Status](https://travis-ci.org/martkaru/imagga.png?branch=master)](https://travis-ci.org/martkaru/imagga)
+
+# Imagga
+
+Client for Imagga image analytics services API
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'imagga'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install imagga
+
+## Usage
+
+Set up a client
+
+    client = Imagga::Client.new(
+      base_uri:   '0.0.0.0',                # IP of the Imagga server
+      api_key:    '12345678',               # Your api key
+      api_secret: '1234567890123456789'     # Your api secret
+    )
+
+Extract image information
+
+    results = client.extract('http://imagga.com/images/scheme_colors.png')
+
+Extract image information with indexing and extraction options:
+
+    results = client.extract(
+      [
+        Imagga::Image.new(url: 'http://image1', id: '333'),
+        Imagga::Image.new(url: 'http://image2')
+      ],
+      extract_overall_colors: true,
+      extract_object_colors: false
+    )
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec
+

data/imagga.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'imagga/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "imagga"
+  gem.version       = Imagga::VERSION
+  gem.authors       = ["Mart Karu"]
+  gem.email         = ["karu@metal.ee"]
+  gem.description   = %q{Ruby client for accessing Imagga API}
+  gem.summary       = %q{Ruby client for accessing Imagga API}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "httparty", "~> 0.10"
+  gem.add_dependency "json", "~> 1.7"
+
+  gem.add_development_dependency "rspec", "~> 2.12"
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "fakeweb"
+end

data/lib/imagga.rb

@@ -0,0 +1,7 @@
+require "imagga/version"
+require "imagga/exceptions"
+require "imagga/extract_result_builder"
+require "imagga/rank_result_builder"
+require "imagga/image"
+require "imagga/extract_options"
+require "imagga/client"

data/lib/imagga/client.rb

@@ -0,0 +1,42 @@
+require "httparty"
+require "json"
+
+module Imagga
+  class Client
+    include HTTParty
+    include Imagga::Exceptions
+    attr_reader :api_key, :api_secret, :base_uri, :service_path
+
+    def initialize(opts={})
+      @api_key     = opts[:api_key]    || raise_missing(:api_key)
+      @api_secret  = opts[:api_secret] || raise_missing(:api_secret)
+      @base_uri    = opts[:base_uri]   || raise_missing(:base_uri)
+      @service_path = '/colorsearchserver.php'
+
+      Imagga::Client.base_uri @base_uri
+    end
+
+    def extract(urls_or_images, additional_options={})
+      options = extract_options(urls_or_images, additional_options)
+      result = JSON.parse(self.class.post(service_path, body: options))
+      raise_if_request_failed!(result)
+      ExtractResultBuilder.new.build_from(result)
+    end
+
+    def rank(opts)
+      result = JSON.parse(self.class.post(service_path, body: rank_options(opts)))
+      raise_if_request_failed!(result)
+      RankResultBuilder.new.build_from(result)
+    end
+
+    private
+
+    def extract_options(urls_or_images, additional_options)
+      ExtractOptions.new(api_key, api_secret).options(urls_or_images, additional_options)
+    end
+
+    def rank_options(opts)
+      RankOptions.new(api_key, api_secret).options(opts)
+    end
+  end
+end

data/lib/imagga/exceptions.rb

@@ -0,0 +1,21 @@
+module Imagga
+  module Exceptions
+    def raise_missing(attribute)
+      raise ArgumentError, "%s is missing" % attribute.to_s
+    end
+
+    def raise_if_request_failed!(result)
+      if result.respond_to?(:keys) && result.keys.include?('error_code')
+        raise Imagga::ClientException.new(result['error_code'].to_i), result['error_message'], caller[0..-1]
+      end
+    end
+  end
+
+  class ClientException < StandardError
+    attr_accessor :error_code
+    def initialize(error_code)
+      @error_code = error_code
+      super
+    end
+  end
+end

data/lib/imagga/extract_options.rb

@@ -0,0 +1,74 @@
+module Imagga
+  class BaseOptions
+    attr_accessor :api_key, :api_secret
+
+    def initialize(api_key, api_secret)
+      @version    = '1.0'
+      @api_key    = api_key    || raise_missing(:api_key)
+      @api_secret = api_secret || raise_missing(:api_secret)
+    end
+
+    def base_options
+      { v: @version, api_key: @api_key }
+    end
+
+    def sign(options)
+      sorted_options_string = options.keys.sort.map do |key|
+        "%s=%s" % [key.to_s, options[key]]
+      end.join('') << @api_secret
+      Digest::MD5.hexdigest(sorted_options_string)
+    end
+  end
+
+  class ExtractOptions < BaseOptions
+
+    def options(urls_or_images, additional_options={})
+      options = base_options.merge(
+        method: 'imagga.colorsearch.extract',
+        urls: build_urls(urls_or_images),
+      )
+
+      if ids = build_ids(urls_or_images)
+        options.merge!(ids: ids)
+      end
+
+      [:extract_overall_colors, :extract_object_colors].each do |key|
+        if additional_options.keys.include?(key) && (value = additional_options[key] ? 1 : 0)
+          options.merge!(key => value)
+        end
+      end
+
+      options.merge!(sig: sign(options))
+    end
+
+    def build_urls(urls_or_images)
+      [urls_or_images].flatten.map{ |o| o.url rescue o }.join(',')
+    end
+
+    def build_ids(urls_or_images)
+      ids = [urls_or_images].flatten.map{ |o| o.id rescue 0 }
+      return if ids.uniq == [0]
+      ids.join(',')
+    end
+
+  end
+
+  class RankOptions < BaseOptions
+    def options(opts)
+      color_vector = opts.fetch(:color_vector)
+      type         = opts.fetch(:type)
+      dist         = opts.fetch(:dist)
+      count        = opts.fetch(:count)
+
+      options = base_options.merge(
+        method:       'imagga.colorsearch.rank',
+        color_vector: color_vector,
+        type:         type,
+        dist:         dist,
+        count:        count
+      )
+
+      options.merge!(sig: sign(options))
+    end
+  end
+end

data/lib/imagga/extract_result_builder.rb

@@ -0,0 +1,11 @@
+require "json"
+
+module Imagga
+
+  class ExtractResultBuilder
+    def build_from(result)
+      result['colors'].map { |image_node| ImageInfo.new(image_node) }
+    end
+  end
+
+end

data/lib/imagga/image.rb

@@ -0,0 +1,71 @@
+module Imagga
+  class Image
+    include Imagga::Exceptions
+    attr_accessor :url, :id
+
+    def initialize(opts)
+      @url = opts[:url] || raise_missing(:url)
+      @id  = opts[:id]  || 0
+    end
+  end
+
+  class ImageInfoBase
+    def initialize(opts={})
+      self.class.fields.each { |field| send("#{field}=", opts[field]) }
+    end
+  end
+
+  class ImageInfo < ImageInfoBase
+    def self.fields
+      %w(url object_percentage color_variance image_packed foreground_packed background_packed)
+    end
+
+    def self.color_fields
+      %w(image_colors foreground_colors background_colors)
+    end
+
+    def initialize(opts={})
+      super(opts['info'].merge('url' => opts['url']))
+      self.class.color_fields.each do |field|
+        send("#{field}=", build_image_colors(opts['info'][field]))
+      end
+    end
+
+    def build_image_colors(image_color_nodes)
+      image_color_nodes && image_color_nodes.map { |color_node| ImageColor.new(color_node) }
+    end
+
+    attr_accessor *(fields + color_fields)
+
+    def color_variance=(value)
+      @color_variance = value.to_i
+    end
+  end
+
+  class ImageColor < ImageInfoBase
+    def self.fields
+      %w(percent r g b html_code closest_palette_color closest_palette_color_parent closest_palette_distance)
+    end
+
+    attr_accessor *fields
+
+    %w(r g b).each do |field|
+      define_method("#{field}=") do |value|
+        instance_variable_set("@#{field}", value.to_i)
+      end
+    end
+
+    def percent=(value)
+      @percent = value.to_f
+    end
+
+  end
+
+  class RankSimilarity < ImageInfoBase
+    def self.fields
+      %w(id dist)
+    end
+
+    attr_accessor *fields
+  end
+end

data/lib/imagga/rank_result_builder.rb

@@ -0,0 +1,9 @@
+module Imagga
+
+  class RankResultBuilder
+    def build_from(result)
+      result['rank_similarity'].map { |rank| RankSimilarity.new(rank) }
+    end
+  end
+
+end

data/lib/imagga/version.rb

@@ -0,0 +1,3 @@
+module Imagga
+  VERSION = "0.0.2"
+end

data/spec/lib/client_spec.rb

@@ -0,0 +1,352 @@
+require 'spec_helper'
+require 'fake_web'
+
+describe Imagga::Client do
+
+  subject { described_class.new(api_key: '1', api_secret: '2', base_uri: 'http://example.com') }
+  let(:extract_response) {'{
+    "colors":[
+      {
+        "url":"http:\/\/www.stockpodium.com\/stock-photo-8244245\/smiling-presenting-2-apples-image.jpg",
+        "info":{
+          "image_colors":[
+            {
+              "percent":"38.90",
+              "r":"247",
+              "g":"245",
+              "b":"243",
+              "html_code":"#f7f5f3",
+              "closest_palette_color":"white",
+              "closest_palette_color_parent":"white",
+              "closest_palette_distance":1.8304102578
+            },
+            {
+              "percent":"35.16",
+              "r":"206",
+              "g":"167",
+              "b":"146",
+              "html_code":"#cea792",
+              "closest_palette_color":"fresco",
+              "closest_palette_color_parent":"beige",
+              "closest_palette_distance":4.93287465177
+            },
+            {
+              "percent":"10.41",
+              "r":"150",
+              "g":"60",
+              "b":"45",
+              "html_code":"#963c2d",
+              "closest_palette_color":"ribbon red",
+              "closest_palette_color_parent":"red",
+              "closest_palette_distance":5.6423821179
+            },
+            {
+              "percent":"8.38",
+              "r":"55",
+              "g":"37",
+              "b":"31",
+              "html_code":"#37251f",
+              "closest_palette_color":"espresso",
+              "closest_palette_color_parent":"brown",
+              "closest_palette_distance":5.91329502182
+            },
+            {
+              "percent":"7.15",
+              "r":"168",
+              "g":"181",
+              "b":"45",
+              "html_code":"#a8b52d",
+              "closest_palette_color":"mint",
+              "closest_palette_color_parent":"olive green",
+              "closest_palette_distance":10.7126507469
+            }
+          ],
+          "foreground_colors":[
+            {
+              "percent":"45.92",
+              "r":"200",
+              "g":"180",
+              "b":"112",
+              "html_code":"#c8b470",
+              "closest_palette_color":"medium olive",
+              "closest_palette_color_parent":"skin",
+              "closest_palette_distance":7.22056402093
+            },
+            {
+              "percent":"34.21",
+              "r":"162",
+              "g":"79",
+              "b":"61",
+              "html_code":"#a24f3d",
+              "closest_palette_color":"fiesta",
+              "closest_palette_color_parent":"red",
+              "closest_palette_distance":6.29194294147
+            },
+            {
+              "percent":"19.86",
+              "r":"52",
+              "g":"35",
+              "b":"31",
+              "html_code":"#34231f",
+              "closest_palette_color":"espresso",
+              "closest_palette_color_parent":"brown",
+              "closest_palette_distance":6.49089812519
+            }
+          ],
+          "background_colors":[
+            {
+              "percent":"58.05",
+              "r":"249",
+              "g":"248",
+              "b":"247",
+              "html_code":"#f9f8f7",
+              "closest_palette_color":"white",
+              "closest_palette_color_parent":"white",
+              "closest_palette_distance":2.48109615666
+            },
+            {
+              "percent":"36.41",
+              "r":"206",
+              "g":"177",
+              "b":"161",
+              "html_code":"#ceb1a1",
+              "closest_palette_color":"pearl pink",
+              "closest_palette_color_parent":"light pink",
+              "closest_palette_distance":4.11506425614
+            },
+            {
+              "percent":"5.55",
+              "r":"150",
+              "g":"100",
+              "b":"77",
+              "html_code":"#96644d",
+              "closest_palette_color":"light bronze",
+              "closest_palette_color_parent":"skin",
+              "closest_palette_distance":6.37479340147
+            }
+          ],
+          "object_percentage":38.4,
+          "color_variance":"33"
+        }
+      },
+      {
+        "url":"http:\/\/www.stockpodium.com\/stock-photo-9289532\/car-dirving-very-fast-under-image.jpg",
+        "info":{
+          "image_colors":[
+            {
+              "percent":"38.53",
+              "r":"103",
+              "g":"98",
+              "b":"98",
+              "html_code":"#676262",
+              "closest_palette_color":"blue steel",
+              "closest_palette_color_parent":"grey",
+              "closest_palette_distance":10.486937593
+            },
+            {
+              "percent":"26.31",
+              "r":"42",
+              "g":"37",
+              "b":"33",
+              "html_code":"#2a2521",
+              "closest_palette_color":"espresso",
+              "closest_palette_color_parent":"brown",
+              "closest_palette_distance":8.14492880108
+            },
+            {
+              "percent":"16.19",
+              "r":"178",
+              "g":"182",
+              "b":"190",
+              "html_code":"#b2b6be",
+              "closest_palette_color":"frost",
+              "closest_palette_color_parent":"light grey",
+              "closest_palette_distance":2.82095071372
+            },
+            {
+              "percent":"12.06",
+              "r":"197",
+              "g":"51",
+              "b":"45",
+              "html_code":"#c5332d",
+              "closest_palette_color":"fiesta",
+              "closest_palette_color_parent":"red",
+              "closest_palette_distance":5.41278686601
+            },
+            {
+              "percent":"6.91",
+              "r":"86",
+              "g":"97",
+              "b":"28",
+              "html_code":"#56611c",
+              "closest_palette_color":"moss",
+              "closest_palette_color_parent":"olive green",
+              "closest_palette_distance":9.97695248255
+            }
+          ],
+          "foreground_colors":[
+            {
+              "percent":"62.98",
+              "r":"199",
+              "g":"50",
+              "b":"43",
+              "html_code":"#c7322b",
+              "closest_palette_color":"fiesta",
+              "closest_palette_color_parent":"red",
+              "closest_palette_distance":5.44027296941
+            },
+            {
+              "percent":"22.01",
+              "r":"140",
+              "g":"132",
+              "b":"144",
+              "html_code":"#8c8490",
+              "closest_palette_color":"shadow",
+              "closest_palette_color_parent":"light grey",
+              "closest_palette_distance":3.40761167276
+            },
+            {
+              "percent":"15.01",
+              "r":"61",
+              "g":"38",
+              "b":"43",
+              "html_code":"#3d262b",
+              "closest_palette_color":"espresso",
+              "closest_palette_color_parent":"brown",
+              "closest_palette_distance":5.85441000013
+            }
+          ],
+          "background_colors":[
+            {
+              "percent":"41.07",
+              "r":"103",
+              "g":"97",
+              "b":"97",
+              "html_code":"#676161",
+              "closest_palette_color":"blue steel",
+              "closest_palette_color_parent":"grey",
+              "closest_palette_distance":10.6345471176
+            },
+            {
+              "percent":"39.63",
+              "r":"53",
+              "g":"51",
+              "b":"34",
+              "html_code":"#353322",
+              "closest_palette_color":"graphite",
+              "closest_palette_color_parent":"black",
+              "closest_palette_distance":9.18317865786
+            },
+            {
+              "percent":"19.29",
+              "r":"174",
+              "g":"180",
+              "b":"187",
+              "html_code":"#aeb4bb",
+              "closest_palette_color":"frost",
+              "closest_palette_color_parent":"light grey",
+              "closest_palette_distance":2.03931376316
+            }
+          ],
+          "object_percentage":17.99,
+          "color_variance":"37",
+          "image_packed":null,
+          "foreground_packed":null,
+          "background_packed":null
+        }
+      }
+    ]
+  }'}
+
+  let(:rank_response) { '{
+    "rank_similarity":[
+      {
+        "id":8774077,
+        "dist":2597.38299
+      },
+      {
+        "id":9085916,
+        "dist":2681.33259
+      }
+    ]
+  }'}
+
+  let(:failed_signature_response) { '{"error_code":3,"error_message":"Invalid signature"}' }
+
+  it "has api_key" do
+    subject.api_key.should == '1'
+  end
+
+  it "has api_secret" do
+    subject.api_secret.should == '2'
+  end
+
+  it "has base_uri" do
+    subject.base_uri.should == 'http://example.com'
+  end
+
+  it "knows service path" do
+    subject.service_path.should == '/colorsearchserver.php'
+  end
+
+  describe "#extract" do
+    it "extracts image info" do
+      FakeWeb.register_uri(:post, 'http://example.com/colorsearchserver.php', body: extract_response)
+      subject.extract('http://image').size.should == 2
+    end
+
+    context "with failing request" do
+      before :each do
+        FakeWeb.register_uri(:post, 'http://example.com/colorsearchserver.php', body: failed_signature_response)
+        subject.should_receive(:extract_options).with('http://image', {})
+      end
+
+      it "raises exception" do
+        expect { subject.extract('http://image') }.to raise_error(Imagga::ClientException)
+      end
+
+      it "populates exception object with details" do
+        begin
+          subject.extract('http://image')
+        rescue Imagga::ClientException => e
+          e.message.should == 'Invalid signature'
+          e.error_code.should == 3
+        end
+      end
+    end
+  end
+
+  describe "#rank" do
+    let(:rank_arguments) { {
+      color_vector: [{percent: 60, r: 255, g: 0, b: 0}],
+      type: 'overall',
+      dist: 3000,
+      count: 200
+    } }
+
+    it "does a rank search" do
+      FakeWeb.register_uri(:post, 'http://example.com/colorsearchserver.php', body: rank_response)
+      subject.rank(rank_arguments).size.should == 2
+    end
+
+    context "with failing request" do
+      before :each do
+        FakeWeb.register_uri(:post, 'http://example.com/colorsearchserver.php', body: failed_signature_response)
+        subject.should_receive(:rank_options)
+      end
+
+      it "raises exception" do
+        expect { subject.rank(rank_arguments) }.to raise_error(Imagga::ClientException)
+      end
+
+      it "populates exception object with details" do
+        begin
+          subject.rank(rank_arguments)
+        rescue Imagga::ClientException => e
+          e.message.should == 'Invalid signature'
+          e.error_code.should == 3
+        end
+      end
+    end
+  end
+end

data/spec/lib/extract_result_builder_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Imagga::ExtractResultBuilder do
+  let(:result) { {
+      "colors" => [
+        {
+          "url" =>"http:\/\/www.stockpodium.com\/stock-photo-8244245\/smiling-presenting-2-apples-image.jpg",
+          "info" => {}
+        },
+        {
+          "url" =>"http:\/\/www.stockpodium.com\/stock-photo-9289532\/car-dirving-very-fast-under-image.jpg",
+          "info" => {}
+        }
+      ]
+    } }
+
+  subject { described_class.new }
+
+  describe '#build'  do
+    it "builds result" do
+      subject.build_from(result).size.should == 2
+    end
+  end
+
+end

data/spec/lib/extraction_options_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+
+describe Imagga::ExtractOptions do
+  subject { described_class.new('apikey', 'secret') }
+
+  describe "#options" do
+    it "builds simple options" do
+      subject.options('http://image').should == {
+        urls: 'http://image',
+        method: 'imagga.colorsearch.extract',
+        sig: '76e667179a6520da86e272a609bc7fab',
+        api_key: 'apikey',
+        v: '1.0'
+      }
+    end
+
+    it "builds complex options" do
+      subject.options([
+        Imagga::Image.new(url: 'http://image1', id: '333'),
+        Imagga::Image.new(url: 'http://image2')
+      ], extract_overall_colors: true, extract_object_colors: false).should == {
+        urls: 'http://image1,http://image2',
+        ids: '333,0',
+        method: 'imagga.colorsearch.extract',
+        extract_overall_colors: 1,
+        extract_object_colors: 0,
+        sig: 'd66a0e3409ed08878ce7efae2827de87',
+        api_key: 'apikey',
+        v: '1.0'
+      }
+    end
+  end
+
+  describe "#build_urls" do
+    it "builds string of urls based on single image url string" do
+      subject.build_urls('http://image').should == 'http://image'
+    end
+
+    it "builds string of urls based on image url string arrays" do
+      subject.build_urls(['http://image1', 'http://image2']).should == 'http://image1,http://image2'
+    end
+
+    it "builds string of urls based on single image object" do
+      subject.build_urls(Imagga::Image.new(url: 'http://image')).should == 'http://image'
+    end
+
+    it "builds string of urls based on image object array" do
+      subject.build_urls([
+        Imagga::Image.new(url: 'http://image1'),
+        Imagga::Image.new(url: 'http://image2')]).should == 'http://image1,http://image2'
+    end
+  end
+
+  describe "#build_ids" do
+    it "returns 0 based on single image url string" do
+      subject.build_ids('http://image').should == nil
+    end
+
+    it "returns array of 0-s given image url string arrays" do
+      subject.build_ids(['http://image1', 'http://image2']).should == nil
+    end
+
+    it "builds string of ids based on single image object" do
+      subject.build_ids(Imagga::Image.new(url: 'http://image', id: '123')).should == '123'
+    end
+
+    it "builds string of ids based on image object array" do
+      subject.build_ids([
+        Imagga::Image.new(url: 'http://image1', id: '123'),
+        Imagga::Image.new(url: 'http://image2')]).should == '123,0'
+    end
+  end
+end

data/spec/lib/image_color_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+describe Imagga::ImageColor do
+
+  let(:init_hash) { {
+    "percent" => '19.29',
+    "r" => '174', "g" => '180', "b" => '187',
+    "html_code" => "#aeb4bb",
+    "closest_palette_color" => "frost",
+    "closest_palette_color_parent" => "light grey",
+    "closest_palette_distance" => 2.03931376316
+  } }
+
+  describe "initialized by hash" do
+    subject { described_class.new(init_hash) }
+
+    it "has percent" do
+      subject.percent.should == 19.29
+    end
+
+    it "has r" do
+      subject.r.should == 174
+    end
+
+    it "has g" do
+      subject.g.should == 180
+    end
+
+    it "has b" do
+      subject.b.should == 187
+    end
+
+    it "has html_code" do
+      subject.html_code.should == '#aeb4bb'
+    end
+
+    it "has closest palette color" do
+      subject.closest_palette_color.should == 'frost'
+    end
+
+    it "has closest parent palette color" do
+      subject.closest_palette_color_parent.should == 'light grey'
+    end
+
+    it "has closest palette distance" do
+      subject.closest_palette_distance.should == 2.03931376316
+    end
+  end
+
+  describe "initialized by hash with not supported attributes" do
+    subject { described_class.new(a: 'b') }
+
+    it "ignores not supported attributes" do
+      expect { subject.a }.to raise_error
+    end
+  end
+
+end

data/spec/lib/image_info_spec.rb

@@ -0,0 +1,88 @@
+require 'spec_helper'
+
+describe Imagga::ImageInfo do
+
+  let(:init_hash) { {
+    "url" => 'http://image',
+    "info" => {
+      "image_colors" => [ { "html_code" => "#676262", } ],
+      "foreground_colors" => [ { "html_code" => "#c7322b", } ],
+      "background_colors" => [ { "html_code" => "#676161", } ],
+      "object_percentage" => 17.99,
+      "color_variance" => "37",
+      "image_packed" => nil,
+      "foreground_packed" => nil,
+      "background_packed" => nil
+    }
+  } }
+  subject { described_class.new(init_hash) }
+
+  describe "initialized by hash" do
+
+    it "has url" do
+      subject.url.should == 'http://image'
+    end
+
+    it "has image colors" do
+      subject.image_colors.should have(1).items
+      subject.image_colors.first.html_code.should == '#676262'
+    end
+
+    it "has foreground colors" do
+      subject.foreground_colors.should have(1).items
+      subject.foreground_colors.first.html_code.should == '#c7322b'
+    end
+
+    it "has background colors" do
+      subject.background_colors.should have(1).items
+      subject.background_colors.first.html_code.should == '#676161'
+    end
+
+    it "has object percentage" do
+      subject.object_percentage.should == 17.99
+    end
+
+    it "has color variance" do
+      subject.color_variance.should == 37
+    end
+  end
+
+  describe "initialized by hash with not supported attributes" do
+    subject { described_class.new(a: 'b') }
+
+    it "ignores not supported attributes" do
+      expect { subject.a }.to raise_error
+    end
+  end
+
+  describe "initialied with empty color info" do
+    let(:init_hash) { {
+      "url" => 'http://image',
+      "info" => {
+        "image_colors" => [],
+        "foreground_colors" => [],
+        "background_colors" => [],
+      }
+    } }
+
+    it "initializes color infos as empty arrays" do
+      subject.image_colors.should be_empty
+      subject.foreground_colors.should be_empty
+      subject.background_colors.should be_empty
+    end
+  end
+
+  describe "initialied with missing color info" do
+    let(:init_hash) { {
+      "url" => 'http://image',
+      "info" => {}
+    } }
+
+    it "does not initialize color infos" do
+      subject.image_colors.should be_nil
+      subject.foreground_colors.should be_nil
+      subject.background_colors.should be_nil
+    end
+  end
+
+end

data/spec/lib/image_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Imagga::Image do
+  subject { described_class.new(url: 'http://', id: '1234') }
+
+  it "has id" do
+    subject.id.should == '1234'
+  end
+
+  it "has url" do
+    subject.url.should == 'http://'
+  end
+
+  context "without url" do
+    it "throws ArgumentError" do
+      expect{ described_class.new(id: '1234') }.to raise_error(ArgumentError, 'url is missing')
+    end
+  end
+
+  context "without id" do
+    it "assigns id as 0" do
+      described_class.new(url: 'http://').id.should == 0
+    end
+  end
+end

data/spec/lib/rank_result_builder_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Imagga::RankResultBuilder do
+  let(:result) { {
+    'rank_similarity' =>  [
+      {
+        "id" => 8774077,
+        "dist" => 2597.38299
+      },
+      {
+        "id" => 9085916,
+        "dist" => 2681.33259
+      }
+    ]
+  } }
+
+  subject { described_class.new }
+
+  describe '#build'  do
+    it "builds result" do
+      subject.build_from(result).size.should == 2
+    end
+  end
+
+end

data/spec/lib/rank_similarity_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Imagga::RankSimilarity do
+
+  let(:init_hash) { {
+    "id" => 8774077,
+    "dist" => 2597.38299
+  } }
+
+  describe "initialized by hash" do
+    subject { described_class.new(init_hash) }
+
+    it "has id" do
+      subject.id.should == 8774077
+    end
+
+    it "has dist" do
+      subject.dist.should == 2597.38299
+    end
+  end
+
+  # todo
+  describe "initialized by hash with not supported attributes" do
+    subject { described_class.new(a: 'b') }
+
+    it "ignores not supported attributes" do
+      expect { subject.a }.to raise_error
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'rspec/autorun'
+require 'rubygems'
+require 'bundler'
+Bundler.require(:default, :development)
+
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir["spec/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+end

metadata

@@ -0,0 +1,165 @@
+--- !ruby/object:Gem::Specification
+name: imagga
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Mart Karu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby client for accessing Imagga API
+email:
+- karu@metal.ee
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- imagga.gemspec
+- lib/imagga.rb
+- lib/imagga/client.rb
+- lib/imagga/exceptions.rb
+- lib/imagga/extract_options.rb
+- lib/imagga/extract_result_builder.rb
+- lib/imagga/image.rb
+- lib/imagga/rank_result_builder.rb
+- lib/imagga/version.rb
+- spec/lib/client_spec.rb
+- spec/lib/extract_result_builder_spec.rb
+- spec/lib/extraction_options_spec.rb
+- spec/lib/image_color_spec.rb
+- spec/lib/image_info_spec.rb
+- spec/lib/image_spec.rb
+- spec/lib/rank_result_builder_spec.rb
+- spec/lib/rank_similarity_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 440675985594337981
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 440675985594337981
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Ruby client for accessing Imagga API
+test_files:
+- spec/lib/client_spec.rb
+- spec/lib/extract_result_builder_spec.rb
+- spec/lib/extraction_options_spec.rb
+- spec/lib/image_color_spec.rb
+- spec/lib/image_info_spec.rb
+- spec/lib/image_spec.rb
+- spec/lib/rank_result_builder_spec.rb
+- spec/lib/rank_similarity_spec.rb
+- spec/spec_helper.rb