zemanta_client 0.0.1

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/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 TODO: Write your name
+
+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,64 @@
+# Zemanta
+
+This is a ruby client to awesome Zemanta app. At this point it only supports suggest_markup method and is tested on ruby 1.9.3.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'zemanta_client'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install zemanta_client
+
+## Usage
+
+You need to set api_key to use the client. If you won't do that, gem will raise an error. There are 2 ways:
+  1. Environment variable
+    - Set ZEMANTA_KEY key in you environment variables and gem will use it
+
+  2. Configuration
+    - You can set your api_key in configuration block like this:
+    - Zemanta.configure { |c| c.api_key = 'your_api_key' } 
+
+After your api_key has been set, all you need to do is:
+
+    Zemanta.new("Text you want to send to Zemanta").suggest_markup
+
+And you will be returned Markup object or error will be raised if Zemanta returns one.
+
+## Configuration
+
+  There are several configuration options you can set:
+
+      Zemanta.configure do |config|
+        You can pass a hash of custom options that will be passed into each request. It's empty by default.
+        config.custom_request_opts = {}
+      
+        Zemanta supports various response formats. However, this client works only with json, so changing this would be rather bad idea.
+        config.format = "json"
+      
+        This client supports caching, details below. Default is no caching.
+        config.cache_store = Zemanta::Configuration::NullStorage
+      
+        You can pass api_key to zemanta, as described above.
+        config.api_key = "yourapikeyhere"
+      end
+
+## Caching
+  By default there is no caching. You can pass any cache store to config.cache_store in configuration.
+  The only expectation is that it answers to [] and []= methods. For example, you can pass ruby hash or Cache::Disk.new
+  object to use simple file system storage.
+
+## 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 @@
+require "bundler/gem_tasks"

data/lib/zemanta.rb

@@ -0,0 +1,39 @@
+require 'active_support/dependencies/autoload'
+require 'typhoeus'
+require 'json'
+require 'digest/md5'
+
+class Zemanta
+  extend ActiveSupport::Autoload
+
+  autoload :Cache
+  autoload :Configuration
+  autoload :Fetcher
+  autoload :Markup
+
+  def initialize(text)
+    @text = text
+  end
+
+  def suggest_markup(opts = {})
+    Markup.new(suggest_markup_request(opts))
+  end
+
+  def self.configure
+    yield config
+  end
+
+  def self.config
+    @configuration ||= Configuration.new
+  end
+
+  private
+
+  def suggest_markup_request(opts)
+    @response ||= request({ text: @text, method: "zemanta.suggest_markup" }.merge(opts))['markup']
+  end
+
+  def request(opts)
+    Fetcher.new(opts).post
+  end
+end

data/lib/zemanta/cache.rb

@@ -0,0 +1,7 @@
+class Zemanta
+  module Cache
+    extend ActiveSupport::Autoload
+
+    autoload :Disk
+  end
+end

data/lib/zemanta/cache/disk.rb

@@ -0,0 +1,21 @@
+class Zemanta
+  module Cache
+    class Disk
+      attr_accessor :db
+
+      def initialize(directory='tmp/db')
+        @db = Pathname.new(directory)
+        @db.mkpath
+      end
+
+      def [](key)
+        file = @db.join(key)
+        file.read if file.exist?
+      end
+
+      def []=(key,value)
+        @db.join(key).open('w') {|f| f.write(value.to_s)}
+      end
+    end
+  end
+end

data/lib/zemanta/configuration.rb

@@ -0,0 +1,32 @@
+class Zemanta
+  class Configuration
+    extend ActiveSupport::Autoload
+
+    autoload :NullStorage
+
+    attr_accessor :custom_request_opts, :format, :api_key, :cache_storage
+
+    def initialize
+      @custom_request_opts = {}
+      @format = "json"
+      @cache_storage = NullStorage.new
+    end
+
+    def request_opts
+      {
+        api_key: actual_api_key,
+        format: @format
+      }.merge(@custom_request_opts)
+    end
+
+    def end_point
+      "http://api.zemanta.com/services/rest/0.0/"
+    end
+
+    private
+
+    def actual_api_key
+      @api_key || ENV["ZEMANTA_KEY"] or raise "You need to specify ZEMANTA_KEY in your environment or set api_key in your config"
+    end
+  end
+end

