sistrix 1.0.0

data/spec/sistrix_keyword_spec.rb

@@ -0,0 +1,216 @@
+# encoding: utf-8
+
+require 'spec_helper'
+require 'sistrix'
+require 'pp'
+
+WebMock.disable_net_connect!
+include WebMock::API
+
+xml_base =  File.join(File.dirname(__FILE__), 'xml')
+domain   = 'zeit.de'
+keyword  = 'auto'
+
+
+describe "Sistrix.keyword(:kw => '[keyword]') returns a list of available API methods for the given keyword" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/keyword?api_key=&kw=#{keyword}").to_return(File.new(File.join(xml_base, 'keyword.xml')))
+    Sistrix.keyword(:kw => keyword)
+  }
+
+  its(:credits) { should == 0 }
+  its("options.size") { should == 3}
+
+  describe "options[0]" do
+    let(:option) { subject.options[0] }
+
+    it "should be" do
+      option.should be
+    end
+
+    it "method should be 'keyword.seo'" do
+      option.method.should == 'keyword.seo'
+    end
+
+    it "url should be 'http://api.sistrix.net/keyword.seo?api_key=&kw=auto'" do
+      option.url.should == 'http://api.sistrix.net/keyword.seo?api_key=&kw=auto'
+    end
+
+    it "name should be 'Organisches Ranking'" do
+      option.name.should == 'Organisches Ranking'
+    end
+  end
+
+  describe "options[1]" do
+    let(:option) { subject.options[1] }
+
+    it "should be" do
+      option.should be
+    end
+
+    it "method should be 'keyword.sem'" do
+      option.method.should == 'keyword.sem'
+    end
+
+    it "url should be 'http://api.sistrix.net/keyword.sem?api_key=&kw=auto'" do
+      option.url.should == 'http://api.sistrix.net/keyword.sem?api_key=&kw=auto'
+    end
+
+    it "name should be 'Bezahlte Werbung'" do
+      option.name.should == 'Bezahlte Werbung'
+    end
+  end
+
+  describe "options[2]" do
+    let(:option) { subject.options[2] }
+
+    it "should be" do
+      option.should be
+    end
+
+    it "method should be 'keyword.us'" do
+      option.method.should == 'keyword.us'
+    end
+
+    it "url should be 'http://api.sistrix.net/keyword.us?api_key=&kw=auto'" do
+      option.url.should == 'http://api.sistrix.net/keyword.us?api_key=&kw=auto'
+    end
+
+    it "name should be 'Universal Search-Integrationen'" do
+      option.name.should == 'Universal Search-Integrationen'
+    end
+  end
+end
+
+describe "Sistrix.keyword_seo(:kw => '[keyword]', :num => [number_of_results], :date => [date]) returns a SEO rank list of domains and URLs for the given keyword and date" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/keyword.seo?api_key=&date=last%20week&kw=#{keyword}&num=10&url=").to_return(File.new(File.join(xml_base, 'keyword.seo.xml')))
+    Sistrix.keyword_seo(:kw => keyword, :num => 10, :date => 'last week')
+  }
+
+  its(:credits) { should == 10 }
+  its(:date) { should == Time.parse('2012-04-02T00:00:00+02:00') }
+  its("results.size") { should == 10 }
+
+  describe "results[0]" do
+    let(:result) { subject.results[0] }
+
+    it "should be" do
+      result.should be
+    end
+
+    it "position should be 1" do
+      result.position.should == 1
+    end
+
+    it "domain should be 'auto.de'" do
+      result.domain.should == 'auto.de'
+    end
+
+    it "url should be 'http://www.auto.de/'" do
+      result.url.should == 'http://www.auto.de/'
+    end
+  end
+
+  describe "results[9]" do
+    let(:result) { subject.results[9] }
+
+    it "should be" do
+      result.should be
+    end
+
+    it "position should be 10" do
+      result.position.should == 10
+    end
+
+    it "domain should be 'bmw.de'" do
+      result.domain.should == 'bmw.de'
+    end
+
+    it "url should be 'http://www.bmw.de/'" do
+      result.url.should == 'http://www.bmw.de/'
+    end
+  end
+end
+
+describe "Sistrix.keyword_seo(:kw => '[keyword]', :num => [number_of_results], :date => [date], :url => [url]) returns the current SEO position for the given keyword, date and url" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/keyword.seo?api_key=&date=last%20week&kw=#{keyword}&num=10&url=http://www.autobild.de/").to_return(File.new(File.join(xml_base, 'keyword.seo_with_url.xml')))
+    Sistrix.keyword_seo(:kw => keyword, :num => 10, :date => 'last week', :url => 'http://www.autobild.de/')
+  }
+
+  its(:credits) { should == 1 }
+  its(:date) { should == Time.parse('2012-04-02T00:00:00+02:00') }
+  its("results.size") { should == 1 }
+
+  its("results.first") { should be }
+  its("results.first.position") { should == 4 }
+  its("results.first.domain") { should == 'autobild.de' }
+  its("results.first.url") { should == 'http://www.autobild.de/' }
+end
+
+describe "Sistrix.keyword_sem(:kw => '[keyword]', :num => [number_of_results], :date => [date]) returns a list of SEM bookings for the given keyword and date" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/keyword.sem?api_key=&date=now&domain=&kw=#{keyword}&num=3").to_return(File.new(File.join(xml_base, 'keyword.sem.xml')))
+    Sistrix.keyword_sem(:kw => keyword, :num => 3, :date => 'now')
+  }
+
+  its(:credits) { should == 3 }
+  its(:date) { should == Time.parse('2012-04-09T00:00:00+02:00') }
+  its("results.size") { should == 3 }
+
+  its("results.first.position") { should == 1 }
+  its("results.first.title") { should == 'mobile.de - Deutschlands größter Fahrzeugmarkt.' }
+  its("results.first.text") { should == 'Welcher ist dein Nächster?  Geprüfte Gebrauchtwagen - Günstige Jahreswagen - Neuwagen - Limousine' }
+  its("results.first.displayurl") { should == 'www.mobile.de/' }
+end
+
+describe "Sistrix.keyword_us(:kw => '[keyword]', :date => [date]) returns a list of Universal Search integration for the given keyword and date" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/keyword.us?api_key=&date=now&kw=angela+merkel").to_return(File.new(File.join(xml_base, 'keyword.us.xml')))
+    Sistrix.keyword_us(:kw => 'angela merkel', :date => 'now')
+  }
+
+  its(:credits) { should == 9 }
+  its(:date) { should ==  Time.parse('2012-04-09T00:00:00+02:00') }
+  its("results.size") { should == 9 }
+  its("results.first.type") { should == 'x' }
+  its("results.first.position") { should == 6 }
+  its("results.first.position_intern") { should == 'x' }
+  its("results.first.url") { should == 'hxxxx//xxxxxxxxxx.xxxxx.xxxxxxxxx.xxx/xxxx/xx/xxxxxx-xxxxxxx.xxx' }
+end
+
+describe "Sistrix.keyword_domain_seo(:kw => '[keyword]', :date => [date], :domain => [domain], :num => [number_of_results]) returns a list of keyword rankings for the given domain and date" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/keyword.domain.seo?api_key=&date=now&domain=mobile.de&from_pos=&host=&num=5&path=&search=&to_pos=&url=").to_return(File.new(File.join(xml_base, 'keyword.domain.seo.xml')))
+    Sistrix.keyword_domain_seo(:date => 'now', :domain => 'mobile.de', :num => 5)
+  }
+
+  its(:credits) { should == 5 }
+  its(:date) { should == Time.parse('2012-04-09T00:00:00+02:00') }
+  its("results.size") { should == 5 }
+  its("results.first.kw") { should == 'mobile' }
+  its("results.first.position") { should == 1 }
+  its("results.first.competition") { should == 67 }
+  its("results.first.traffic") { should == 70 }
+  its("results.first.url") { should == 'http://suchen.mobile.de/fahrzeuge/auto/' }
+end
+
+describe "Sistrix.keyword_domain_sem(:date => [date], :domain => [domain], :num => [number_of_results]) returns a list of keywords with SEM bookings for the given domain and date" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/keyword.domain.us?api_key=&date=now&domain=mobile.de&num=5&search=").to_return(File.new(File.join(xml_base, 'keyword.domain.us.xml')))
+    Sistrix.keyword_domain_us(:date => 'now', :domain => 'mobile.de', :num => 5)
+  }
+
+  its(:credits) { should == 5 }
+  its(:date) { should == Time.parse('2012-01-16T00:00:00+01:00') }
+  its("results.size") { should == 5 }
+
+  its("results.first.kw") { should == 'hxxxxxxx xxxxxxxx' }
+  its("results.first.type") { should == 'x' }
+  its("results.first.position") { should == 'x' }
+  its("results.first.position_intern") { should == 'x' }
+  its("results.first.competition") { should == 'xx' }
+  its("results.first.traffic") { should == 'xx' }
+end
+

