wikidata-client 0.0.1

data/spec/fixtures/vcr/Wikidata_Item/_search/should_return_the_next_page_offset.yml

@@ -0,0 +1,123 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://www.wikidata.org/w/api.php?action=query&format=json&list=search&srlimit=10&sroffset=0&srsearch=Michael%20Jackson
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.0
+      Expect:
+      - ''
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Apache
+      X-Content-Type-Options:
+      - nosniff
+      Cache-Control:
+      - private
+      X-Frame-Options:
+      - DENY
+      Content-Type:
+      - application/json; charset=utf-8
+      Vary:
+      - Accept-Encoding,X-Forwarded-Proto,X-Use-HHVM
+      X-Varnish:
+      - 1526867630, 3175927500, 2581305905
+      Via:
+      - 1.1 varnish, 1.1 varnish, 1.1 varnish
+      Transfer-Encoding:
+      - chunked
+      Date:
+      - Mon, 29 Sep 2014 09:07:30 GMT
+      Age:
+      - '0'
+      Connection:
+      - keep-alive
+      X-Cache:
+      - cp1065 miss (0), amssq52 miss (0), amssq59 frontend miss (0)
+      X-Analytics:
+      - php=zend
+      Set-Cookie:
+      - GeoIP=FR:Sainte-luce-sur-loire:47.2500:-1.5000:v4; Path=/; Domain=.wikidata.org
+    body:
+      encoding: ASCII-8BIT
+      string: '{"query-continue":{"search":{"sroffset":10}},"query":{"searchinfo":{"totalhits":416},"search":[{"ns":0,"title":"Q2831","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        \u121b\u12ed\u12ad\u120d \u1303\u12ad\u1230\u1295 <span class=\"searchmatch\">Michael</span>
+        <span class=\"searchmatch\">Jackson</span> \u0645\u0627\u064a\u0643\u0644
+        \u062c\u0627\u0643\u0633\u0648\u0646","size":8234,"wordcount":890,"timestamp":"2014-09-18T07:35:04Z"},{"ns":0,"title":"Q167877","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        \u041c\u0430\u0439\u043a\u044a\u043b \u0414\u0436\u0430\u043a\u0441\u044a\u043d
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        Michael","size":1216,"wordcount":132,"timestamp":"2014-09-14T15:28:24Z"},{"ns":0,"title":"Q507175","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> Jackson","size":1503,"wordcount":233,"timestamp":"2014-06-04T10:27:12Z"},{"ns":0,"title":"Q956149","snippet":"\u0e2a\u0e1b\u0e35\u0e0a\u0e40\u0e25\u0e2a\u0e2a\u0e4c
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        Single von <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        song chanson de <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        Speechless (chanson de <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>)
+        Speechless","size":720,"wordcount":73,"timestamp":"2014-08-20T02:07:57Z"},{"ns":0,"title":"Q25158","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        del 2002 Album von <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        Love Songs Love Songs (<span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        album) Love Songs (album, <span class=\"searchmatch\">Michael</span> <span
+        class=\"searchmatch\">Jackson</span>)","size":368,"wordcount":55,"timestamp":"2014-05-09T22:51:53Z"},{"ns":0,"title":"Q1308224","snippet":"Experience
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The Experience <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The Experience <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The Experience <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The Experience <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The","size":1131,"wordcount":124,"timestamp":"2014-05-05T08:15:06Z"},{"ns":0,"title":"Q7244161","snippet":"Prince
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I \u067e\u0631\u0646\u0633","size":447,"wordcount":60,"timestamp":"2014-08-22T21:39:22Z"},{"ns":0,"title":"Q756785","snippet":"Cry
+        Cry Cry (b\u00e0i h\u00e1t c\u1ee7a <span class=\"searchmatch\">Michael</span>
+        <span class=\"searchmatch\">Jackson</span>) \u0e04\u0e23\u0e32\u0e22 chanson
+        de <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        singolo di <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        del 2001 <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        song recorded by American","size":835,"wordcount":117,"timestamp":"2014-08-20T02:40:03Z"},{"ns":0,"title":"Q1638445","snippet":"di
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        del 2012 <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        album Kompilationsalbum von <span class=\"searchmatch\">Michael</span> <span
+        class=\"searchmatch\">Jackson</span> Icon (<span class=\"searchmatch\">Michael</span>-<span
+        class=\"searchmatch\">Jackson</span>-Album) Icon (album c\u1ee7a <span class=\"searchmatch\">Michael</span>
+        <span class=\"searchmatch\">Jackson</span>) Icon","size":287,"wordcount":43,"timestamp":"2014-05-07T03:24:35Z"},{"ns":0,"title":"Q44376","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        album album di <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        del 2001 album by <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        Album von <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        \u00e1lbum de <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        \u00e1lbum de <span class=\"searchmatch\">Michael</span> Jackson","size":2167,"wordcount":217,"timestamp":"2014-08-27T21:11:08Z"}]}}'
+    http_version: 
+  recorded_at: Mon, 29 Sep 2014 09:07:30 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/vcr/Wikidata_Item/_search/should_return_the_total_number_of_hits.yml