data/lib/zemanta/configuration/null_storage.rb

@@ -0,0 +1,12 @@
+class Zemanta
+  class Configuration
+    class NullStorage
+      def [](key)
+        nil
+      end
+
+      def []=(key,value)
+      end
+    end
+  end
+end

data/lib/zemanta/fetcher.rb

@@ -0,0 +1,36 @@
+class Zemanta
+  class Fetcher
+    extend ActiveSupport::Autoload
+
+    autoload :Cache
+    autoload :Web
+
+    def initialize(opts = {})
+      @opts = opts
+    end
+
+    def post
+      @response = cache.fetch || web.fetch
+      cache.save(@response)
+      parse(@response)
+    end
+
+    private
+
+    def cache
+      @cache ||= Cache.new(@opts)
+    end
+
+    def web
+      Web.new(request_opts)
+    end
+
+    def parse(data)
+      JSON.parse(data)
+    end
+
+    def request_opts
+      @request_opts ||= Zemanta.config.request_opts.merge(@opts)
+    end
+  end
+end

data/lib/zemanta/fetcher/cache.rb

@@ -0,0 +1,33 @@
+class Zemanta
+  class Fetcher
+    class Cache
+      extend ActiveSupport::Autoload
+
+      autoload :NullResponse
+      autoload :Response
+      autoload :Key
+
+      def initialize(opts = {})
+        @key = Key.new(opts).to_s
+      end
+
+      def fetch
+        fetch_from_storage(@key).to_s
+      end
+
+      def save(response)
+        storage[@key] = Response.new(response) unless storage[@key]
+      end
+
+      private
+
+      def storage
+        Zemanta.config.cache_storage
+      end
+
+      def fetch_from_storage(opts)
+        storage[@key] || NullResponse.new
+      end
+    end
+  end
+end

data/lib/zemanta/fetcher/cache/key.rb

@@ -0,0 +1,27 @@
+class Zemanta
+  class Fetcher
+    class Cache
+      class Key
+        def initialize(value)
+          @value = value
+        end
+
+        def to_s
+          if @value.is_a?(String)
+            digest(@value)
+          elsif @value.is_a?(Hash)
+            digest(@value.sort.to_s)
+          else
+            raise "You are trying to use #{@value.class} as cache key. Only Strings and Hashes are supported."
+          end
+        end
+
+        private
+
+        def digest(value)
+          Digest::MD5.hexdigest(value)
+        end
+      end
+    end
+  end
+end

data/lib/zemanta/fetcher/cache/null_response.rb

@@ -0,0 +1,11 @@
+class Zemanta
+  class Fetcher
+    class Cache
+      class NullResponse
+        def to_s
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/zemanta/fetcher/cache/response.rb

@@ -0,0 +1,16 @@
+class Zemanta
+  class Fetcher
+    class Cache
+      class Response
+        def initialize(data)
+          @data = data
+          @created_at = Time.now
+        end
+
+        def to_s
+          @data
+        end
+      end
+    end
+  end
+end

data/lib/zemanta/fetcher/web.rb

@@ -0,0 +1,35 @@
+class Zemanta
+  class Fetcher
+    class Web
+      def initialize(opts = {})
+        @opts = opts
+      end
+
+      def fetch
+        if http_fetch == zemanta_error_response
+          raise_api_key_exception!
+        else
+          http_fetch
+        end
+      end
+
+      private
+
+      def http_fetch
+        @response ||= Typhoeus.post(url, params: @opts).response_body
+      end
+
+      def zemanta_error_response
+        '<h1>403 Developer Inactive</h1>'
+      end
+
+      def raise_api_key_exception!
+        raise "Zemanta returned '#{zemanta_error_response}' exception. Quite possibly you passed incorrect api_key."
+      end
+
+      def url
+        Zemanta.config.end_point
+      end
+    end
+  end
+end