data/spec/sistrix_links_spec.rb

@@ -0,0 +1,221 @@
+# encoding: utf-8
+
+require 'spec_helper'
+require 'sistrix'
+require 'pp'
+
+
+
+WebMock.disable_net_connect!
+include WebMock::API
+
+xml_base =  File.join(File.dirname(__FILE__), 'xml')
+domain   = 'zeit.de'
+keyword  = 'auto'
+
+
+
+describe "Sistrix.links_overview(:domain => [domain]) returns an overview of the link statistics for the given domain" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/links.overview?api_key=&domain=#{domain}").to_return(File.new(File.join(xml_base, 'links.overview.xml')))
+    Sistrix.links_overview(:domain => domain)
+  }
+
+  it { should be }
+
+  its(:credits) { should be 25 }
+  its(:total) { should be 2357268 }
+  its(:hosts) { should be 84489 }
+  its(:domains) { should be 51929 }
+  its(:networks) { should be 28613 }
+  its(:class_c) { should be 11878 }
+end
+
+
+
+describe "Sistrix.links_list(:domain => [domain]) returns the complete list of backlinks for the given domain" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/links.list?api_key=&domain=#{domain}").to_return(File.new(File.join(xml_base, 'links.list.xml')))
+    Sistrix.links_list(:domain => domain)
+  }
+
+  it { should be }
+
+  its(:credits) { should be 250 }
+
+  its(:links) { should be }
+  it { should have(10000).links }
+
+  describe "links[0]" do
+    let(:link) { subject.links[0] }
+
+    it "url_from should be 'http://zeit-spiel.de/shop.html'" do
+      link.url_from { should be 'http://zeit-spiel.de/shop.html' }
+    end
+
+    it "text should be 'About Time im DIE ZEIT Online Shop'" do
+      link.text { should be 'About Time im DIE ZEIT Online Shop' }
+    end
+
+    it "url_to should be 'https://shop.zeit.de/category/745-DIE-ZEIT-Spiel-ABOUT-TIME'" do
+      link.url_to { should be 'https://shop.zeit.de/category/745-DIE-ZEIT-Spiel-ABOUT-TIME' }
+    end
+  end
+
+  describe "links[9999]" do
+    let(:link) { subject.links[9999] }
+
+    it "url_from should be 'http://mooszka.blogspot.com/2008/09/johnny-clarke-yard-style.html'" do
+      link.url_from { should be 'http://mooszka.blogspot.com/2008/09/johnny-clarke-yard-style.html' }
+    end
+
+    it "text should be 'Zuender (D)'" do
+      link.text { should be 'Zuender (D)' }
+    end
+
+    it "url_to should be 'http://zuender.zeit.de/'" do
+      link.url_to { should be 'http://zuender.zeit.de/' }
+    end
+  end
+
+end
+
+
+describe "Sistrix.links_linktargets(:domain => [domain], :num => [number_of_results]) returns a list of pages with backlink statistics within the given domain" do
+    subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/links.linktargets?api_key=&domain=#{domain}&num=").to_return(File.new(File.join(xml_base, 'links.linktargets.xml')))
+    Sistrix.links_linktargets(:domain => domain)
+  }
+
+  it { should be }
+  its(:credits) { should be 100 }
+  its(:targets) { should be }
+  it { should have(100).targets }
+
+  describe "targets[0]" do
+    let(:target) { subject.targets[0] }
+
+    it "url should be 'http://zeit.de/'" do
+      target.url { should be 'http://zeit.de/' }
+    end
+
+    it "links should be 4148" do
+      target.links { should be 4148 }
+    end
+
+    it "hosts should be 321"  do
+      target.hosts { should be 321 }
+    end
+
+    it "domains should be 230" do
+      target.domains { should be 230 }
+    end
+
+    it "nets should be 185" do
+      target.nets { should be 185 }
+    end
+
+    it "ips should be 204" do
+      target.ips  { should be 204 }
+    end
+  end
+
+  describe "targets[99]" do
+    let(:target) { subject.targets[99] }
+
+    it "url should be 'http://www.zeit.de/wissen/2011-08/depressionen-pille'" do
+      target.url { should be 'http://www.zeit.de/wissen/2011-08/depressionen-pille' }
+    end
+
+    it "links should be 101" do
+      target.links { should be 101 }
+    end
+
+    it "hosts should be 33"  do
+      target.hosts { should be 33 }
+    end
+
+    it "domains should be 29" do
+      target.domains { should be 29 }
+    end
+
+    it "nets should be 24" do
+      target.nets { should be 24 }
+    end
+
+    it "ips should be 29" do
+      target.ips  { should be 29 }
+    end
+  end
+
+end
+
+
+describe "Sistrix.links_linktexts(:domain => [domain], :num => [number_of_results]) returns a list of backlink texts to the given domain" do
+    subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/links.linktexts?api_key=&domain=#{domain}&num=10").to_return(File.new(File.join(xml_base, 'links.linktexts.xml')))
+    Sistrix.links_linktexts(:domain => domain, :num => 10)
+  }
+
+  it { should be }
+  its(:credits) { should be 10 }
+  its(:linktexts) { should be }
+  it { should have(10).linktexts }
+
+  describe "linktexts[0]" do
+    let(:linktext) { subject.linktexts[0] }
+
+    it "text should be ''" do
+      linktext.text { should be '' }
+    end
+
+    it "links should be 2992" do
+      linktext.links { should be 2992 }
+    end
+
+    it "hosts should be 836"  do
+      linktext.hosts { should be 836 }
+    end
+
+    it "domains should be 576" do
+      linktext.domains { should be 576 }
+    end
+
+    it "nets should be 327" do
+      linktext.nets { should be 327 }
+    end
+
+    it "ips should be 406" do
+      linktext.ips  { should be 406 }
+    end
+  end
+
+  describe "linktexts[9]" do
+    let(:linktext) { subject.linktexts[9] }
+
+    it "text should be 'N/A'" do
+      linktext.text { should be 'N/A' }
+    end
+
+    it "links should be 172" do
+      linktext.links { should be 172 }
+    end
+
+    it "hosts should be 140"  do
+      linktext.hosts { should be 140 }
+    end
+
+    it "domains should be 117" do
+      linktext.domains { should be 117 }
+    end
+
+    it "nets should be 68" do
+      linktext.nets { should be 68 }
+    end
+
+    it "ips should be 77" do
+      linktext.ips  { should be 77 }
+    end
+  end
+
+end

