twittercounter 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

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

data/.watchr

@@ -0,0 +1,18 @@
+def run_spec(file)
+  unless File.exist?(file)
+    puts "#{file} does not exist"
+    return
+  end
+
+  puts "Running #{file}"
+  system "bundle exec rspec #{file}"
+  puts
+end
+
+watch("spec/.*/*_spec\.rb") do |match|
+  run_spec match[0]
+end
+
+watch("lib/(.*)\.rb") do |match|
+  run_spec %{spec/#{match[1]}_spec.rb}
+end

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+gem "httparty"
+
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "rcov", ">= 0"
+  gem "vcr"
+  gem "fakeweb"
+  gem "watchr"
+end

data/Gemfile.lock

@@ -0,0 +1,38 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    fakeweb (1.3.0)
+    git (1.2.5)
+    httparty (0.7.4)
+      crack (= 0.1.8)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.2)
+    rcov (0.9.9)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    vcr (1.10.0)
+    watchr (0.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  fakeweb
+  httparty
+  jeweler (~> 1.6.4)
+  rcov
+  rspec (~> 2.3.0)
+  vcr
+  watchr

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Jesus Lopes
+
+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.rdoc

@@ -0,0 +1,60 @@
+= twittercounter
+
+Simple library to access Twitter Counter API.
+
+== Basic Usage
+
+You'll need the API key for Twitter Counter. See the Twitter Counter API[http://twittercounter.com/pages/api] for request an API key.
+
+  Twittercounter::Client.new(:apikey => "12345", :twitter_id => "18770991")
+
+Returns object with methods:
+
+  version             : the current API version
+  username            : Twitter username of the requested user
+  url                 : URL of the request user
+  avatar              : avatar URL of the requested user
+  followers_current   : current followers count of the requested user
+  date_updated        : the latest statistics update for the requested user
+  follow_days         : the number of days Twitter Counter has been tracking the requested user
+  started_followers   : the number of followers when we started tracking the requested user
+  growth_since        : the number of followers gained since we started tracking the requested user
+  average_growth      : the average growth per day of the requested user
+  tomorrow            : our followers prediction for tomorrow for the requested user
+  next_month          : our followers prediction for the next month for the requested user
+  followers_yesterday : the number of followers for the previous day for the requested user
+  rank                : the requested user's rank as calculated by Twitter Counter
+  followersperdate    : a list of dates and the followers count on that date. The list is formatted like this: date{yyyy-mm-dd} : {followers_count}
+  last_update         : a UNIX timestamp of when this record was last updated
+
+  Other methods are:
+
+  followers_2w_ago, growth_since_2w, average_growth_2w, tomorrow_2w and next_month_2w  
+
+You can specify twitter username instead of twitter id, see:
+
+  info = Twittercounter::Client.new(:apikey => "12345", :twitter_username => "zigotto")
+
+  info.twitter_id
+  => 18770991
+
+  ...
+
+== More details
+
+Please, see Twitter Counter API[http://twittercounter.com/pages/api].
+
+== Contributing to twittercounter
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Zigotto. See LICENSE.txt for
+further details.

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "twittercounter"
+  gem.homepage = "http://github.com/zigotto/twittercounter"
+  gem.license = "MIT"
+  gem.summary = %Q{Library to access Twitter Counter API}
+  gem.description = %Q{Simple library to access Twitter Counter API}
+  gem.email = "jlopes@zigotto.com.br"
+  gem.authors = ["Jesus Lopes"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "twittercounter #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/twittercounter.rb

@@ -0,0 +1,60 @@
+require "httparty"
+
+module Twittercounter
+
+  class Request
+    include HTTParty
+  end
+
+  class Client
+
+    attr_accessor :apikey, :twitter_id
+    attr_accessor :version, :username, :url, :avatar, :followers_current, :date_updated, :follow_days, 
+      :started_followers, :growth_since, :average_growth, :tomorrow, :next_month, :followers_yesterday, 
+      :rank, :followers_2w_ago, :growth_since_2w, :average_growth_2w, :tomorrow_2w, :next_month_2w, :followersperdate, :last_update
+
+    def initialize(options={})
+      options = {:output => "json", :count => "14"}.merge!(options)
+      raise "apikey is required" if options[:apikey].blank?
+      raise "twitter_id or twitter_username is required" if options[:twitter_id].blank? && options[:twitter_username].blank?
+
+      if options.has_key?(:twitter_username)
+        twitter_id = Request.get("http://api.twitter.com/users/show.json", :query => {:screen_name => options.delete(:twitter_username)})["id"]
+        options.merge!(:twitter_id => twitter_id)
+      end
+
+      self.apikey = options[:apikey]
+      self.twitter_id = options[:twitter_id]
+
+      response = Request.get("http://api.twittercounter.com", :query => options)
+      if response.code == 200
+        self.version             = response["version"]
+        self.username            = response["username"]
+        self.url                 = response["url"]
+        self.avatar              = response["avatar"]
+        self.followers_current   = response["followers_current"]
+        self.date_updated        = response["date_updated"]
+        self.follow_days         = response["follow_days"]
+        self.started_followers   = response["started_followers"]
+        self.growth_since        = response["growth_since"]
+        self.average_growth      = response["average_growth"]
+        self.tomorrow            = response["tomorrow"]
+        self.next_month          = response["next_month"]
+        self.followers_yesterday = response["followers_yesterday"]
+        self.rank                = response["rank"]
+        self.followers_2w_ago    = response["followers_2w_ago"]
+        self.growth_since_2w     = response["growth_since_2w"]
+        self.average_growth_2w   = response["average_growth_2w"]
+        self.tomorrow_2w         = response["tomorrow_2w"]
+        self.next_month_2w       = response["next_month_2w"]
+        self.followersperdate    = response["followersperdate"]
+        self.last_update         = response["last_update"]
+      else
+        raise "#{response.code} #{response.message}"
+      end
+
+    end
+
+  end
+
+end

data/spec/fixtures/vcr_cassettes/invalid_credentials.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://api.twittercounter.com:80/?output=json&count=14&apikey=invalid_api&twitter_id=1123invalid
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 401
+      message: Unauthorized
+    headers: 
+      date: 
+      - Tue, 26 Jul 2011 05:01:33 GMT
+      server: 
+      - Apache/2.2.17 (Fedora)
+      x-powered-by: 
+      - PHP/5.3.3
+      cache-control: 
+      - no-cache, must-revalidate
+      expires: 
+      - Mon, 26 Jul 1997 05:00:00 GMT
+      content-length: 
+      - "57"
+      content-type: 
+      - application/json
+    body: "{\"version\":\"1.1\",\"error\":\"API credentials are incorrect\"}"
+    http_version: "1.1"

data/spec/fixtures/vcr_cassettes/invalid_twitter_id.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://api.twittercounter.com:80/?output=json&count=14&apikey=e9335031a759f251ee9b4e2e6634e1c5&twitter_id=123invalid456ID
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 404
+      message: Not Found
+    headers: 
+      date: 
+      - Tue, 26 Jul 2011 03:37:53 GMT
+      server: 
+      - Apache/2.2.17 (Fedora)
+      x-powered-by: 
+      - PHP/5.3.3
+      cache-control: 
+      - no-cache, must-revalidate
+      expires: 
+      - Mon, 26 Jul 1997 05:00:00 GMT
+      content-length: 
+      - "67"
+      content-type: 
+      - application/json
+    body: "{\"version\":\"1.1\",\"error\":\"Could not load statistics for this user\"}"
+    http_version: "1.1"

data/spec/fixtures/vcr_cassettes/invalid_twitter_username.yml

@@ -0,0 +1,82 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://api.twitter.com:80/users/show.json?screen_name=123invalid456ID
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 404
+      message: Not Found
+    headers: 
+      date: 
+      - Tue, 26 Jul 2011 04:35:38 GMT
+      server: 
+      - hi
+      status: 
+      - 404 Not Found
+      x-transaction: 
+      - 1311654938-43980-14664
+      x-ratelimit-limit: 
+      - "150"
+      x-frame-options: 
+      - SAMEORIGIN
+      last-modified: 
+      - Tue, 26 Jul 2011 04:35:38 GMT
+      x-ratelimit-remaining: 
+      - "109"
+      content-type: 
+      - application/json; charset=utf-8
+      content-length: 
+      - "80"
+      pragma: 
+      - no-cache
+      x-ratelimit-class: 
+      - api
+      x-revision: 
+      - DEV
+      expires: 
+      - Tue, 31 Mar 1981 05:00:00 GMT
+      cache-control: 
+      - no-cache, no-store, must-revalidate, pre-check=0, post-check=0
+      x-mid: 
+      - 071266308458f6c6b96c2cc6b218ca95e3979a05
+      x-ratelimit-reset: 
+      - "1311655885"
+      set-cookie: 
+      - k=201.23.177.72.1311654938689734; path=/; expires=Tue, 02-Aug-11 04:35:38 GMT; domain=.twitter.com
+      - guest_id=v1%3A13116549386953595; domain=.twitter.com; path=/; expires=Thu, 25 Jul 2013 16:35:38 GMT
+      - _twitter_sess=BAh7CDoPY3JlYXRlZF9hdGwrCEgIumQxAToHaWQiJWMxNWI0MzA3OTY3ZGVh%250AYmRkYzg4NDFkMWY4OTYyN2YwIgpmbGFzaElDOidBY3Rpb25Db250cm9sbGVy%250AOjpGbGFzaDo6Rmxhc2hIYXNoewAGOgpAdXNlZHsA--5cab84a84a8327447e4631d3810db95b5861fd47; domain=.twitter.com; path=/; HttpOnly
+      vary: 
+      - Accept-Encoding
+    body: "{\"error\":\"Not found\",\"request\":\"\\/users\\/show.json?screen_name=123invalid456ID\"}"
+    http_version: "1.1"
+
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://api.twittercounter.com:80/?output=json&count=14&apikey=e9335031a759f251ee9b4e2e6634e1c5&twitter_id=
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 404
+      message: Not Found
+    headers: 
+      date: 
+      - Tue, 26 Jul 2011 04:42:23 GMT
+      server: 
+      - Apache/2.2.17 (Fedora)
+      x-powered-by: 
+      - PHP/5.3.3
+      cache-control: 
+      - no-cache, must-revalidate
+      expires: 
+      - Mon, 26 Jul 1997 05:00:00 GMT
+      content-length: 
+      - "58"
+      content-type: 
+      - application/json
+    body: "{\"version\":\"1.1\",\"error\":\"Invalid username or twitter_id\"}"
+    http_version: "1.1"

data/spec/fixtures/vcr_cassettes/twitter_id_15160529.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://api.twittercounter.com:80/?output=json&count=14&apikey=e9335031a759f251ee9b4e2e6634e1c5&twitter_id=15160529
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      date: 
+      - Tue, 26 Jul 2011 03:28:09 GMT
+      server: 
+      - Apache/2.2.17 (Fedora)
+      x-powered-by: 
+      - PHP/5.3.3
+      cache-control: 
+      - max-age=1800, must-revalidate
+      expires: 
+      - Tue, 26 Jul 2011 03:58:10 GMT
+      content-length: 
+      - "872"
+      content-type: 
+      - application/json
+    body: "{\"version\":\"1.1\",\"username\":\"TheCounter\",\"url\":\"http:\\/\\/twittercounter.com\\/\",\"avatar\":\"http:\\/\\/a1.twimg.com\\/profile_images\\/481277925\\/twc_logo_normal.png\",\"followers_current\":10305,\"date_updated\":\"2011-07-25\",\"follow_days\":\"663\",\"started_followers\":\"3617\",\"growth_since\":6688,\"average_growth\":\"10\",\"tomorrow\":\"10315\",\"next_month\":\"10605\",\"followers_yesterday\":10299,\"rank\":\"38148\",\"followers_2w_ago\":10139,\"growth_since_2w\":166,\"average_growth_2w\":\"12\",\"tomorrow_2w\":\"10317\",\"next_month_2w\":\"10665\",\"followersperdate\":{\"date2011-07-25\":10305,\"date2011-07-24\":10299,\"date2011-07-23\":10308,\"date2011-07-22\":10300,\"date2011-07-21\":10284,\"date2011-07-20\":10268,\"date2011-07-19\":10252,\"date2011-07-18\":10236,\"date2011-07-17\":10220,\"date2011-07-16\":10216,\"date2011-07-15\":10199,\"date2011-07-14\":10175,\"date2011-07-13\":10160,\"date2011-07-12\":10154},\"last_update\":1311650890}"
+    http_version: "1.1"

data/spec/fixtures/vcr_cassettes/twitter_username_zigotto.yml

@@ -0,0 +1,88 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://api.twitter.com:80/users/show.json?screen_name=zigotto
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      date: 
+      - Tue, 26 Jul 2011 04:16:02 GMT
+      server: 
+      - hi
+      status: 
+      - 200 OK
+      x-transaction: 
+      - 1311653762-27604-12924
+      x-ratelimit-limit: 
+      - "150"
+      etag: 
+      - "\"20f09e76f4e18e5a84c5a1776ceb6088\""
+      x-frame-options: 
+      - SAMEORIGIN
+      last-modified: 
+      - Tue, 26 Jul 2011 04:16:02 GMT
+      x-ratelimit-remaining: 
+      - "119"
+      x-runtime: 
+      - "0.02314"
+      x-transaction-mask: 
+      - a6183ffa5f8ca943ff1b53b5644ef114b15be17f
+      content-type: 
+      - application/json; charset=utf-8
+      content-length: 
+      - "1987"
+      pragma: 
+      - no-cache
+      x-ratelimit-class: 
+      - api
+      x-revision: 
+      - DEV
+      expires: 
+      - Tue, 31 Mar 1981 05:00:00 GMT
+      cache-control: 
+      - no-cache, no-store, must-revalidate, pre-check=0, post-check=0
+      x-mid: 
+      - 35391f55fcd3c1ef007504e90dcf0d4283e95e8f
+      x-ratelimit-reset: 
+      - "1311655885"
+      set-cookie: 
+      - k=201.23.177.72.1311653762806791; path=/; expires=Tue, 02-Aug-11 04:16:02 GMT; domain=.twitter.com
+      - guest_id=v1%3A131165376295821549; domain=.twitter.com; path=/; expires=Thu, 25 Jul 2013 16:16:02 GMT
+      - _twitter_sess=BAh7CDoPY3JlYXRlZF9hdGwrCJEXqGQxAToHaWQiJWFlMTQxOGJkMThlN2Ni%250AZDRhZmY2MmI5NjI1Njk0ZDY1IgpmbGFzaElDOidBY3Rpb25Db250cm9sbGVy%250AOjpGbGFzaDo6Rmxhc2hIYXNoewAGOgpAdXNlZHsA--e542ca3175dcd4bb1b76c29853d5df29cb266cbc; domain=.twitter.com; path=/; HttpOnly
+      vary: 
+      - Accept-Encoding
+    body: "{\"default_profile_image\":false,\"default_profile\":false,\"statuses_count\":264,\"profile_sidebar_border_color\":\"eeeeee\",\"protected\":false,\"contributors_enabled\":false,\"following\":false,\"time_zone\":\"Greenland\",\"favourites_count\":0,\"url\":\"http:\\/\\/www.zigotto.com.br\",\"name\":\"Zigotto\",\"is_translator\":false,\"verified\":false,\"notifications\":false,\"profile_use_background_image\":true,\"follow_request_sent\":false,\"utc_offset\":-10800,\"created_at\":\"Thu Jan 08 17:30:09 +0000 2009\",\"friends_count\":15,\"profile_background_color\":\"f7f7f7\",\"profile_background_image_url\":\"http:\\/\\/a0.twimg.com\\/profile_background_images\\/172928449\\/bg_site.jpg\",\"status\":{\"in_reply_to_status_id_str\":null,\"coordinates\":null,\"in_reply_to_screen_name\":null,\"in_reply_to_status_id\":null,\"in_reply_to_user_id_str\":null,\"contributors\":null,\"retweeted\":false,\"created_at\":\"Tue Jun 28 21:11:29 +0000 2011\",\"text\":\"Aten\\u00e7\\u00e3o desenvolvedores do Vale do Para\\u00edba, n\\u00e3o percam www.agilevale.com.br #AgileVale\",\"in_reply_to_user_id\":null,\"place\":null,\"geo\":null,\"retweet_count\":1,\"source\":\"\\u003Ca href=\\\"http:\\/\\/itunes.apple.com\\/us\\/app\\/twitter\\/id409789998?mt=12\\\" rel=\\\"nofollow\\\"\\u003ETwitter for Mac\\u003C\\/a\\u003E\",\"truncated\":false,\"id\":85817618442895360,\"id_str\":\"85817618442895360\",\"favorited\":false},\"profile_text_color\":\"333333\",\"description\":\"Desenvolvimento Web.\",\"listed_count\":15,\"lang\":\"en\",\"profile_sidebar_fill_color\":\"e0e0e0\",\"profile_image_url\":\"http:\\/\\/a3.twimg.com\\/profile_images\\/1267147803\\/zigotto-twitter_normal.jpg\",\"show_all_inline_media\":false,\"geo_enabled\":true,\"profile_background_tile\":true,\"followers_count\":224,\"profile_background_image_url_https\":\"https:\\/\\/si0.twimg.com\\/profile_background_images\\/172928449\\/bg_site.jpg\",\"screen_name\":\"zigotto\",\"id\":18770991,\"id_str\":\"18770991\",\"profile_link_color\":\"941896\",\"profile_image_url_https\":\"https:\\/\\/si0.twimg.com\\/profile_images\\/1267147803\\/zigotto-twitter_normal.jpg\",\"location\":\"S\\u00e3o Jos\\u00e9 dos Campos, SP, Brazi\"}"
+    http_version: "1.1"
+
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://api.twittercounter.com:80/?output=json&count=14&apikey=e9335031a759f251ee9b4e2e6634e1c5&twitter_id=18770991
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      date: 
+      - Tue, 26 Jul 2011 04:22:54 GMT
+      server: 
+      - Apache/2.2.17 (Fedora)
+      x-powered-by: 
+      - PHP/5.3.3
+      cache-control: 
+      - max-age=1800, must-revalidate
+      expires: 
+      - Tue, 26 Jul 2011 04:52:58 GMT
+      content-length: 
+      - "448"
+      content-type: 
+      - application/json
+    body: "{\"version\":\"1.1\",\"username\":\"zigotto\",\"url\":\"http:\\/\\/www.zigotto.com.br\",\"avatar\":\"http:\\/\\/a3.twimg.com\\/profile_images\\/1267147803\\/zigotto-twitter_normal.jpg\",\"followers_current\":224,\"date_updated\":\"2011-07-25\",\"follow_days\":\"15181\",\"started_followers\":null,\"growth_since\":224,\"average_growth\":\"0\",\"tomorrow\":\"224\",\"next_month\":\"224\",\"followers_yesterday\":null,\"rank\":\"340176\",\"followersperdate\":{\"date2011-07-25\":224},\"last_update\":1311653970}"
+    http_version: "1.1"

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'vcr'
+require 'twittercounter'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.extend VCR::RSpec::Macros
+end
+
+VCR.config do |c|
+  c.cassette_library_dir = 'spec/fixtures/vcr_cassettes'
+  c.stub_with :fakeweb
+  c.default_cassette_options = { :record => :once }
+  c.allow_http_connections_when_no_cassette = false
+end

data/spec/twittercounter_spec.rb

@@ -0,0 +1,104 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Twittercounter do
+
+  context "when use a invalid credentials" do
+    use_vcr_cassette "invalid_credentials"
+    it { expect { Twittercounter::Client.new(:apikey => "invalid_api", :twitter_id => "1123invalid")}.to raise_error(/401 Unauthorized/) }
+  end
+
+  context "when use a invalid twitter id" do
+    use_vcr_cassette "invalid_twitter_id"
+    it { expect { Twittercounter::Client.new(:apikey => "e9335031a759f251ee9b4e2e6634e1c5", :twitter_id => "123invalid456ID")}.to raise_error(/404 Not Found/) }
+  end
+
+  context "when use a invalid twitter username" do
+    use_vcr_cassette "invalid_twitter_username"
+    it { expect { Twittercounter::Client.new(:apikey => "e9335031a759f251ee9b4e2e6634e1c5", :twitter_username => "123invalid456ID")}.to raise_error(/404 Not Found/) }
+  end
+
+  context "when invalid required parameters" do
+    it "should raise exception when apikey is blank" do
+      expect { Twittercounter::Client.new(:apikey => nil, :twitter_id => "15160529")}.to raise_error(/apikey is required/)
+      expect { Twittercounter::Client.new(:twitter_id => "15160529")}.to raise_error(/apikey is required/)
+    end
+    it "should raise exception when twitter_id is blank" do
+      expect { Twittercounter::Client.new(:apikey => "adfas123", :twitter_id => nil)}.to raise_error(/twitter_id or twitter_username is required/)
+    end
+    it "should raise exception when twitter_username is blank" do
+      expect { Twittercounter::Client.new(:apikey => "adfas123", :twitter_username => nil)}.to raise_error(/twitter_id or twitter_username is required/)
+    end
+  end
+
+  context "provides information about a twitter username" do
+
+    use_vcr_cassette "twitter_username_zigotto"
+
+    let(:info) do
+      Twittercounter::Client.new(
+        :apikey => "e9335031a759f251ee9b4e2e6634e1c5",
+        :twitter_username => "zigotto"
+      )
+    end
+
+    it { info.twitter_id.should == 18770991 }
+    it { info.username.should == "zigotto" }
+    it { info.followers_current.should == 224 }
+
+  end
+
+  context "provides information about a twitter id" do
+
+    use_vcr_cassette "twitter_id_15160529"
+
+    let(:info) do
+      Twittercounter::Client.new(
+        :apikey => "e9335031a759f251ee9b4e2e6634e1c5",
+        :twitter_id => "15160529"
+      )
+    end
+
+    it { info.apikey.should == "e9335031a759f251ee9b4e2e6634e1c5" }
+    it { info.twitter_id.should == "15160529" }
+
+    it { info.version.should == "1.1" }
+    it { info.username.should == "TheCounter" }
+    it { info.url.should == "http://twittercounter.com/" }
+    it { info.avatar.should == "http://a1.twimg.com/profile_images/481277925/twc_logo_normal.png" }
+    it { info.followers_current.should == 10305 }
+    it { info.date_updated.should == Date.new(2011, 07, 25) }
+    it { info.follow_days.should == "663" }
+    it { info.started_followers.should == "3617" }
+    it { info.growth_since.should == 6688 }
+    it { info.average_growth.should == "10" }
+    it { info.tomorrow.should == "10315" }
+    it { info.next_month.should == "10605" }
+    it { info.followers_yesterday.should == 10299 }
+    it { info.rank.should == "38148" }
+    it { info.followers_2w_ago.should == 10139 }
+    it { info.growth_since_2w.should == 166 }
+    it { info.average_growth_2w.should == "12" }
+    it { info.tomorrow_2w.should == "10317" }
+    it { info.next_month_2w.should == "10665" }
+    it { info.followersperdate.should == {
+      "date2011-07-25"=>10305,
+      "date2011-07-24"=>10299,
+      "date2011-07-23"=>10308,
+      "date2011-07-22"=>10300,
+      "date2011-07-21"=>10284,
+      "date2011-07-20"=>10268,
+      "date2011-07-19"=>10252,
+      "date2011-07-18"=>10236,
+      "date2011-07-17"=>10220,
+      "date2011-07-16"=>10216,
+      "date2011-07-15"=>10199,
+      "date2011-07-14"=>10175,
+      "date2011-07-13"=>10160,
+      "date2011-07-12"=>10154
+      }
+    }
+    it { info.last_update.should == 1311650890 }
+
+  end
+
+end

data/twittercounter.gemspec

@@ -0,0 +1,78 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{twittercounter}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jesus Lopes"]
+  s.date = %q{2011-07-26}
+  s.description = %q{Simple library to access Twitter Counter API}
+  s.email = %q{jlopes@zigotto.com.br}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".watchr",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/twittercounter.rb",
+    "spec/fixtures/vcr_cassettes/invalid_credentials.yml",
+    "spec/fixtures/vcr_cassettes/invalid_twitter_id.yml",
+    "spec/fixtures/vcr_cassettes/invalid_twitter_username.yml",
+    "spec/fixtures/vcr_cassettes/twitter_id_15160529.yml",
+    "spec/fixtures/vcr_cassettes/twitter_username_zigotto.yml",
+    "spec/spec_helper.rb",
+    "spec/twittercounter_spec.rb",
+    "twittercounter.gemspec"
+  ]
+  s.homepage = %q{http://github.com/zigotto/twittercounter}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.7.2}
+  s.summary = %q{Library to access Twitter Counter API}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<vcr>, [">= 0"])
+      s.add_development_dependency(%q<fakeweb>, [">= 0"])
+      s.add_development_dependency(%q<watchr>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<vcr>, [">= 0"])
+      s.add_dependency(%q<fakeweb>, [">= 0"])
+      s.add_dependency(%q<watchr>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<vcr>, [">= 0"])
+    s.add_dependency(%q<fakeweb>, [">= 0"])
+    s.add_dependency(%q<watchr>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification 
+name: twittercounter
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Jesus Lopes
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-26 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.6.4
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: vcr
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: watchr
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id008
+description: Simple library to access Twitter Counter API
+email: jlopes@zigotto.com.br
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- .watchr
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/twittercounter.rb
+- spec/fixtures/vcr_cassettes/invalid_credentials.yml
+- spec/fixtures/vcr_cassettes/invalid_twitter_id.yml
+- spec/fixtures/vcr_cassettes/invalid_twitter_username.yml
+- spec/fixtures/vcr_cassettes/twitter_id_15160529.yml
+- spec/fixtures/vcr_cassettes/twitter_username_zigotto.yml
+- spec/spec_helper.rb
+- spec/twittercounter_spec.rb
+- twittercounter.gemspec
+homepage: http://github.com/zigotto/twittercounter
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -3982709042434259989
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: Library to access Twitter Counter API
+test_files: []
+