data/lib/zemanta/markup.rb

@@ -0,0 +1,14 @@
+class Zemanta
+  class Markup
+    extend ActiveSupport::Autoload
+
+    autoload :Link
+
+    attr_reader :text, :links
+
+    def initialize(opts = {})
+      @text  = opts["text"]
+      @links = opts["links"].map{ |link| Link.new(link) }
+    end
+  end
+end

data/lib/zemanta/markup/link.rb

@@ -0,0 +1,23 @@
+class Zemanta
+  class Markup
+    class Link
+      extend ActiveSupport::Autoload
+
+      autoload :Target
+
+      attr_reader :relevance, :confidence, :entity_type, :target, :anchor
+
+      def initialize(opts = {})
+        @relevance   = opts["relevance"]
+        @confidence  = opts["confidence"]
+        @entity_type = opts["entity_type"]
+        @target      = opts["target"].map{ |opts| Target.new(opts) }
+        @anchor      = opts["anchor"]
+      end
+
+      def above?(relevance, confidence)
+        @relevance >= relevance and @confidence >= confidence
+      end      
+    end
+  end
+end

data/lib/zemanta/markup/link/target.rb

@@ -0,0 +1,15 @@
+class Zemanta
+  class Markup
+    class Link
+      class Target
+        attr_reader :url, :type, :title
+
+        def initialize(opts = {})
+          @url   = opts["url"]
+          @type  = opts["type"]
+          @title = opts["title"]
+        end
+      end
+    end
+  end
+end

data/lib/zemanta/version.rb

@@ -0,0 +1,3 @@
+class Zemanta
+  VERSION = "0.0.1"
+end

data/spec/fixtures/zemanta/full_response.json