@@ -0,0 +1,123 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://www.wikidata.org/w/api.php?action=query&format=json&list=search&srlimit=10&sroffset=0&srsearch=Michael%20Jackson
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.0
+      Expect:
+      - ''
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Apache
+      X-Content-Type-Options:
+      - nosniff
+      Cache-Control:
+      - private
+      X-Frame-Options:
+      - DENY
+      Content-Type:
+      - application/json; charset=utf-8
+      Vary:
+      - Accept-Encoding,X-Forwarded-Proto,X-Use-HHVM
+      X-Varnish:
+      - 1526867147, 3175927351, 2469776956
+      Via:
+      - 1.1 varnish, 1.1 varnish, 1.1 varnish
+      Transfer-Encoding:
+      - chunked
+      Date:
+      - Mon, 29 Sep 2014 09:07:30 GMT
+      Age:
+      - '0'
+      Connection:
+      - keep-alive
+      X-Cache:
+      - cp1065 miss (0), amssq52 miss (0), amssq38 frontend miss (0)
+      X-Analytics:
+      - php=zend
+      Set-Cookie:
+      - GeoIP=FR:Sainte-luce-sur-loire:47.2500:-1.5000:v4; Path=/; Domain=.wikidata.org
+    body:
+      encoding: ASCII-8BIT
+      string: '{"query-continue":{"search":{"sroffset":10}},"query":{"searchinfo":{"totalhits":416},"search":[{"ns":0,"title":"Q2831","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        \u121b\u12ed\u12ad\u120d \u1303\u12ad\u1230\u1295 <span class=\"searchmatch\">Michael</span>
+        <span class=\"searchmatch\">Jackson</span> \u0645\u0627\u064a\u0643\u0644
+        \u062c\u0627\u0643\u0633\u0648\u0646","size":8234,"wordcount":890,"timestamp":"2014-09-18T07:35:04Z"},{"ns":0,"title":"Q167877","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        \u041c\u0430\u0439\u043a\u044a\u043b \u0414\u0436\u0430\u043a\u0441\u044a\u043d
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        Michael","size":1216,"wordcount":132,"timestamp":"2014-09-14T15:28:24Z"},{"ns":0,"title":"Q507175","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        The Best of <span class=\"searchmatch\">Michael</span> Jackson","size":1503,"wordcount":233,"timestamp":"2014-06-04T10:27:12Z"},{"ns":0,"title":"Q956149","snippet":"\u0e2a\u0e1b\u0e35\u0e0a\u0e40\u0e25\u0e2a\u0e2a\u0e4c
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        Single von <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        song chanson de <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        Speechless (chanson de <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>)
+        Speechless","size":720,"wordcount":73,"timestamp":"2014-08-20T02:07:57Z"},{"ns":0,"title":"Q25158","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        del 2002 Album von <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        Love Songs Love Songs (<span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        album) Love Songs (album, <span class=\"searchmatch\">Michael</span> <span
+        class=\"searchmatch\">Jackson</span>)","size":368,"wordcount":55,"timestamp":"2014-05-09T22:51:53Z"},{"ns":0,"title":"Q1308224","snippet":"Experience
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The Experience <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The Experience <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The Experience <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The Experience <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>:
+        The","size":1131,"wordcount":124,"timestamp":"2014-05-05T08:15:06Z"},{"ns":0,"title":"Q7244161","snippet":"Prince
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I Prince <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        I \u067e\u0631\u0646\u0633","size":447,"wordcount":60,"timestamp":"2014-08-22T21:39:22Z"},{"ns":0,"title":"Q756785","snippet":"Cry
+        Cry Cry (b\u00e0i h\u00e1t c\u1ee7a <span class=\"searchmatch\">Michael</span>
+        <span class=\"searchmatch\">Jackson</span>) \u0e04\u0e23\u0e32\u0e22 chanson
+        de <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        singolo di <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        del 2001 <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        song recorded by American","size":835,"wordcount":117,"timestamp":"2014-08-20T02:40:03Z"},{"ns":0,"title":"Q1638445","snippet":"di
+        <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        del 2012 <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        album Kompilationsalbum von <span class=\"searchmatch\">Michael</span> <span
+        class=\"searchmatch\">Jackson</span> Icon (<span class=\"searchmatch\">Michael</span>-<span
+        class=\"searchmatch\">Jackson</span>-Album) Icon (album c\u1ee7a <span class=\"searchmatch\">Michael</span>
+        <span class=\"searchmatch\">Jackson</span>) Icon","size":287,"wordcount":43,"timestamp":"2014-05-07T03:24:35Z"},{"ns":0,"title":"Q44376","snippet":"<span
+        class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        album album di <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        del 2001 album by <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        Album von <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        \u00e1lbum de <span class=\"searchmatch\">Michael</span> <span class=\"searchmatch\">Jackson</span>
+        \u00e1lbum de <span class=\"searchmatch\">Michael</span> Jackson","size":2167,"wordcount":217,"timestamp":"2014-08-27T21:11:08Z"}]}}'
+    http_version: 
+  recorded_at: Mon, 29 Sep 2014 09:07:30 GMT
+recorded_with: VCR 2.9.3

