twitter_oauth 0.2.2 → 0.3.0

data/lib/twitter_oauth.rb

@@ -1,4 +1,3 @@
-require 'rubygems'
 require 'oauth'
 require 'json'
 require 'mime/types'
@@ -6,4 +5,4 @@ require 'mime/types'
 require 'twitter_oauth/client'
 
 module TwitterOAuth
-end
+end

data/lib/twitter_oauth/account.rb

@@ -10,36 +10,33 @@ module TwitterOAuth
     
     # Returns client info
     def info
-      oauth_response = access_token.get('/account/verify_credentials.json')
-      JSON.parse(oauth_response.body)
+      get('/account/verify_credentials.json')
     end
     
     # Returns the remaining number of API requests available to the requesting user before the API limit is reached for the current hour.
     def rate_limit_status
-      oauth_response = access_token.get('/account/rate_limit_status.json')
-      JSON.parse(oauth_response.body)
+      get('/account/rate_limit_status.json')
     end
     
     # Updates profile background image. Takes a File object and optional tile argument.
     # Returns extended user info object.
     def update_profile_background_image(image, tile = false)
       body, headers = http_multipart_data({:image => image, :tile => tile})
-      oauth_response = access_token.post('/account/update_profile_background_image.json', body, headers)
+      post('/account/update_profile_background_image.json', body, headers)
     end
     
     # Updates profile avatar image. Takes a File object which should be an image.
     # Returns extended user info object.
     def update_profile_image(image)
       body, headers = http_multipart_data({:image => image})
-      oauth_response = access_token.post('/account/update_profile_image.json', body, headers)
+      post('/account/update_profile_image.json', body, headers)
     end
     
     # colors hash must contain at least one or more of the following keys :profile_background_color, :profile_text_color, :profile_link_color, :profile_sidebar_fill_color, :profile_sidebar_border_color 
     # returns extended user info object.
     def update_profile_colors(colors)
-      oauth_response = access_token.post('/account/update_profile_colors.json', colors)
-      JSON.parse(oauth_response.body)
+      post('/account/update_profile_colors.json', colors)
     end
     
   end
-end
+end

data/lib/twitter_oauth/blocks.rb

@@ -3,15 +3,13 @@ module TwitterOAuth
     
     # unblock this user.
     def block(id)
-      oauth_response = access_token.post("/blocks/create/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/blocks/create/#{id}.json")
     end
     
     # block this user.
     def unblock(id)
-      oauth_response = access_token.post("/blocks/destroy/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/blocks/destroy/#{id}.json")
     end
     
   end
-end
+end

data/lib/twitter_oauth/client.rb

@@ -10,6 +10,7 @@ require 'twitter_oauth/user'
 require 'twitter_oauth/favorites'
 require 'twitter_oauth/utils'
 require 'twitter_oauth/trends'
+require 'twitter_oauth/lists'
 
 module TwitterOAuth
   class Client
@@ -30,11 +31,25 @@ module TwitterOAuth
       @secret = @access_token.secret
       @access_token
     end
+
+    def get(url)
+      oauth_response = access_token.get(url)
+      JSON.parse(oauth_response.body)
+    end
+
+    def post(url, body = '', headers = {})
+      oauth_response = access_token.post(url, body, headers)
+      JSON.parse(oauth_response.body)
+    end
   
-    def show(username)
-      oauth_response = access_token.get("/users/show/#{username}.json")
+    def delete(url)
+      oauth_response = access_token.delete(url)
       JSON.parse(oauth_response.body)
     end
+  
+    def show(username)
+      get("/users/show/#{username}.json")
+    end
     
     def request_token(options={})
       consumer.get_request_token(options)

data/lib/twitter_oauth/direct_messages.rb

@@ -3,27 +3,23 @@ module TwitterOAuth
     
     # Returns a list of the 20 most recent direct messages sent to the authenticating user.
     def messages(page=1)
-      oauth_response = access_token.get("/direct_messages.json?page=#{page}")
-      JSON.parse(oauth_response.body)
+      get("/direct_messages.json?page=#{page}")
     end
     
     # Returns a list of the 20 most recent direct messages sent by the authenticating user.
     def sent_messages
-      oauth_response = access_token.get('/direct_messages/sent.json')
-      JSON.parse(oauth_response.body)
+      get('/direct_messages/sent.json')
     end
     
     # Sends a new direct message to the specified user from the authenticating user.
     def message(user, text)
-      oauth_response = access_token.post('/direct_messages/new.json', :user => user, :text => text)
-      JSON.parse(oauth_response.body)
+      post('/direct_messages/new.json', :user => user, :text => text)
     end
     
     # Destroys the direct message specified in the required ID parameter.
     def message_destroy(id)