@@ -0,0 +1,75 @@
+{
+  "status": "ok",
+  "articles": [
+    {
+      "confidence": 0.00114,
+      "published_datetime": "2013-02-23T06:39:14Z",
+      "title": "Tiananmen Square- Forbidden City- Summer Palace - Beijing, China",
+      "url": "http://blog.travelpod.com/travel-blog-entries/peregrinations/1/1315695831/tpod.html",
+      "retweets": 0,
+      "text_preview": "Tiananmen Square- Forbidden City- Summer Palace - Beijing, China\nBeijing, China\nThis was our last day of touring and it was by far the most arduous of the whole trip. I have no idea how anyone can do this in the heat and humidity of July and August. It was just the end of May and the heat did me in. Even though our guide took a very leisurely pace...",
+      "article_id": 147457867,
+      "zemified": 0
+    }
+  ],
+  "markup": {
+    "text": "",
+    "links": [
+      {
+        "relevance": 0.8093,
+        "confidence": 0.873863,
+        "entity_type": [
+          "/location/location"
+        ],
+        "target": [
+          {
+            "url": "http://maps.google.com/maps?ll=27.2359361111,100.132480556&spn=0.01,0.01&q=27.2359361111,100.132480556 (Tiger%20Leaping%20Gorge)&t=h",
+            "type": "geolocation",
+            "title": "Tiger Leaping Gorge"
+          }
+        ],
+        "anchor": "Tiger Leaping Gorge"
+      }
+    ]
+  },
+  "images": [
+    {
+      "url_m_h": 240,
+      "confidence": 0.5,
+      "url_s_h": 75,
+      "attribution": "Naxi Horseman (Photo credit: <a href=\"http://www.flickr.com/photos/85904220@N00/3182514166\">Renato @ Mainland China</a>)",
+      "description": "Naxi Horseman",
+      "license": "License CreativeCommons NonCommercial NoDerivs",
+      "url_l_w": 365,
+      "url_s": "http://farm4.static.flickr.com/3115/3182514166_186de79cab_s.jpg",
+      "source_url": "http://www.flickr.com/photos/85904220@N00/3182514166",
+      "url_m": "http://farm4.static.flickr.com/3115/3182514166_186de79cab_m.jpg",
+      "url_l": "http://farm4.static.flickr.com/3115/3182514166_186de79cab.jpg",
+      "url_l_h": 500,
+      "url_s_w": 75,
+      "url_m_w": 175
+    }
+  ],
+  "signature": "<div class=\"zemanta-pixie\"><a class=\"zemanta-pixie-a\" href=\"http://www.zemanta.com/?px\" title=\"Enhanced by Zemanta\"><img class=\"zemanta-pixie-img\" src=\"http://img.zemanta.com/zemified_e.png?x-id=27556886-7e10-4b64-8bff-9fa4352fd524\" alt=\"Enhanced by Zemanta\" /></a></div>",
+  "keywords": [
+    {
+      "confidence": 0.267918,
+      "scheme": "general",
+      "name": "Beijing"
+    }
+  ],
+  "rid": "27556886-7e10-4b64-8bff-9fa4352fd524",
+  "categories": [],
+  "rich_objects": [
+    {
+      "title": "Tiananmen Square",
+      "url": "http://maps.google.com/maps?ll=39.9033333333,116.391666667&spn=0.01,0.01&q=39.9033333333,116.391666667 (Tiananmen%20Square)&t=h",
+      "thumbnail_width": 75,
+      "height": 250,
+      "width": 300,
+      "html": "<iframe width=\"300\" height=\"250\" frameborder=\"0\" scrolling=\"no\" marginheight=\"0\" marginwidth=\"0\" src=\"http://maps.google.com/?ie=UTF8&amp;center=39.9033333333,116.391666667&amp;spn=0.01,0.01&amp;q=39.9033333333,116.391666667 (Tiananmen%20Square)&amp;t=h&amp;output=embed&amp;sensor=false&amp;s=AARTsJqzARj-Z8VnW5pkPMLMmZbqrJcYpw\"></iframe><br/><small><a href=\"http://maps.google.com/?ie=UTF8&amp;center=39.9033333333,116.391666667&amp;spn=0.01,0.01&amp;q=39.9033333333,116.391666667 (Tiananmen%20Square)&amp;t=h&amp;source=embed&amp;sensor=false\" style=\"color:#0000FF;text-align:left\">View Larger Map</a></small>",
+      "thumbnail_height": 75,
+      "thumbnail_url": "http://maps.google.com/staticmap?size=300x250&sensor=false&center=39.9033333333,116.391666667&zoom=15"
+    }
+  ]
+}

data/spec/fixtures/zemanta/link.json

@@ -0,0 +1,15 @@
+{
+  "relevance": 0.8093,
+  "confidence": 0.873863,
+  "entity_type": [
+    "/location/location"
+  ],
+  "target": [
+    {
+      "url": "www.this.is.an/url",
+      "type": "geolocation",
+      "title": "Tiger Leaping Gorge"
+    }
+  ],
+  "anchor": "Tiger Leaping Gorge"
+}

data/spec/fixtures/zemanta/markup.json

@@ -0,0 +1,20 @@
+{
+  "text": "text",
+  "links": [
+    {
+      "relevance": 0.8093,
+      "confidence": 0.873863,
+      "entity_type": [
+        "/location/location"
+      ],
+      "target": [
+        {
+          "url": "www.this.is.an/url",
+          "type": "geolocation",
+          "title": "Tiger Leaping Gorge"
+        }
+      ],
+      "anchor": "Tiger Leaping Gorge"
+    }
+  ]
+}

data/spec/fixtures/zemanta/target.json

@@ -0,0 +1,5 @@
+{
+  "url": "www.this.is.an/url",
+  "type": "geolocation",
+  "title": "Tiger Leaping Gorge"
+}

data/spec/spec_helper.rb