data/spec/spec_helper.rb

@@ -0,0 +1,28 @@
+require "codeclimate-test-reporter"
+CodeClimate::TestReporter.start
+
+require 'wikidata'
+require 'vcr'
+require 'pry'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.syntax = [:should, :expect]
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.filter_run focus: true
+  config.run_all_when_everything_filtered = true
+
+  VCR.configure do |c|
+    c.cassette_library_dir = 'spec/fixtures/vcr'
+    c.default_cassette_options = { record: :new_episodes }
+    c.hook_into :webmock
+    c.allow_http_connections_when_no_cassette = true
+    c.configure_rspec_metadata!
+  end
+end

data/spec/wikidata/client_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Wikidata::Client do
+end

data/spec/wikidata/entity_spec.rb

@@ -0,0 +1,139 @@
+require 'spec_helper'
+
+describe Wikidata::Entity, :vcr do
+  let(:sid) { Wikidata::Item.find_by_title 'Sid Vicious' }
+  let(:homer) { Wikidata::Item.find_by_title 'Homer Simpson' }
+  let(:batofar) { Wikidata::Item.find_by_title 'Le Batofar' }
+  let(:github) { Wikidata::Item.find_by_title 'GitHub' }
+
+  describe 'properties' do
+
+    it 'should return id' do
+      sid.id.should eq 'Q47878'
+    end
+
+    it 'should return url' do
+      sid.url.should eq 'http://www.wikidata.org/wiki/Q47878'
+    end
+
+    it 'should return labels' do
+      sid.labels.en.value.should eq 'Sid Vicious'
+      sid.labels.ja.value.should eq 'シド・ヴィシャス'
+    end
+
+    it 'should return aliases' do
+      sid.aliases.en.map(&:value).should eq ['John Simon Ritchie', 'Здох через шлюху'] # ?!?
+      sid.aliases.ja.map(&:value).should eq ['シド・ビシャス']
+    end
+
+    it 'should return descriptions' do
+      sid.descriptions.en.value.should eq 'Bassist, songwriter, composer'
+    end
+
+    it 'should return sitelinks' do
+      sid.sitelinks.frwiki.should eq({"site"=>"frwiki", "title"=>"Sid Vicious", "badges"=>[]})
+    end
+
+    describe 'entities' do
+
+      it 'should return entities property from an id (P40 for children here)' do
+        homer.properties('P40').tap do |children|
+          children.size.should eq 3
+          children.each{|c| c.should be_kind_of Wikidata::Item }
+          children.map{|c| c.labels['en']['value'] }.should eq ['Bart Simpson', 'Lisa Simpson', 'Maggie Simpson']
+        end
+      end
+
+      it 'should return entities property from a key (children here)' do
+        homer.children.tap do |children|
+          children.size.should eq 3
+          children.each{|c| c.should be_kind_of Wikidata::Item }
+          children.map{|c| c.labels['en']['value'] }.should eq ['Bart Simpson', 'Lisa Simpson', 'Maggie Simpson']
+        end
+      end
+
+      it 'should allow to return only entities ids from an id' do
+        homer.property_ids('P40').should eq ["Q5480", "Q5846", "Q7834"]
+      end
+
+      it 'should allow to return only entities ids from a key' do
+        homer.children_ids.should eq ["Q5480", "Q5846", "Q7834"]
+      end
+    end
+
+    describe 'properties' do
+
+      context 'of type date' do
+        it 'should return Time from a property id (P569 for date of birth here)' do
+          homer.property('P569').tap do |date|
+            date.should be_kind_of Wikidata::Property::Time
+            date.date.should eq DateTime.new(1956, 6, 18)
+            date.range.should eq(
+              (DateTime.new(1956, 6, 18, 0, 0, 0)..DateTime.new(1956, 6, 19, 23, 59, 59))
+            )
+          end
+        end
+
+        it 'should return Time from a a key (date_of_birth here)' do
+          homer.date_of_birth.tap do |date|
+            date.should be_kind_of Wikidata::Property::Time
+            date.date.should eq DateTime.new(1956, 6, 18)
+            date.range.should eq(
+              (DateTime.new(1956, 6, 18, 0, 0, 0)..DateTime.new(1956, 6, 19, 23, 59, 59))
+            )
+          end
+        end
+      end
+
+      context 'of type globe coordinate' do
+        it 'should return GlobeCoordinate from a property id (P625 for coordinate location here)' do
+          batofar.property('P625').tap do |c|
+            c.should be_kind_of Wikidata::Property::GlobeCoordinate
+            c.latitude.should eq 48.83337778
+            c.longitude.should eq 2.37925278
+          end
+        end
+
+        it 'should return GlobeCoordinate from a key (coordinate_location here)' do
+          batofar.coordinate_location.tap do |c|
+            c.should be_kind_of Wikidata::Property::GlobeCoordinate
+            c.latitude.should eq 48.83337778
+            c.longitude.should eq 2.37925278
+          end
+        end
+      end
+
+      context 'of type string' do
+        it 'should return String from a property id (P646 for freebase identifier here)' do
+          homer.property('P646').tap do |c|
+            c.should be_kind_of Wikidata::Property::String
+            c.value.should eq '/m/0h545'
+          end
+        end
+
+        it 'should return String from a key (freebase_identifier here)' do
+          homer.freebase_identifier.tap do |c|
+            c.should be_kind_of Wikidata::Property::String
+            c.value.should eq '/m/0h545'
+          end
+        end
+      end
+
+      context 'of type url' do
+        it 'should return Url from a property id (P856 for official website here)' do
+          github.property('P856').tap do |c|
+            c.should be_kind_of Wikidata::Property::Url
+            c.value.should eq 'https://github.com'
+          end
+        end
+
+        it 'should return Url from a key (official_website here)' do
+          github.official_website.tap do |c|
+            c.should be_kind_of Wikidata::Property::Url
+            c.value.should eq 'https://github.com'
+          end
+        end
+      end
+    end
+  end
+end

