twelve 0.1.0

data/spec/twelve/api/gauges/content_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Content do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  describe "#content" do
+    context "with no args" do
+      it "should return top content" do
+        VCR.use_cassette('content') do
+          response = subject.gauges(GAUGE_ID).content
+          response['date'].should_not be_nil
+          response['page'].should == 1
+          response['per_page'].should == 50
+          response.should have_key('urls')
+
+          content = response['content']
+          content.size.should > 0
+          content.first['title'].should_not be_nil
+          content.first['views'].should be_instance_of(Fixnum)
+          content.first['path'].should_not be_nil
+          content.first['host'].should_not be_nil
+        end
+      end
+    end
+
+    context "with page number" do
+      it "should return content for page" do
+        VCR.use_cassette('content(:page => 2)') do
+          response = subject.gauges(GAUGE_ID).content(:page => 2)
+          response['page'].should == 2
+        end
+      end
+    end
+
+    context "with a date" do
+      it "should return content for that date" do
+        VCR.use_cassette('content("2011-12-8")') do
+          response = subject.gauges(GAUGE_ID).content('2011-12-8')
+          response['date'].should == '2011-12-08'
+        end
+      end
+    end
+
+    context "with a date and page" do
+      it "should return content for that date" do
+        VCR.use_cassette('content("2011-12-8", :page => 2)') do
+          response = subject.gauges(GAUGE_ID).content('2011-12-8', :page => 2)
+          response['date'].should == '2011-12-08'
+          response['page'].should == 2
+        end
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges/engines_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Engines do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  describe "#engines" do
+    context "with no args" do
+      it "should return search engines" do
+        VCR.use_cassette('engines') do
+          response = subject.gauges(GAUGE_ID).engines
+          response['date'].should_not be_nil
+          response.should have_key('urls')
+
+          engines = response['engines']
+          engines.size.should > 0
+          engines.first['title'].should_not be_nil
+          engines.first['views'].should be_instance_of(Fixnum)
+          engines.first['key'].should_not be_nil
+        end
+      end
+    end
+
+    context "with a date" do
+      it "should return engines for that date" do
+        VCR.use_cassette('engines("2011-12-8")') do
+          response = subject.gauges(GAUGE_ID).engines('2011-12-8')
+          response['date'].should == '2011-12-08'
+        end
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges/locations_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Locations do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  describe "#locations" do
+    context "with no args" do
+      it "should return locations" do
+        VCR.use_cassette('locations') do
+          response = subject.gauges(GAUGE_ID).locations
+          response['date'].should_not be_nil
+          response.should have_key('urls')
+
+          locations = response['locations']
+          locations.size.should > 0
+          locations.first['title'].should_not be_nil
+          locations.first['views'].should be_instance_of(Fixnum)
+          locations.first['key'].should_not be_nil
+        end
+      end
+    end
+
+    context "with a date" do
+      it "should return locations for that date" do
+        VCR.use_cassette('locations("2011-12-8")') do
+          response = subject.gauges(GAUGE_ID).locations('2011-12-8')
+          response['date'].should == '2011-12-08'
+        end
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges/referrers_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Referrers do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  describe "#referrers" do
+    context "with no args" do
+      it "should return todays referrers" do
+        VCR.use_cassette('referrers') do
+          response = subject.gauges(GAUGE_ID).referrers
+          response['date'].should_not be_nil
+          response['page'].should == 1
+          response['per_page'].should == 50
+          response.should have_key('urls')
+
+          referrers = response['referrers']
+          referrers.size.should > 0
+          referrers.first['url'].should_not be_nil
+          referrers.first['views'].should be_instance_of(Fixnum)
+          referrers.first['path'].should_not be_nil
+          referrers.first['host'].should_not be_nil
+        end
+      end
+    end
+
+    context "with page number" do
+      it "should return content for page" do
+        VCR.use_cassette('referrers(:page => 2)') do
+          response = subject.gauges(GAUGE_ID).referrers(:page => 2)
+          response['page'].should == 2
+        end
+      end
+    end
+
+    context "with a date" do
+      it "should return content for that date" do
+        VCR.use_cassette('referrers("2011-12-8")') do
+          response = subject.gauges(GAUGE_ID).referrers('2011-12-8')
+          response['date'].should == '2011-12-08'
+        end
+      end
+    end
+
+    context "with a date and page" do
+      it "should return content for that date" do
+        VCR.use_cassette('referrers("2011-12-8", :page => 2)') do
+          response = subject.gauges(GAUGE_ID).referrers('2011-12-8', :page => 2)
+          response['date'].should == '2011-12-08'
+          response['page'].should == 2
+        end
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges/resolutions_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Resolutions do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  describe "#resolutions" do
+    context "with no args" do
+      it "should return top resolutions" do
+        VCR.use_cassette('resolutions') do
+          response = subject.gauges(GAUGE_ID).resolutions
+          response['date'].should_not be_nil
+          response.should have_key('urls')
+
+          browser_heights = response['browser_heights']
+          browser_heights.first['title'].should_not be_nil
+          browser_heights.first['views'].should be_instance_of(Fixnum)
+          browser_widths = response['browser_widths']
+          browser_widths.first['title'].should_not be_nil
+          browser_widths.first['views'].should be_instance_of(Fixnum)
+          screen_widths = response['screen_widths']
+          screen_widths.first['title'].should_not be_nil
+          screen_widths.first['views'].should be_instance_of(Fixnum)
+        end
+      end
+    end
+
+    context "with a date" do
+      it "should return resolutions for that date" do
+        VCR.use_cassette('resolutions("2011-12-8")') do
+          response = subject.gauges(GAUGE_ID).resolutions('2011-12-8')
+          response['date'].should == '2011-12-08'
+        end
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges/shares_spec.rb