@@ -0,0 +1,43 @@
+require 'zemanta'
+require 'webmock/rspec'
+
+Zemanta.configure do |c|
+  c.api_key = 'fake_key'
+end
+# This file was generated by the `rspec --init` command. Conventionally, all
+# 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
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+def fixture(path)
+  JSON.parse(File.read("spec/fixtures/zemanta/#{path}.json"))
+end
+
+def stub_zemanta_success!
+  stub_request(:post, /api.zemanta.com/).
+    to_return(:status => 200, :body => "{\"response\":\"zemanta_response\"}").times(1).then.
+    to_return(:status => 404)
+end
+
+def stub_zemanta_full!
+  stub_request(:post, /api.zemanta.com/).
+    to_return(:status => 200, :body => {markup: fixture("markup")}.to_json)
+end
+
+def stub_zemanta_exception!
+  stub_request(:post, /api.zemanta.com/).
+    to_return(:status => 200, :body => '<h1>403 Developer Inactive</h1>')
+end

data/spec/zemanta/cache/disk_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe Zemanta::Cache::Disk do
+  let(:cache) { Zemanta::Cache::Disk }
+  let(:storage) { cache.new }
+
+  describe "#initialize" do
+    it "creates directory to store files if one doesnt exist" do
+      temp_dir = Pathname.new('spec/temp_dir')
+      temp_dir.delete if temp_dir.exist?
+      temp_dir.should_not exist
+
+      cache.new(temp_dir)
+      temp_dir.should exist
+      temp_dir.delete
+    end
+
+    it "uses tmp/db as default directory" do
+      storage.db.should == Pathname.new('tmp/db')
+    end
+  end
+
+  describe "#[key]" do
+    it "returns nil if key doesnt exist" do
+      storage['non-existing-key'].should be_nil
+    end
+
+    it "returns stored value if the key exists" do
+      value = "string data"
+      storage['key'] = value
+      storage['key'].should == value
+    end
+  end
+
+  describe "#[key]=" do
+    let(:key)   { 'some-key' }
+    let(:value) { 'text-value' }
+
+    it "creates new file for specified key" do
+      Pathname.new(storage.db.join(key)).delete
+      Pathname.new(storage.db.join(key)).should_not exist
+
+      storage[key] = value
+      Pathname.new(storage.db.join(key)).should exist
+    end
+
+    it "overwrites existing file for specified key" do
+      storage[key] = value
+      storage[key] = "new value"
+      storage[key].should == "new value"
+    end
+  end
+end

data/spec/zemanta/configuration/null_storage_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Zemanta::Fetcher::Web do
+  subject { Zemanta::Configuration::NullStorage.new }
+
+  it "returns nil on #[]" do
+    subject[:key].should be_nil
+  end
+
+  it "responds to #save" do
+    subject.should respond_to :[]=
+  end
+end

data/spec/zemanta/configuration_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+
+describe Zemanta::Configuration do
+  subject { Zemanta::Configuration.new }
+  
+  describe "getter" do
+    it "gets custom_request_opts" do
+      subject.custom_request_opts.should == {}
+    end
+
+    it "gets format" do
+      subject.format.should == "json"
+    end
+
+    it "gets api_key" do
+      subject.api_key.should == nil
+    end
+
+    it "gets cache_storage" do
+      subject.cache_storage.should be_a Zemanta::Configuration::NullStorage
+    end
+  end
+
+  describe "setter" do
+    it "sets custom_request_opts" do
+      subject.custom_request_opts = {target_types: "geolocation"}
+      subject.custom_request_opts.should == {target_types: "geolocation"}
+    end
+
+    it "sets format" do
+      subject.format = "xml"
+      subject.format.should == "xml"
+    end
+
+    it "sets api_key" do
+      subject.api_key = "key"
+      subject.api_key.should == "key"
+    end
+
+    it "sets cache_storage" do
+      subject.cache_storage = {}
+      subject.cache_storage.should == {}
+    end
+  end
+
+  it "knows the end_point" do
+    subject.end_point.should == "http://api.zemanta.com/services/rest/0.0/"
+  end
+
+  it "can build the request_opts" do
+    subject.stub(:actual_api_key).and_return("api_key")
+    subject.request_opts.should == {
+      api_key: "api_key",
+      format: "json"
+    }
+  end
+
+  it "custom_request_opts into request_opts" do
+    subject.stub(:actual_api_key).and_return("api_key")
+    subject.custom_request_opts = {target_types: "geolocation"}
+    subject.request_opts[:target_types].should == "geolocation"
+  end
+end