data/spec/wikidata/item_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+
+describe Wikidata::Item, :vcr do
+
+  describe '#find:' do
+    let(:entity_by_id) { Wikidata::Item.find 'Q2831' }
+    let(:entity_by_title) { Wikidata::Item.find_by_title 'Michael Jackson' }
+    let(:collection_by_id) { Wikidata::Item.find ['Q2831', 'Q47878'] }
+    let(:collection_by_title) { Wikidata::Item.find_by_title ['Michael Jackson', 'Sid Vicious'] }
+
+    it 'should return nil if item not found' do
+      Wikidata::Item.find('THISISNOTAVALIDID').should be_nil
+    end
+
+    it 'should find by id' do
+      entity_by_id.should be_kind_of Wikidata::Item
+    end
+
+    it 'should find by title' do
+      entity_by_title.should be_kind_of Wikidata::Item
+    end
+
+    it 'should find by ids' do
+      collection_by_id.size.should eq 2
+      collection_by_id.should be_kind_of Wikidata::Response
+      collection_by_id.results.each{|i| i.should be_kind_of Wikidata::Item }
+    end
+
+    it 'should find by titles' do
+      collection_by_title.size.should eq 2
+      collection_by_title.should be_kind_of Wikidata::Response
+      collection_by_title.results.each{|i| i.should be_kind_of Wikidata::Item }
+    end
+  end
+
+  describe '#search' do
+    let(:search) { Wikidata::Item.search 'Michael Jackson' }
+
+    it 'should return a response with an empty array of results if search missing' do
+      Wikidata::Item.search('').tap do |s|
+        s.should be_kind_of Wikidata::Response
+        s.results.should be_empty
+      end
+    end
+
+    it 'should return an array of Wikidata::Item' do
+      search.size.should eq 10
+      search.should be_kind_of Wikidata::SearchResponse
+      search.results.each{|i| i.should be_kind_of Wikidata::Item }
+    end
+
+    it 'should return the total number of hits' do
+      search.total_hits.should eq 416
+    end
+
+    it 'should return the next page offset' do
+      search.next_page_offset.should eq 10
+    end
+
+    it 'should fetch all all items of the collection' do
+      search.results.first.descriptions.pl.value.should eq 'amerykański muzyk, kompozytor i autor tekstów'
+    end
+  end
+end