@@ -0,0 +1,74 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Shares do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  def should_be_a_share(gauge, share)
+    share['name'].should_not be_nil
+    share['id'].should_not be_nil
+    ['user', 'invite'].should include(share['type'])
+    share['email'].should_not be_nil
+    share['urls']['remove'].should == "https://secure.gaug.es/gauges/#{gauge['id']}/shares/#{share['id']}"
+  end
+
+  describe "#shares" do
+    it "returns list of users gauge is shared with" do
+      VCR.use_cassette('shares') do
+        # setup
+        temp = subject.gauges.create({
+          :title => 'Twelve Gauge',
+          :tz => 'Eastern Time (US & Canada)'
+        })
+        subject.gauges(temp['id']).share({:email => 'john@doe.com'})
+
+        # the meat of the test
+        shares = subject.gauges(temp['id']).shares
+        shares.size.should > 0
+        should_be_a_share(temp, shares.first)
+
+        # teardown
+        subject.gauges(temp['id']).destroy
+      end
+    end
+  end
+
+  describe "#share" do
+    it "shares gauge" do
+      VCR.use_cassette('share') do
+        # setup
+        temp = subject.gauges.create({
+          :title => 'Twelve Gauge',
+          :tz => 'Eastern Time (US & Canada)'
+        })
+
+        # the meat of the test
+        share = subject.gauges(temp['id']).share({:email => 'john@doe.com'})
+        should_be_a_share(temp, share)
+        share['email'].should == 'john@doe.com'
+
+        # teardown
+        subject.gauges(temp['id']).destroy
+      end
+    end
+  end
+
+  describe "#unshare" do
+    it "un-shares a gauge" do
+      VCR.use_cassette('unshare') do
+        # setup
+        temp = subject.gauges.create({
+          :title => 'Twelve Gauge',
+          :tz => 'Eastern Time (US & Canada)'
+        })
+        temp_share = subject.gauges(temp['id']).share({:email => 'john@doe.com'})
+
+        # the meat of the test
+        share = subject.gauges(temp['id']).unshare(temp_share['id'])
+        share['id'].should == temp_share['id']
+
+        # teardown
+        subject.gauges(temp['id']).destroy
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges/technology_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Technology do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  describe "#technology" do
+    context "with no args" do
+      it "should return top technology" do
+        VCR.use_cassette('technology') do
+          response = subject.gauges(GAUGE_ID).technology
+          response['date'].should_not be_nil
+          response.should have_key('urls')
+
+          browsers = response['browsers']
+          browsers.first['title'].should_not be_nil
+          browsers.first['views'].should be_instance_of(Fixnum)
+          browsers.first['versions'].size.should > 0
+          browsers.first['key'].should_not be_nil
+          platforms = response['platforms']
+          platforms.first['title'].should_not be_nil
+          platforms.first['views'].should be_instance_of(Fixnum)
+          platforms.first['key'].should_not be_nil
+        end
+      end
+    end
+
+    context "with a date" do
+      it "should return technology for that date" do
+        VCR.use_cassette('technology("2011-12-8")') do
+          response = subject.gauges(GAUGE_ID).technology('2011-12-8')
+          response['date'].should == '2011-12-08'
+        end
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges/terms_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Terms do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  describe "#terms" do
+    context "with no args" do
+      it "should return search terms" do
+        VCR.use_cassette('terms') do
+          response = subject.gauges(GAUGE_ID).terms
+          response['date'].should_not be_nil
+          response['page'].should == 1
+          response['per_page'].should == 50
+          response.should have_key('urls')
+
+          terms = response['terms']
+          terms.size.should > 0
+          terms.first['term'].should_not be_nil
+          terms.first['views'].should be_instance_of(Fixnum)
+        end
+      end
+    end
+
+    context "with page number" do
+      it "should return terms for page" do
+        VCR.use_cassette('terms(:page => 2)') do
+          response = subject.gauges(GAUGE_ID).terms(:page => 2)
+          response['page'].should == 2
+        end
+      end
+    end
+
+    context "with a date" do
+      it "should return terms for that date" do
+        VCR.use_cassette('terms("2011-12-8")') do
+          response = subject.gauges(GAUGE_ID).terms('2011-12-8')
+          response['date'].should == '2011-12-08'
+        end
+      end
+    end
+
+    context "with a date and page" do
+      it "should return terms for that date" do
+        VCR.use_cassette('terms("2011-12-8", :page => 2)') do
+          response = subject.gauges(GAUGE_ID).terms('2011-12-8', :page => 2)
+          response['date'].should == '2011-12-08'
+          response['page'].should == 2
+        end
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges/traffic_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges::Traffic do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  describe "#traffic" do
+    context "with no args" do
+      it "should return top traffic" do
+        VCR.use_cassette('traffic') do
+          response = subject.gauges(GAUGE_ID).traffic
+          response['date'].should_not be_nil
+          response.should have_key('urls')
+          response['views'].should be_instance_of(Fixnum)
+          response['people'].should be_instance_of(Fixnum)
+
+          traffic = response['traffic']
+          traffic.size.should > 0
+          traffic.first['date'].should_not be_nil
+          traffic.first['views'].should be_instance_of(Fixnum)
+          traffic.first['people'].should be_instance_of(Fixnum)
+        end
+      end
+    end
+
+    context "with a date" do
+      it "should return traffic for that date" do
+        VCR.use_cassette('traffic("2011-12-8")') do
+          response = subject.gauges(GAUGE_ID).traffic('2011-12-8')
+          response['date'].should == '2011-12-08'
+        end
+      end
+    end
+  end
+end