data/spec/zemanta/fetcher/cache/key_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe Zemanta::Fetcher::Cache::Key do
+  it "returns string by #to_s, given string" do
+    Zemanta::Fetcher::Cache::Key.new("").to_s.should be_a String
+  end
+
+  it "returns string by #to_s, given hash" do
+    Zemanta::Fetcher::Cache::Key.new({}).to_s.should be_a String
+  end
+
+  it "creates identical values for hashes with different order" do
+    key_1 = Zemanta::Fetcher::Cache::Key.new({key: "value", awesomeness: "high"})
+    key_2 = Zemanta::Fetcher::Cache::Key.new({awesomeness: "high", key: "value"})
+    key_1.to_s.should == key_2.to_s
+  end
+end

data/spec/zemanta/fetcher/cache/null_response_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Zemanta::Fetcher::Cache::NullResponse do
+  it "returns nil by #to_s" do
+    Zemanta::Fetcher::Cache::NullResponse.new.to_s.should be_nil
+  end
+end

data/spec/zemanta/fetcher/cache/response_spec.rb

@@ -0,0 +1,8 @@
+require 'spec_helper'
+
+describe Zemanta::Fetcher::Cache::Response do
+  it "returns saved data by #to_s" do
+    response = Zemanta::Fetcher::Cache::Response.new("String of data")
+    response.to_s.should == "String of data"
+  end
+end

data/spec/zemanta/fetcher/cache_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Zemanta::Fetcher::Cache do
+  describe "for set storage" do
+    before :each do
+      Zemanta.configure { |config| config.cache_storage = {} }
+      Zemanta::Fetcher::Cache.new("key").save("test data")
+    end
+
+    after :all do
+      Zemanta.configure { |config| config.cache_storage = Zemanta::Configuration::NullStorage.new }
+    end
+
+    it "saves the data to cache if it's saved first time" do
+      Zemanta.config.cache_storage.size.should == 1
+    end
+
+    it "doesn't save the data if same key was used before" do
+      Zemanta::Fetcher::Cache.new("key").save("test data")
+      Zemanta.config.cache_storage.size.should == 1
+    end
+
+    it "fetch returns nil if no key in cache" do
+      Zemanta::Fetcher::Cache.new("another_key").fetch.should be_nil
+    end
+
+    it "fetch returns the value data if key is present" do
+      Zemanta::Fetcher::Cache.new("key").fetch.should == "test data"
+    end
+  end
+end

data/spec/zemanta/fetcher/web_spec.rb

@@ -0,0 +1,8 @@
+require 'spec_helper'
+
+describe Zemanta::Fetcher::Web do
+  it "delegates to Typhoeus on #fetch" do
+    stub_zemanta_success!
+    Zemanta::Fetcher::Web.new.fetch.should == "{\"response\":\"zemanta_response\"}"
+  end
+end

data/spec/zemanta/fetcher_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe Zemanta::Fetcher do
+  it "returns the value in cache, if there is one" do
+    Zemanta.configure { |config| config.cache_storage = {} }
+    stub_zemanta_success!
+    subject.post
+    subject.post.should == {"response"=>"zemanta_response"}
+    Zemanta.configure { |config| config.cache_storage = Zemanta::Configuration::NullStorage.new }
+  end
+
+  it "returns the value in web, if there is no cache" do
+    stub_zemanta_success!
+    subject.post.should == {"response"=>"zemanta_response"}
+  end
+end

