squeejee-twitterland 0.0.2 → 0.1.1

data/History

@@ -1 +1,2 @@
+0.1.0 - Added TweetBlocker # http://tweetblocker.com/
 0.0.1 - initial release

data/README.markdown

@@ -0,0 +1,151 @@
+# twitterland
+
+Twitterland is a Ruby gem that bundles various Twitter-related APIs
+
+Including:
+
+* Follow Cost
+* Twitter Grader
+* Mr. Tweet
+* Twinfluence 
+* Twitter Counter
+* TweetBlocker
+
+### Install
+     sudo gem install twitterland
+
+### Follow Cost Usage
+    # Get follow cost for specified user
+    Twitterland::FollowCost.show('bradleyjoyce')
+
+    => <Mash at_reply_index=24.0 average_tweets_per_day=6.87254901960784 average_tweets_per_day_recently=19.6396220282001 golden_index=3.0 milliscobles_all_time=324.02 milliscobles_recently=925.96 political_index=1.0 profile_image_url="http://s3.amazonaws.com/twitter_production/profile_images/179927752/bradley_normal.png" statuses_count=3505 twitter_created_at="2008/03/14 18:26:52 -0700" username="bradleyjoyce">
+
+### Twitter Grader Usage
+    # request your api key at [http://twitter.grader.com/accessrequestform](http://twitter.grader.com/accessrequestform)
+    # get twitter grade for user
+    api_key = "OU812"
+    Twitterland::TwitterGrader.grade('bradleyjoyce', api_key)
+
+    => 98.4183
+
+### Mr.Tweet Usage
+##### get your api key at [http://api.mrtweet.com/newapi](http://api.mrtweet.com/newapi)
+#### Initialize Mrtweet
+    api_key = 'OU812'
+    mt = Twitterland::Mrtweet.new(api_key,'bradleyjoyce')
+#### Is user
+    # Check whether the given user is a MrTweet user.
+    mt.is_user
+    
+    => true
+
+#### Profile
+    # Returns MrTweet statistics of the given user
+    mt.profile
+
+    => <Mash conversation=0.225 conversation_percentile=53 frequency=8.98621 frequency_percentile=90 links=0.53 links_percentile=87 recommendations=1>
+
+    mt.profile.links
+
+    => 0.53
+
+#### Recommendations
+    # Returns the latest recommendations the given user received on MrTweet
+    mt.recommendations
+   
+    => [<Mash date=Thu Aug 06 01:02:54 -0500 2009 name="billtrammel" text="he is an entrepreneur, and one of the developers of TweetCongress.org, award-winning site promoting government transparency. Plus, he's a good friend.">]
+
+    mt.recommendations.first.name
+
+    => "billtrammel"
+
+#### Most attention towards
+    # Returns the twitter_id's of 3 users that for the given user pays the most attention to
+    mt.most_attenion_towards
+
+    => [15049040, 17993906, 22286046]
+
+#### Recommend
+    # Creates a recommendation from the given user, to another user (aka "friend_name")
+    reason = "Wynn is an awesome entrepreneur, rubyist, designer and friend! Follow him for his useful and entertaining tweets!"
+
+    friend_name = "pengwynn"
+    
+    mt.recommend(reason,friend_name)
+
+    => true
+
+### Twinfluence
+
+#### Initialize Twinfluence
+    username = 'bradleyjoyce'
+    password = 'mypassword'
+    t = Twitterland::Twinfluence.new(username,password)
+
+    => #<Twitterland::Twinfluence:0x317ecf8 @username="bradleyjoyce", @password="mypassword">
+
+#### User
+    # gets twinfluence data for user
+    t.user('bradleyjoyce')
+
+    t.user('bradleyjoyce')
+    
+    => <Mash user=<Mash adrider=<Mash script=[<Mash type="text/javascript">, <Mash src="http://pagead2.googlesyndication.com/pagead/show_ads.js" type="text/javascript">]> centralization="24.224443556856" centralization_grade="0.0 Average - Resilient" description="Entrepreneur and Web Developer -- Floxee.com, TweetCongress.org, Sherflock.com, Squeejee.com" followers_count="1315" friends_count="1278" id="14688076" location=nil name="Bradley Joyce" screen_name="bradleyjoyce" second_order="7936664" second_order_grade="Rank: <b>#10,185</b> (93%)" social_capital="6035.4859315589" social_capital_grade="+1.4 High" statuses_count="3511" unix_timestamp="1249683954" url="http://bradleyjoyce.me" velocity="15535.453112211" velocity_grade="+0.1 Fast Average">>
+
+### Twitter Counter
+
+#### Show
+    tc = Twitterland::TwitterCounter.show('bradleyjoyce')
+
+    tc.rank
+    
+    => 37194
+    
+    # available methods
+    tomorrow_2w 
+    followers_2w_ago 
+    followers_yesterday 
+    followers_current 
+    friends_current 
+    next_month 
+    growth_since_2w  
+    started_followers 
+    rank 
+    user_id 
+    growth_since 
+    follow_days 
+    tomorrow 
+    next_month_2w 
+    average_growth 
+    average_growth_2w
+
+
+### TweetBlocker
+
+#### User
+    # get grade for user
+    result = Twitterland::TweetBlocker.user('bradleyjoyce')
+
+    => <Mash grade="a" score=100 url="http://twitter.com/bradleyjoyce" username="Bradley Joyce">
+
+#### Spam
+    # report a user as spammer
+    Twitterland::TweetBlocker.report_spam('spamtest')
+
+#### Rate Limit Status
+    # check your rate limit status
+    Twitterland::TweetBlocker.rate_limit
+
+    => <Mash hourly_limit=100 remaining_hits=100 reset_time="2009-08-11 23:12:41 UTC" reset_time_in_seconds=2746>
+
+### Source
+[http://github.com/squeejee/twitterland/](http://github.com/squeejee/twitterland/)
+
+### Documentation
+[http://rdoc.info/projects/squeejee/twitterland](http://rdoc.info/projects/squeejee/twitterland)
+
+### Copyright
+Copyright (c) 2009 Squeejee. See LICENSE for details.
+
+
+

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
-:patch: 2
+:patch: 1
 :major: 0
-:minor: 0
+:minor: 1

data/lib/twitterland/mrtweet.rb

@@ -4,7 +4,7 @@ module Twitterland
     base_uri 'api.mrtweet.com/v1'
     format :json
     
-    attr_reader :is_user
+    attr_reader :is_user, :profile, :recommendations, :most_attention_towards
     
     def initialize(api_key, username)
       @username = username
@@ -22,19 +22,19 @@ module Twitterland
     
     def profile
       if is_user?
-        Mash.new(self.class.get("/profile/#{@username}/#{@api_key}.json")).profile
+        @profile ||= Mash.new(self.class.get("/profile/#{@username}/#{@api_key}.json")).profile
       end
     end
     
     def recommendations
       if is_user?
-        Mash.new(self.class.get("/recommendations/#{@username}/#{@api_key}.json")).recommendations
+        @recommendations ||= Mash.new(self.class.get("/recommendations/#{@username}/#{@api_key}.json")).recommendations
       end
     end
     
     def most_attention_towards
       if is_user?
-        Mash.new(self.class.get("/most_attention_towards/#{@username}/#{@api_key}.json")).most_attention_towards
+        @most_attention_towards ||= Mash.new(self.class.get("/most_attention_towards/#{@username}/#{@api_key}.json")).most_attention_towards
       end
     end
     

data/lib/twitterland/tweet_blocker.rb

@@ -0,0 +1,20 @@
+module Twitterland
+  class TweetBlocker
+    include HTTParty
+    base_uri 'http://tweetblocker.com/api'
+    format :json
+
+    def self.user(username)
+      @result ||= Mash.new(self.get("/username/#{username}.json")).user
+    end
+    
+    def self.report_spam(username)
+      status = Mash.new(self.get("/spam/#{username}.json"))
+      status['error'].blank? ? status : status['error']
+    end
+    
+    def self.rate_limit
+      @rate_limit = Mash.new(self.get("/user/rate_limit_status.json"))
+    end
+  end
+end

data/lib/twitterland.rb

@@ -1,9 +1,6 @@
 require 'forwardable'
 require 'rubygems'
 
-gem 'oauth', '~> 0.3.4'
-require 'oauth'
-
 gem 'mash', '0.0.3'
 require 'mash'
 
@@ -37,4 +34,5 @@ require File.join(directory, 'twitterland', 'follow_cost')
 require File.join(directory, 'twitterland', 'twitter_counter')
 require File.join(directory, 'twitterland', 'twinfluence')
 require File.join(directory, 'twitterland', 'mrtweet')
-require File.join(directory, 'twitterland', 'twitter_grader')
+require File.join(directory, 'twitterland', 'twitter_grader')
+require File.join(directory, 'twitterland', 'tweet_blocker')

data/test/fixtures/tweet_blocker_grade.json

@@ -0,0 +1 @@
+{"user":{"score":100,"grade":"a","url":"http:\/\/twitter.com\/bradleyjoyce","username":"Bradley Joyce"}}

data/test/fixtures/tweet_blocker_rate_limit_status.json

@@ -0,0 +1 @@
+{"reset_time_in_seconds":2885,"reset_time":"2009-08-11 22:16:39 UTC","remaining_hits":98,"hourly_limit":100}

data/test/fixtures/tweet_blocker_spam.json

@@ -0,0 +1 @@
+{"status":"user reported as spam"}

data/test/twitterland/tweet_blocker_test.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class TweetBlockerTest < Test::Unit::TestCase
+  include Twitterland
+  
+  context "Getting TweetBlocker info" do
+    should "get grade results" do
+      stub_get 'http://tweetblocker.com:80/api/username/bradleyjoyce.json', 'tweet_blocker_grade.json'
+      Twitterland::TweetBlocker.user("bradleyjoyce").score.should == 100
+      Twitterland::TweetBlocker.user("bradleyjoyce").grade.should == 'a'
+      Twitterland::TweetBlocker.user("bradleyjoyce").username.should =="Bradley Joyce"
+    end
+    
+    should "report user as spammer" do
+      stub_get 'http://tweetblocker.com:80/api/spam/test.json', 'tweet_blocker_spam.json'
+      Twitterland::TweetBlocker.report_spam("test").status.should == "user reported as spam"
+    end
+    
+    should "get rate limit status" do
+      stub_get 'http://tweetblocker.com:80/api/user/rate_limit_status.json', 'tweet_blocker_rate_limit_status.json'
+      Twitterland::TweetBlocker.rate_limit.reset_time_in_seconds.should == 2885
+      Twitterland::TweetBlocker.rate_limit.remaining_hits.should == 98
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: squeejee-twitterland
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
+  version: 0.1.1
 platform: ruby
 authors: 
 - Wynn Netherland
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-08-07 00:00:00 -07:00
+date: 2009-08-11 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -90,16 +90,17 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-- README.rdoc
+- README.markdown
 files: 
 - History
 - License
-- README.rdoc
+- README.markdown
 - Rakefile
 - VERSION.yml
 - lib/twitterland.rb
 - lib/twitterland/follow_cost.rb
 - lib/twitterland/mrtweet.rb
+- lib/twitterland/tweet_blocker.rb
 - lib/twitterland/twinfluence.rb
 - lib/twitterland/twitter_counter.rb
 - lib/twitterland/twitter_grader.rb
@@ -109,11 +110,15 @@ files:
 - test/fixtures/mrtweet_profile.json
 - test/fixtures/mrtweet_recommendations.json
 - test/fixtures/mrtweet_success.json
+- test/fixtures/tweet_blocker_grade.json
+- test/fixtures/tweet_blocker_rate_limit_status.json
+- test/fixtures/tweet_blocker_spam.json
 - test/fixtures/twitter_counter.json
 - test/fixtures/twitter_grader.json
 - test/test_helper.rb
 - test/twitterland/follow_cost_test.rb
 - test/twitterland/mrtweet_test.rb
+- test/twitterland/tweet_blocker_test.rb
 - test/twitterland/twitter_counter_test.rb
 - test/twitterland/twitter_grader_test.rb
 has_rdoc: false
@@ -147,5 +152,6 @@ test_files:
 - test/test_helper.rb
 - test/twitterland/follow_cost_test.rb
 - test/twitterland/mrtweet_test.rb
+- test/twitterland/tweet_blocker_test.rb
 - test/twitterland/twitter_counter_test.rb
 - test/twitterland/twitter_grader_test.rb

data/README.rdoc

@@ -1,17 +0,0 @@
-= twitterland
-
-Twitterland is a Ruby gem that bundles various Twitter-related APIs
-
-== examples
-  
-See the examples directory.
-
-http://github.com/squeejee/twitterland/tree/master/examples
-
-== docs
-
-http://rdoc.info/projects/squeejee/twitterland
-
-== Copyright
-
-Copyright (c) 2009 Squeejee. See LICENSE for details.