data/spec/twelve/api/gauges_spec.rb

@@ -0,0 +1,119 @@
+require 'spec_helper'
+
+describe Twelve::API::Gauges do
+  subject { Twelve.new(ACCESS_TOKEN) }
+
+  def should_be_a_gauge(gauge)
+    gauge['id'].should_not be_nil
+    gauge['title'].should_not be_nil
+    gauge['tz'].should_not be_nil
+    gauge['urls']['self'].should == "https://secure.gaug.es/gauges/#{gauge['id']}"
+    gauge['urls']['referrers'].should == "https://secure.gaug.es/gauges/#{gauge['id']}/referrers"
+    gauge['urls']['technology'].should == "https://secure.gaug.es/gauges/#{gauge['id']}/technology"
+    gauge.should have_key('all_time')
+    gauge.should have_key('today')
+    gauge.should have_key('yesterday')
+    gauge.should have_key('recent_hours')
+    gauge.should have_key('recent_days')
+    gauge.should have_key('recent_months')
+  end
+
+  describe "#gauges" do
+    # will only pass if you already have a gauge created on your account
+    context "without an id" do
+      it "returns your gauges" do
+        VCR.use_cassette('gauges') do
+          # setup
+          temp = subject.gauges.create({
+            :title => 'Twelve Gauge',
+            :tz => 'Eastern Time (US & Canada)'
+          })
+
+          # actually run the request and tests
+          gauges = subject.gauges
+          gauges.should be_instance_of(Array)
+          gauges.size.should > 0
+          should_be_a_gauge(gauges.first)
+
+           # teardown
+          subject.gauges(temp['id']).destroy
+        end
+      end
+
+      describe "#create" do
+        it "creates and returns gauge" do
+          VCR.use_cassette('gauges_create') do
+            gauge = subject.gauges.create({
+              :title => 'Twelve Gauge',
+              :tz => 'Eastern Time (US & Canada)'
+            })
+            should_be_a_gauge(gauge)
+            gauge['title'].should == 'Twelve Gauge'
+
+            # teardown
+            subject.gauges(gauge['id']).destroy
+          end
+        end
+      end
+    end
+    #
+    context "with an id" do
+      context "with attributes" do
+        it "updates and returns the gauge" do
+          VCR.use_cassette('gauges(id, attributes)') do
+            # setup
+            temp = subject.gauges.create({
+              :title => 'Twelve Gauge',
+              :tz => 'Eastern Time (US & Canada)'
+            })
+
+            gauge = subject.gauges(temp['id'], {
+              :title => '12 Gauge'
+            })
+            should_be_a_gauge(gauge)
+            gauge['title'].should == '12 Gauge'
+
+             # teardown
+            subject.gauges(temp['id']).destroy
+          end
+        end
+      end
+
+      context "without attributes" do
+        it "returns a gauge" do
+          VCR.use_cassette('gauges(id)') do
+            # setup
+            temp = subject.gauges.create({
+              :title => 'Twelve Gauge',
+              :tz => 'Eastern Time (US & Canada)'
+            })
+
+            # actually run the request and tests
+            gauge = subject.gauges(temp['id'])
+            should_be_a_gauge(gauge)
+            gauge['title'].should == 'Twelve Gauge'
+
+             # teardown
+            subject.gauges(temp['id']).destroy
+          end
+        end
+
+        describe "#delete" do
+          it "deletes and returns gauge" do
+            VCR.use_cassette('gauges_delete') do
+              # setup
+              delete = subject.gauges.create({
+                :title => 'Twelve Gauge',
+                :tz => 'Eastern Time (US & Canada)'
+              })
+
+              gauge = subject.gauges(delete['id']).destroy
+              should_be_a_gauge(gauge)
+              gauge['id'].should == delete['id']
+            end
+          end
+        end
+      end
+    end
+  end
+end