data/spec/zemanta/integration/correct_response_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe "suggest_markup" do
+  before(:each) do
+    stub_zemanta_full!
+  end
+
+  let(:markup) { Zemanta.new("some text").suggest_markup }
+  
+  it "responds to #text" do
+    markup.text.should == "text"
+  end
+
+  it "responds to #links" do
+    markup.links.should be_a Array
+  end
+
+  describe ".links.first" do
+    let(:link) { markup.links.first }
+
+    it "responds to #relevance" do
+      link.relevance.should == 0.8093
+    end
+
+    it "responds to #confidence" do
+      link.confidence.should == 0.873863
+    end
+
+    it "responds to #entity_type" do
+      link.entity_type.should == ["/location/location"]
+    end
+
+    it "responds to #target" do
+      link.target.should be_a Array
+    end
+
+    it "responds to #anchor" do
+      link.anchor.should == "Tiger Leaping Gorge"
+    end
+
+    describe ".target.first" do
+      let(:target) { link.target.first }
+
+      it "answers to #url" do
+        target.url.should == "www.this.is.an/url"
+      end
+
+      it "answers to #type" do
+        target.type.should == "geolocation"
+      end
+
+      it "answers to #title" do
+        target.title.should == "Tiger Leaping Gorge"
+      end
+    end
+  end
+end

data/spec/zemanta/integration/incorrect_api_key_spec.rb

@@ -0,0 +1,11 @@
+
+require 'spec_helper'
+
+describe "incorrect api key" do
+  let(:markup) { Zemanta.new("some text").suggest_markup }
+
+  it "raises exception when 403 error returned" do
+    stub_zemanta_exception!
+    expect { markup }.to raise_error("Zemanta returned '<h1>403 Developer Inactive</h1>' exception. Quite possibly you passed incorrect api_key.")
+  end
+end

data/spec/zemanta/markup/link/target_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe Zemanta::Markup::Link::Target do
+  describe "getter" do
+    subject { Zemanta::Markup::Link::Target.new(fixture("target")) }
+
+    it "for url works well" do
+      subject.url.should == "www.this.is.an/url"
+    end
+
+    it "for type works well" do
+      subject.type.should == "geolocation"
+    end
+
+    it "for target title works well" do
+      subject.title.should == "Tiger Leaping Gorge"
+    end
+  end
+end

data/spec/zemanta/markup/link_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe Zemanta::Markup::Link do
+  describe "getter" do
+    subject { Zemanta::Markup::Link.new(fixture("link")) }
+
+    describe "getter" do
+      it "for relevance works well" do
+        subject.relevance.should == 0.8093
+      end
+
+      it "for confidence works well" do
+        subject.confidence.should == 0.873863
+      end
+
+      it "for entity title works well" do
+        subject.entity_type.should == ["/location/location"]
+      end
+
+      it "for target returns array of targets" do
+        subject.target.should be_a Array
+        subject.target.first.should be_a Zemanta::Markup::Link::Target
+      end
+
+      it "for anchor works well" do
+        subject.anchor.should == "Tiger Leaping Gorge"
+      end
+    end
+
+    describe "above?" do
+      it "returns true if is above both relevance and confidence" do
+        subject.above?(0.5, 0.5).should == true
+      end
+
+      it "returns false if relevance is lower" do
+        subject.above?(0.9, 0.5).should == false
+      end
+
+      it "returns false if confidence is lower" do
+        subject.above?(0.5, 0.9).should == false
+      end
+
+      it "returns false if both confidence and relevance is lower" do
+        subject.above?(0.9, 0.9).should == false
+      end
+    end
+  end
+end

data/spec/zemanta/markup_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe Zemanta::Markup do
+  describe "getter" do
+    subject { Zemanta::Markup.new(fixture("markup")) }
+
+    it "for text works well" do
+      subject.text.should == "text"
+    end
+
+    it "for links returns array of links" do
+      subject.links.should be_a Array
+      subject.links.first.should be_a Zemanta::Markup::Link
+    end
+  end
+end

data/spec/zemanta_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe Zemanta do
+  it "makes request with text and method params on #suggest_markup" do
+    context = Zemanta.new("This is a text")
+    context.stub(:suggest_markup_request) { fixture("markup") }
+    context.suggest_markup.should be_a Zemanta::Markup
+  end
+
+  it "returns Configuration instance on Zemanta.config" do
+    Zemanta.config.should be_a Zemanta::Configuration
+  end
+
+  it "passes Configuration instance to block on Zemanta.configure" do
+    Zemanta.configure do |config|
+      config.should be_a Zemanta::Configuration
+    end
+  end
+end