data/spec/sistrix_monitoring_spec.rb

@@ -0,0 +1,190 @@
+# encoding: utf-8
+
+require 'spec_helper'
+require 'sistrix'
+require 'digest/md5'
+require 'pp'
+
+
+
+WebMock.disable_net_connect!
+include WebMock::API
+
+xml_base =  File.join(File.dirname(__FILE__), 'xml')
+domain   = 'zeit.de'
+keyword  = 'auto'
+
+
+
+
+describe "Sistrix.monitoring_projects() returns the complete list of projects for your API key" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/monitoring.projects?api_key=").to_return(File.new(File.join(xml_base, 'monitoring.projects.xml')))
+    Sistrix.monitoring_projects()
+  }
+
+  it { should be }
+
+  its(:credits) { should be 0 }
+
+  its(:projects) { should be }
+  it { should have(19).projects }
+
+  describe "projects[0]" do
+    let(:project) { subject.projects[0] }
+
+    it "name should be 'aaaaaaaaaaa.aa'" do
+      project.name { should be 'aaaaaaaaaaa.aa' }
+    end
+
+    it "id should be 'aaaaaaaa'" do
+      project.id { should be 'aaaaaaaa' }
+    end
+  end
+
+  describe "projects.last" do
+    let(:project) { subject.projects.last }
+
+    it "name should be 'sssssssssssss'" do
+      project.name { should be 'sssssssssssss' }
+    end
+
+    it "id should be 'ssssssss'" do
+      project.id { should be 'ssssssss' }
+    end
+  end
+
+end
+
+describe "Sistrix.monitoring_folders(:project => [project]) returns the list of folders for one project" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/monitoring.folders?api_key=&project=56366").to_return(File.new(File.join(xml_base, 'monitoring.folders.xml')))
+    Sistrix.monitoring_folders(:project => '56366')
+  }
+
+  it { should be }
+
+  its(:credits) { should be 0 }
+
+  its(:folders) { should be }
+  it { should have(2).folders }
+
+  describe "folders[0]" do
+    let(:folder) { subject.folders[0] }
+
+    it "name should be 'aaaaa a aaaa'" do
+      folder.name { should be 'aaaaa a aaaa' }
+    end
+
+    it "id should be 1111" do
+      folder.id { should be 5360 }
+    end
+
+    it "parent should be 0" do
+      folder.parent { should be 0 }
+    end
+
+  end
+end
+
+describe "Sistrix.monitoring_reports(:project => [project]) returns the list of available reports for one project" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/monitoring.reports?api_key=&project=56366").to_return(File.new(File.join(xml_base, 'monitoring.reports.xml')))
+    Sistrix.monitoring_reports(:project => '56366')
+  }
+
+  it { should be }
+
+  its(:credits) { should be 0 }
+
+  its(:reports) { should be }
+  it { should have(1).reports }
+
+  describe "reports[0]" do
+    let(:report) { subject.reports[0] }
+
+    it "name should be 'Oktober'" do
+      report.name { should be 'Oktober' }
+    end
+
+    it "id should be aaaaaaaaaaaaaaaa" do
+      report.id { should be 'aaaaaaaaaaaaaaaa' }
+    end
+  end
+end
+
+
+describe "Sistrix.monitoring_report(:project => [project], :report => [report]) returns the list of available report instances for the given project and report" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/monitoring.report?api_key=&project=56366&report=12356").to_return(File.new(File.join(xml_base, 'monitoring.report.xml')))
+    Sistrix.monitoring_report(:project => '56366', :report => 12356)
+  }
+
+  it { should be }
+
+  its(:credits) { should be 0 }
+
+  its(:frequency) { should == 'weekly' }
+  its(:name) { should == 'Oktober'}
+  its(:id) { should == 'aaaaaaaaaaaaaaaa' }
+  its(:format) { should == 'pdf' }
+
+  its(:recipients) { should be }
+  it { should have(1).recipients }
+
+  describe "recipients[0]" do
+    let(:recipient) { subject.recipients[0] }
+
+    it "value should be 'aa'" do
+      recipient.value { should be 'aa' }
+    end
+
+    it "type should be 'user'" do
+      recipient.type { should be 'user' }
+    end
+  end
+
+  it { should have(154).reports }
+  describe "reports[0]" do
+    let(:report) { subject.reports[0] }
+
+    it "date should be '2009-11-04T00:00:00+01:00'" do
+      report.date { should be Time.parse('2009-11-04T00:00:00+01:00') }
+    end
+
+    it "format should be 'pdf'" do
+      report.format { should be 'pdf' }
+    end
+  end
+
+
+end
+
+
+describe "Sistrix.monitoring_report_download(:project => [project], :report => [report], :date => [date]) downloads a PDF or XLS version of the specified report" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/monitoring.report.download?api_key=&project=56366&report=12356&date=2009-11-04").to_return(File.new(File.join(xml_base, 'monitoring.report.download.pdf')))
+    Sistrix.monitoring_report_download(:project => '56366', :report => '12356', :date => '2009-11-04')
+  }
+
+  it { should be }
+
+  its("data.length") { should be 85487 }
+
+  its(:data) { should satisfy { |data| Digest::MD5.hexdigest(data) == 'cf916dbe79c66e19b4e662ce376e8ae1' } }
+end
+
+
+describe "Sistrix.monitoring_report_download(:project => [project], :report => [report], :date => [erroneous_date]) returns an error when downloading a PDF or XLS version of the specified report" do
+  subject {
+    stub_request(:get, Sistrix::SERVICE_HOST + "/monitoring.report.download?api_key=&project=56366&report=12356&date=2009-11-04653").to_return(File.new(File.join(xml_base, 'monitoring.report.download_error.xml')))
+    Sistrix.monitoring_report_download(:project => '56366', :report => '12356', :date => '2009-11-04653')
+  }
+
+  it { should be }
+
+  its("error?") { should be_true }
+  its("error.code") { should == '005' }
+  its("error.message") { should == 'Date not found' }
+
+end