-      oauth_response = access_token.post("/direct_messages/destroy/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/direct_messages/destroy/#{id}.json")
     end
     
   end
-end
+end

data/lib/twitter_oauth/favorites.rb

@@ -2,19 +2,16 @@ module TwitterOAuth
   class Client
     
     def favorites(page=1)
-      oauth_response = access_token.get("/favorites.json?page=#{page}")
-      JSON.parse(oauth_response.body)
+      get("/favorites.json?page=#{page}")
     end
     
     def favorite
-      oauth_response = access_token.post("/favorites/create/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/favorites/create/#{id}.json")
     end
     
     def unfavorite
-      oauth_response = access_token.post("/favorites/destroy/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/favorites/destroy/#{id}.json")
     end
     
   end
-end
+end

data/lib/twitter_oauth/friendships.rb

@@ -3,26 +3,22 @@ module TwitterOAuth
     
     def friends_ids(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/friends/ids.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/friends/ids.json?#{args}")
     end
     
     def followers_ids(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/followers/ids.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/followers/ids.json?#{args}")
     end
     
     # friend this user.
     def friend(id)
-      oauth_response = access_token.post("/friendships/create/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/friendships/create/#{id}.json")
     end
     
     # unfriend.
     def unfriend(id)
-      oauth_response = access_token.post("/friendships/destroy/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/friendships/destroy/#{id}.json")
     end
     
     # exists?.

data/lib/twitter_oauth/lists.rb

@@ -0,0 +1,100 @@
+module TwitterOAuth
+  class Client
+    
+    #
+    # List methods
+    #
+    
+    # Creates a new list for the authenticated user. Accounts are limited to 20 lists. 
+    def create_list(user, list, options={})
+      post("/#{user}/lists.json", options.merge(:name => list))
+    end
+    
+    # Updates the specified list. 
+    def update_list(user, list, options={})
+      post("/#{user}/lists/#{list}.json", options)
+    end
+    
+    # List the lists of the specified user. 
+    # Private lists will be included if the authenticated user is the same as the user whose lists are being returned.
+    def get_lists(user)
+      get("/#{user}/lists.json")
+    end
+    
+    # Show the specified list. Private lists will only be shown if the authenticated user owns the specified list.
+    def get_list(user, list)
+      get("/#{user}/lists/#{list}.json")
+    end
+    
+    # Deletes the specified list. Must be owned by the authenticated user. 
+    def delete_list(user, list)
+      delete("/#{user}/lists/#{list}.json")
+    end
+    
+    # Show tweet timeline for members of the specified list.
+    def list_statuses(user, list)
+      get("/#{user}/lists/#{list}/statuses.json")
+    end
+    
+    # List the lists the specified user has been added to.
+    def list_memberships(user)
+      get("/#{user}/lists/memberships.json")
+    end
+    
+    # List the lists the specified user follows.
+    def list_subscriptions(user)
+      get("/#{user}/lists/subscriptions.json")
+    end
+    
+    #
+    # List Members Methods
+    #
+    
+    # Returns the members of the specified list.
+    def list_members(user, list)
+      get("/#{user}/#{list}/members.json")
+    end
+    
+    # Add a member to a list. The authenticated user must own the list to be able to add members to it. 
+    # Lists are limited to having 500 members.
+    def add_member_to_list(user, list, member_id, options={})
+      post("/#{user}/#{list}/members.json", options.merge(:id => member_id))
+    end
+    
+    # Removes the specified member from the list. 
+    # The authenticated user must be the list's owner to remove members from the list.
+    def remove_member_from_list(user, list, member_id)
+      delete("/#{user}/#{list}/members.json?id=#{member_id}")
+    end
+    
+    # Check if a user is a member of the specified list.
+    def get_member_of_list(user, list, member_id)
+      get("/#{user}/#{list}/members/#{member_id}.json")
+    end
+    
+    #
+    # List Subscribers Methods
+    #
+    
+    # Returns the subscribers of the specified list.
+    def list_subscribers(user, list)
+      get("/#{user}/#{list}/subscribers.json")
+    end
+    
+    # Make the authenticated user follow the specified list.
+    def subscribe_to_list(user, list, options={})
+      post("/#{user}/#{list}/subscribers.json")
+    end
+    
+    # Unsubscribes the authenticated user form the specified list.
+    def unsubscribe_from_list(user, list)
+      delete("/#{user}/#{list}/subscribers.json")
+    end
+    
+    # Check if the specified user is a subscriber of the specified list.
+    def get_subscriber_of_list(user, list, subscriber_id)
+      get("/#{user}/#{list}/subscribers/#{subscriber_id}.json")
+    end
+    
+  end
+end

data/lib/twitter_oauth/notifications.rb

@@ -3,15 +3,13 @@ module TwitterOAuth
     
     # follow this user.
     def follow(id)
-      oauth_response = access_token.post("/notifications/follow/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/notifications/follow/#{id}.json")
     end
     
     # unfollow.
     def leave(id)
-      oauth_response = access_token.post("/notifications/leave/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/notifications/leave/#{id}.json")
     end
     
   end
-end
+end

data/lib/twitter_oauth/status.rb

@@ -3,27 +3,23 @@ module TwitterOAuth
     
     # Returns a single status, specified by the id parameter below.
     def status(id)
-      oauth_response = access_token.get("/statuses/show/#{id}.json")
-      JSON.parse(oauth_response.body)
+      get("/statuses/show/#{id}.json")
     end
     
     # Updates the authenticating user's status.
     def update(message, options={})
-      oauth_response = access_token.post('/statuses/update.json', options.merge(:status => message))
-      JSON.parse(oauth_response.body)
+      post('/statuses/update.json', options.merge(:status => message))
     end
 
     # Destroys the status specified by the required ID parameter
     def status_destroy(id)
-      oauth_response = access_token.post("/statuses/destroy/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/statuses/destroy/#{id}.json")
     end
     
     # Retweets the tweet specified by the id parameter. Returns the original tweet with retweet details embedded.
     def retweet(id)
-      oauth_response = access_token.post("/statuses/retweet/#{id}.json")
-      JSON.parse(oauth_response.body)
+      post("/statuses/retweet/#{id}.json")
     end
     
   end
-end
+end

data/lib/twitter_oauth/timeline.rb

@@ -4,61 +4,53 @@ module TwitterOAuth
     # Returns the 20 most recent statuses from non-protected users who have set a custom user icon.
     def public_timeline(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/statuses/public_timeline.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/public_timeline.json?#{args}")
     end
     
     # Returns the 20 most recent statuses, including retweets, posted by the authenticating user and that user's friends. 
     # This is the equivalent of /timeline/home on the Web.
     def home_timeline(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/statuses/home_timeline.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/home_timeline.json?#{args}")
     end
     
     # Returns the 20 most recent statuses posted by the authenticating user and that user's friends.
     def friends_timeline(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/statuses/friends_timeline.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/friends_timeline.json?#{args}")
     end
     
     # Returns the 20 most recent statuses posted from the authenticating user.
     def user_timeline(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/statuses/user_timeline.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/user_timeline.json?#{args}")
     end
     alias :user :user_timeline
     
     # Returns the 20 most recent @replies (status updates prefixed with @username) for the authenticating user.
     def mentions(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/statuses/mentions.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/mentions.json?#{args}")
     end
     alias :replies :mentions
     
     # Returns the 20 most recent retweets posted by the authenticating user
     def retweeted_by_me(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/statuses/retweeted_by_me.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/retweeted_by_me.json?#{args}")
     end
     
     # Returns the 20 most recent retweets posted by the authenticating user's friends.
     def retweeted_to_me(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/statuses/retweeted_to_me.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/retweeted_to_me.json?#{args}")
     end
     
     # Returns the 20 most recent tweets of the authenticated user that have been retweeted by others.
     def retweets_of_me(options={})
       args = options.map{|k,v| "#{k}=#{v}"}.join('&')
-      oauth_response = access_token.get("/statuses/retweets_of_me.json?#{args}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/retweets_of_me.json?#{args}")
     end
     
   end
-end
+end

data/lib/twitter_oauth/trends.rb

@@ -3,8 +3,7 @@ module TwitterOAuth
     
     # Returns the top ten topics that are currently trending on Twitter.
     def trends
-      oauth_response = access_token.get("/trends.json")
-      JSON.parse(oauth_response.body)
+      get("/trends.json")
     end
     
   end

data/lib/twitter_oauth/user.rb

@@ -3,15 +3,13 @@ module TwitterOAuth
      
     # Returns the 100 last friends
     def friends(page=1)
-      oauth_response = access_token.get("/statuses/friends.json?page=#{page}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/friends.json?page=#{page}")
     end 
     
     # Returns the 100 last followers
     def followers(page=1)
-      oauth_response = access_token.get("/statuses/followers.json?page=#{page}")
-      JSON.parse(oauth_response.body)
+      get("/statuses/followers.json?page=#{page}")
     end
     
   end
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: twitter_oauth
 version: !ruby/object:Gem::Version 
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors: 
 - Richard Taylor
@@ -59,6 +59,7 @@ files:
 - lib/twitter_oauth/direct_messages.rb
 - lib/twitter_oauth/favorites.rb
 - lib/twitter_oauth/friendships.rb
+- lib/twitter_oauth/lists.rb
 - lib/twitter_oauth/notifications.rb
 - lib/twitter_oauth/search.rb
 - lib/twitter_oauth/status.rb