data/zemanta.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'zemanta/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "zemanta_client"
+  gem.version       = Zemanta::VERSION
+  gem.authors       = ["Łukasz Strzebińczyk"]
+  gem.email         = ["l.strzebinczyk@gorailsgo.com"]
+  gem.description   = "This is a ruby client for Zemanta api."
+  gem.summary       = "This is a ruby client for Zemanta api."
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "typhoeus"
+  gem.add_dependency "activesupport"
+
+  gem.add_development_dependency "rspec"
+  gem.add_development_dependency "webmock"
+end

metadata

@@ -0,0 +1,171 @@
+--- !ruby/object:Gem::Specification
+name: zemanta_client
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Łukasz Strzebińczyk
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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: webmock
+  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: This is a ruby client for Zemanta api.
+email:
+- l.strzebinczyk@gorailsgo.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/zemanta.rb
+- lib/zemanta/cache.rb
+- lib/zemanta/cache/disk.rb
+- lib/zemanta/configuration.rb
+- lib/zemanta/configuration/null_storage.rb
+- lib/zemanta/fetcher.rb
+- lib/zemanta/fetcher/cache.rb
+- lib/zemanta/fetcher/cache/key.rb
+- lib/zemanta/fetcher/cache/null_response.rb
+- lib/zemanta/fetcher/cache/response.rb
+- lib/zemanta/fetcher/web.rb
+- lib/zemanta/markup.rb
+- lib/zemanta/markup/link.rb
+- lib/zemanta/markup/link/target.rb
+- lib/zemanta/version.rb
+- spec/fixtures/zemanta/full_response.json
+- spec/fixtures/zemanta/link.json
+- spec/fixtures/zemanta/markup.json
+- spec/fixtures/zemanta/target.json
+- spec/spec_helper.rb
+- spec/zemanta/cache/disk_spec.rb
+- spec/zemanta/configuration/null_storage_spec.rb
+- spec/zemanta/configuration_spec.rb
+- spec/zemanta/fetcher/cache/key_spec.rb
+- spec/zemanta/fetcher/cache/null_response_spec.rb
+- spec/zemanta/fetcher/cache/response_spec.rb
+- spec/zemanta/fetcher/cache_spec.rb
+- spec/zemanta/fetcher/web_spec.rb
+- spec/zemanta/fetcher_spec.rb
+- spec/zemanta/integration/correct_response_spec.rb
+- spec/zemanta/integration/incorrect_api_key_spec.rb
+- spec/zemanta/markup/link/target_spec.rb
+- spec/zemanta/markup/link_spec.rb
+- spec/zemanta/markup_spec.rb
+- spec/zemanta_spec.rb
+- zemanta.gemspec
+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'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: This is a ruby client for Zemanta api.
+test_files:
+- spec/fixtures/zemanta/full_response.json
+- spec/fixtures/zemanta/link.json
+- spec/fixtures/zemanta/markup.json
+- spec/fixtures/zemanta/target.json
+- spec/spec_helper.rb
+- spec/zemanta/cache/disk_spec.rb
+- spec/zemanta/configuration/null_storage_spec.rb
+- spec/zemanta/configuration_spec.rb
+- spec/zemanta/fetcher/cache/key_spec.rb
+- spec/zemanta/fetcher/cache/null_response_spec.rb
+- spec/zemanta/fetcher/cache/response_spec.rb
+- spec/zemanta/fetcher/cache_spec.rb
+- spec/zemanta/fetcher/web_spec.rb
+- spec/zemanta/fetcher_spec.rb
+- spec/zemanta/integration/correct_response_spec.rb
+- spec/zemanta/integration/incorrect_api_key_spec.rb
+- spec/zemanta/markup/link/target_spec.rb
+- spec/zemanta/markup/link_spec.rb
+- spec/zemanta/markup_spec.rb
+- spec/zemanta_spec.rb
+has_rdoc: