twitter4r 0.3.0 → 0.3.1

data/CHANGES

@@ -0,0 +1,129 @@
+= CHANGES
+
+Catalog(ue) of changes for Twitter4R 0.1.x releases including Retrospectiva ticket cross-reference numbers.  Refer to http://retro.tautology.net/projects/twitter4r/tickets for more information.
+
+== 0.3.1 Changes
+* 
+* Added specs for Twitter::Client#profile (:info, :colors and :device cases)
+* Added Twitter4R shell
+* Improved code coverage for twitter/ext/stdlib code and removed hard coded extension in GET request path for retrieving account information
+* Changed Twitter::RESTError super class to be RuntimeError instead of Exception
+* Added URI.encode => CGI.escape fix
+* Added block methods
+* Added Twitter::Client#inspect method to XXXX out passwords
+* Minor refactoring of spec/spec_helper.rb 
+* Added support for :page, :lite and :since options for Twitter::User#followers, Twitter::Client#my([:friends|:followers]...) and Twitter::Client#user([:friends|:followers]...)calls
+* Added Twitter::Client.status(:replies) support
+
+
+== 0.3.0 Changes
+* Bunch of changes, but forgot to track them and too lazy to look through the SVN/Git logs.  Sorry.
+
+== 0.2.5 Changes
+
+=== 2007-09-23
+* Added paging support as per Sergio Santos' request (#36).
+
+== 0.2.4 Changes
+
+=== 2007-07-24
+* Fixed ActiveSupport +Time#to_s+ conflict such that integration with Rails is much less painful (#34)
+
+== 0.2.3 Changes
+
+=== 2007-07-22
+* Fixed defect #31 such that passing string screen name as for user argument is handled correctly.
+* Fixed #30 typo: respond_to -> respond_to?
+* Added relevant exception handling for #message(:post, ...) case (#32)
+* Add ability to pass in Twitter::User object to Twitter::Client#user(...) #33
+* Added stats Rake task
+* Updated RDoc for Twitter::Client#user to warn against using it to get followers of authenticated user and updated ArgumentError raising logic as per #29.
+
+== 0.2.2 Changes
+
+=== 2007-07-18
+* Fixed URI paths for user, messaging and friendship APIs (#25)
+* Added action checks for Twitter::Client methods: #user, #my, #message, #messages, #status, #timeline, #friend (#26)
+* Added 'source' configuration documentation. 
+* Added missing attributes for Twitter::User (#28)
+
+== 0.2.1 Changes
+
+=== 2007-07-17
+* Added 'source' feature and configurability.
+
+== 0.2.0 Changes
+
+=== 2007-07-08
+* Added featured users API as an "extra" (#19).
+* Productionized website for publishing.
+* Published Ruby Gem on Rubyforge.
+
+=== 2007-07-07
+* Refactored Twitter4R API to be more consistent, by grouping APIs (#6):
+  - Messaging APIs: direct_messages, new, destroy, replies
+  - Friendship APIs: create, destroy
+* Added following features (#7):
+  - Retrieving direct messages
+  - User APIs: friends, followers, show
+* Updated documentation and example code.
+
+=== 2007-07-06
+* Refactored Twitter4R API to be more consistent, by grouping APIs (#6):
+  - Status APIs: show, update, destroy
+  - User APIs: friends, followers, show
+* Added X-Twitter-Client HTTP headers and Twitter::Config options (#16)
+* Removed redundant feature (#8):
+  - Followers timeline
+* Refactored HTTP request/response code to DRY up code.
+* Fix REST error handling to use #is_a?(HTTPSuccess) instead of code in ['200', '201'] to determine REST error (#15).
+
+=== 2007-06-25
+* Updated example documentation (#14)
+* Refactored marshaling unmarshaling code (#13)
+
+=== 2007-06-20
+* Added proxy user/pass support.  Tested only via endo-testing.  (No system/integration testing behind real proxy as I do not have that environment).
+
+
+=== 2007-06-17
+* Refactored Twitter4R API to be more consistent, by grouping APIs (#6):
+  - Timeline APIs: public, friends, user
+
+=== 2007-06-13
+* Added RSpec Autotest integration
+* Fixed Twitter::Meta generation of spec for hash values
+* Added HTTP header to each request including generated User-Agent header
+* Added RCovMorpher and template to restyle RCov output upon release
+* Added Gemspec dependencies and requirements
+* Added default tidy YAML configuration file for RCovMorpher
+* Added Contributors list and updated external dependencies list to README
+* Removed shebang from examples
+
+=== 2007-06-12
+* Added proxy support as per Kaiichi Matsunaga submitted patch (#11).
+* Added SSL support (#12)
+
+=== 2007-05-19
+* Translated RSpec specifications from 0.8.2 compliant to 1.0.0 (#10)
+
+== 0.1.1 Changes
+
+=== 2007-06-25
+* Added SSL support (#12)
+* Added Proxy support (#11)
+
+== 0.1.0 Changes
+
+=== 2007-05-08
+* Added Google Analytics Javascript code to website pages (#5)
+
+=== 2007-05-07
+* Fixed errors in online sample code documentation and redeployed website (#2 and #3)
+* Created more consistent RDoc theme to go more with website home page (#4)
+
+=== 2007-05-06
+* Initial revision of codebase commited; includes:
+  - Achieved 80% Twitter API feature-completeness
+  - Attained 100% RSpec C0 code coverage
+  - Rake tasks for: RSpec, RCov, RDoc, Gem, Rubyforge Publishing, etc.

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2006-2007 Susan Potter <me _at_ susanpotter _dot_ net>.
+
+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

@@ -0,0 +1,37 @@
+= Twitter4R
+
+* Project Website - http://twitter4r.rubyforge.org
+* Mailing List - http://groups.google.com/group/twitter4r-users
+
+== Developers
+* {Susan Potter}[http://SusanPotter.NET] <me at susanpotter dot net>
+
+== Contributors
+Code:
+* Kaiichi Matsunaga <ma2 at lifemedia dot co dot jp> - proxy code suggestion
+* Sergio Santos <> - message paging code suggestion
+* Adam Stiles <adam at stilesoft dot com> - URI.encode => CGI.escape fix
+* Carl Crawley <cwcrawley at gmail dot com> - Friendship get => post fix
+* Christian Johansen <christian at cjohansen dot no> - in_reply_to attributes in Twitter::Status
+
+Design Suggestions:
+* Bosco So <rubymeetup at boscoso dot com> - making Twitter::Error a RuntimeError instead of an Exception to prevent irb from crashing out.
+
+== Description
+Twitter4R provides an object based API to query or update your Twitter account via pure Ruby.  It hides the ugly HTTP/REST code from your code.
+
+== External Dependencies
+* Ruby 1.8 (tested with 1.8.6)
+* RSpec gem 1.0.0+ (tested with 1.1.3)
+* JSON gem 0.4.3+ (tested with versions: 1.1.1 and 1.1.2)
+* jcode (for unicode support)
+
+== Usage Examples
+Twitter4R starting with version 0.1.1 and above is organized into seven parts:
+* {Configuration API}[link:files/examples/configure_rb.html]
+* {Friendship API}[link:files/examples/friendship_rb.html]
+* {Messaging API}[link:files/examples/messaging_rb.html]
+* {Model API}[link:files/examples/model_rb.html]
+* {Status API}[link:files/examples/status_rb.html]
+* {Timeline API}[link:files/examples/timeline_rb.html]
+* {User API}[link:files/examples/user_rb.html]

data/TODO

@@ -0,0 +1,7 @@
+
+0.3.1 TODO:
+* Add specs for :page, :lite and :since options support in Twitter::Client#my(...), Twitter::Client#user(....) and Twitter::User#followers calls
+* Add specs for :replies support in Twitter::Client#status(...) and Twitter::Client#timeline_for(...)
+* Add RDoc for :replies support
+* Add better RDoc for Twitter::Client.account_info(:rate_limit_status)
+* Add specs for Twitter::Client.account_info(:rate_limit_status)

data/lib/twitter/client/account.rb

@@ -0,0 +1,24 @@
+class Twitter::Client
+  @@ACCOUNT_URIS = {
+    :rate_limit_status => '/account/rate_limit_status',
+  }
+  
+  # Provides access to the Twitter rate limit status API.
+  # 
+  # You can find out information about your account status.  Currently the only 
+  # supported type of account status is the <tt>:rate_limit_status</tt> which 
+  # returns a <tt>Twitter::RateLimitStatus</tt> object.
+  # 
+  # Example:
+  #  account_status = client.account_info
+  #  puts account_status.remaining_hits
+  def account_info(type = :rate_limit_status)
+    connection = create_http_connection
+    connection.start do |connection|
+      response = http_connect do |conn|
+        create_http_get_request(@@ACCOUNT_URIS[type])
+      end
+      bless_models(Twitter::RateLimitStatus.unmarshal(response.body))
+    end
+  end
+end

data/lib/twitter/client/base.rb

@@ -1,11 +1,16 @@
 class Twitter::Client
+  alias :old_inspect :inspect
+  def inspect
+    s = old_inspect
+    s.gsub!(/@password=".*?"/, '@password="XXXX"')
+  end
   protected
     attr_accessor :login, :password
     
     # Returns the response of the HTTP connection.  
-    def http_connect(body = nil, require_auth = true, &block)
+    def http_connect(body = nil, require_auth = true, service = :rest, &block)
     	require_block(block_given?)
-    	connection = create_http_connection
+    	connection = create_http_connection(service)
     	connection.start do |connection|
     		request = yield connection if block_given?
     		request.basic_auth(@login, @password) if require_auth
@@ -40,11 +45,17 @@ class Twitter::Client
       end
     end
     
-    def create_http_connection
-      conn = Net::HTTP.new(@@config.host, @@config.port, 
+    def create_http_connection(service = :rest)
+      case service
+      when :rest
+        protocol, host, port = @@config.protocol, @@config.host, @@config.port
+      when :search
+        protocol, host, port = @@config.search_protocol, @@config.search_host, @@config.search_port
+      end
+      conn = Net::HTTP.new(host, port, 
                             @@config.proxy_host, @@config.proxy_port,
                             @@config.proxy_user, @@config.proxy_pass)
-      if @@config.protocol == :ssl
+      if protocol == :ssl
         conn.use_ssl = true
         conn.verify_mode = OpenSSL::SSL::VERIFY_NONE
       end

data/lib/twitter/client/blocks.rb

@@ -0,0 +1,35 @@
+class Twitter::Client
+  @@BLOCK_URIS = {
+    :add => '/blocks/create',
+    :remove => '/blocks/destroy',
+  }
+	
+  # Provides access to the Twitter Block API.
+  # 
+  # You can add and remove blocks to users using this method.
+  # 
+  # <tt>action</tt> can be any of the following values:
+  # * <tt>:add</tt> - to add a block, you would use this <tt>action</tt> value
+  # * <tt>:remove</tt> - to remove a block use this.
+  # 
+  # The <tt>value</tt> must be either the user screen name, integer unique user ID or Twitter::User 
+  # object representation.
+  # 
+  # Examples:
+  #  screen_name = 'dictionary'
+  #  client.block(:add, 'dictionary')
+  #  client.block(:remove, 'dictionary')
+  #  id = 1260061
+  #  client.block(:add, id)
+  #  client.block(:remove, id)
+  #  user = Twitter::User.find(id, client)
+  #  client.block(:add, user)
+  #  client.block(:remove, user)
+  def block(action, value)
+    raise ArgumentError, "Invalid friend action provided: #{action}" unless @@BLOCK_URIS.keys.member?(action)
+    value = value.to_i unless value.is_a?(String)
+    uri = "#{@@BLOCK_URIS[action]}/#{value}.json"
+    response = http_connect {|conn| create_http_get_request(uri) }
+    bless_model(Twitter::User.unmarshal(response.body))
+  end
+end

data/lib/twitter/client/favorites.rb

@@ -1,9 +1,9 @@
 class Twitter::Client
   # Why Twitter.com developers can't correctly document their API, I do not know!
-	@@FAVORITES_URIS = {
-		:add => '/favourings/create',
-		:remove => '/favourings/destroy',
-	}
+  @@FAVORITES_URIS = {
+    :add => '/favourings/create',
+    :remove => '/favourings/destroy',
+  }
 
   # Provides access to the Twitter list favorites API.
   # 
@@ -13,41 +13,41 @@ class Twitter::Client
   # To get a previous page you can provide options to this method.  For example,
   #  statuses = client.favorites(:page => 2)
   # The above one-liner will get the second page of favorites for the authenticated user.
-	def favorites(options = nil)
-	  def uri_suffix(opts); opts && opts[:page] ? "?page=#{opts[:page]}" : ""; end
+  def favorites(options = nil)
+    def uri_suffix(opts); opts && opts[:page] ? "?page=#{opts[:page]}" : ""; end
     uri = '/favorites.json' + uri_suffix(options)
     response = http_connect {|conn|	create_http_get_request(uri) }
     bless_models(Twitter::Status.unmarshal(response.body))
-	end
+  end
 	
-	# Provides access to the Twitter add/remove favorite API.
-	# 
-	# You can add and remove favorite status using this method.
-	# 
-	# <tt>action</tt> can be any of the following values:
-	# * <tt>:add</tt> - to add a status to your favorites, you would use this <tt>action</tt> value
-	# * <tt>:remove</tt> - to remove an status from your existing favorites list use this.
-	# 
-	# The <tt>value</tt> must be either the status object to add or remove or 
-	# the integer unique status ID.
-	# 
-	# Examples:
-	#  id = 126006103423
-	#  client.favorite(:add, id)
-	#  client.favorite(:remove, id)
-	#  status = Twitter::Status.find(id, client)
-	#  client.favorite(:add, status)
-	#  client.favorite(:remove, status)
-	def favorite(action, value)
-	  raise ArgumentError, "Invalid favorite action provided: #{action}" unless @@FAVORITES_URIS.keys.member?(action)
-		value = value.to_i.to_s unless value.is_a?(String)
-		uri = "#{@@FAVORITES_URIS[action]}/#{value}.json"
-		case action
-		when :add
-		  response = http_connect {|conn| create_http_post_request(uri) }
-		when :remove
-		  response = http_connect {|conn| create_http_delete_request(uri) }
-		end
-		bless_model(Twitter::Status.unmarshal(response.body))
-	end
+  # Provides access to the Twitter add/remove favorite API.
+  # 
+  # You can add and remove favorite status using this method.
+  # 
+  # <tt>action</tt> can be any of the following values:
+  # * <tt>:add</tt> - to add a status to your favorites, you would use this <tt>action</tt> value
+  # * <tt>:remove</tt> - to remove an status from your existing favorites list use this.
+  # 
+  # The <tt>value</tt> must be either the status object to add or remove or 
+  # the integer unique status ID.
+  # 
+  # Examples:
+  #  id = 126006103423
+  #  client.favorite(:add, id)
+  #  client.favorite(:remove, id)
+  #  status = Twitter::Status.find(id, client)
+  #  client.favorite(:add, status)
+  #  client.favorite(:remove, status)
+  def favorite(action, value)
+    raise ArgumentError, "Invalid favorite action provided: #{action}" unless @@FAVORITES_URIS.keys.member?(action)
+    value = value.to_i.to_s unless value.is_a?(String)
+    uri = "#{@@FAVORITES_URIS[action]}/#{value}.json"
+    case action
+    when :add
+      response = http_connect {|conn| create_http_post_request(uri) }
+    when :remove
+      response = http_connect {|conn| create_http_delete_request(uri) }
+    end
+    bless_model(Twitter::Status.unmarshal(response.body))
+  end
 end

data/lib/twitter/client/friendship.rb

@@ -1,35 +1,35 @@
 class Twitter::Client
-	@@FRIENDSHIP_URIS = {
-		:add => '/friendships/create',
-		:remove => '/friendships/destroy',
-	}
+  @@FRIENDSHIP_URIS = {
+    :add => '/friendships/create',
+    :remove => '/friendships/destroy',
+  }
 	
-	# Provides access to the Twitter Friendship API.
-	# 
-	# You can add and remove friends using this method.
-	# 
-	# <tt>action</tt> can be any of the following values:
-	# * <tt>:add</tt> - to add a friend, you would use this <tt>action</tt> value
-	# * <tt>:remove</tt> - to remove an existing friend from your friends list use this.
-	# 
-	# The <tt>value</tt> must be either the user to befriend or defriend's 
-	# screen name, integer unique user ID or Twitter::User object representation.
-	# 
-	# Examples:
-	#  screen_name = 'dictionary'
-	#  client.friend(:add, 'dictionary')
-	#  client.friend(:remove, 'dictionary')
-	#  id = 1260061
-	#  client.friend(:add, id)
-	#  client.friend(:remove, id)
-	#  user = Twitter::User.find(id, client)
-	#  client.friend(:add, user)
-	#  client.friend(:remove, user)
-	def friend(action, value)
-	  raise ArgumentError, "Invalid friend action provided: #{action}" unless @@FRIENDSHIP_URIS.keys.member?(action)
-		value = value.to_i unless value.is_a?(String)
-		uri = "#{@@FRIENDSHIP_URIS[action]}/#{value}.json"
-		response = http_connect {|conn| create_http_get_request(uri) }
-		bless_model(Twitter::User.unmarshal(response.body))
-	end
+  # Provides access to the Twitter Friendship API.
+  # 
+  # You can add and remove friends using this method.
+  # 
+  # <tt>action</tt> can be any of the following values:
+  # * <tt>:add</tt> - to add a friend, you would use this <tt>action</tt> value
+  # * <tt>:remove</tt> - to remove an existing friend from your friends list use this.
+  # 
+  # The <tt>value</tt> must be either the user to befriend or defriend's 
+  # screen name, integer unique user ID or Twitter::User object representation.
+  # 
+  # Examples:
+  #  screen_name = 'dictionary'
+  #  client.friend(:add, 'dictionary')
+  #  client.friend(:remove, 'dictionary')
+  #  id = 1260061
+  #  client.friend(:add, id)
+  #  client.friend(:remove, id)
+  #  user = Twitter::User.find(id, client)
+  #  client.friend(:add, user)
+  #  client.friend(:remove, user)
+  def friend(action, value)
+    raise ArgumentError, "Invalid friend action provided: #{action}" unless @@FRIENDSHIP_URIS.keys.member?(action)
+    value = value.to_i unless value.is_a?(String)
+    uri = "#{@@FRIENDSHIP_URIS[action]}/#{value}.json"
+    response = http_connect {|conn| create_http_post_request(uri) }
+    bless_model(Twitter::User.unmarshal(response.body))
+  end
 end

data/lib/twitter/client/graph.rb

@@ -0,0 +1,37 @@
+class Twitter::Client
+  @@GRAPH_URIS = {
+    :friends => '/friends/ids',
+    :followers => '/followers/ids',
+  }
+	
+  # Provides access to the Twitter Social Graphing API.
+  # 
+  # You can retrieve the full graph of a user's friends or followers in one method call.
+  # 
+  # <tt>action</tt> can be any of the following values:
+  # * <tt>:friends</tt> - retrieves ids of all friends of a given user.
+  # * <tt>:followers</tt> - retrieves ids of all followers of a given user.
+  # 
+  # The <tt>value</tt> must be either the user screen name, integer unique user ID or Twitter::User 
+  # object representation.
+  # 
+  # Examples:
+  #  screen_name = 'dictionary'
+  #  client.graph(:friends, 'dictionary')
+  #  client.graph(:followers, 'dictionary')
+  #  id = 1260061
+  #  client.graph(:friends, id)
+  #  client.graph(:followers, id)
+  #  user = Twitter::User.find(id, client)
+  #  client.graph(:friends, user)
+  #  client.graph(:followers, user)
+  def graph(action, value = nil)
+    raise ArgumentError, "Invalid friend action provided: #{action}" unless @@GRAPH_URIS.keys.member?(action)
+    id = value.to_i unless value.nil? || value.is_a?(String)
+    id ||= value
+    id ||= @login
+    uri = "#{@@GRAPH_URIS[action]}.json"
+    response = http_connect {|conn| create_http_get_request(uri, :id => id) }
+    JSON.parse(response.body)
+  end
+end

data/lib/twitter/client/messaging.rb

@@ -17,11 +17,10 @@ class Twitter::Client
   # is given.  Valid actions are:
   # * +:received+
   # * +:sent+
-  def messages(action, options = nil)
-    def uri_suffix(opts); opts && opts[:page] ? "?page=#{opts[:page]}" : ""; end
+  def messages(action, options = {})
     raise ArgumentError, "Invalid messaging action: #{action}" unless [:sent, :received].member?(action)
-    uri = @@MESSAGING_URIS[action] + uri_suffix(options)
-    response = http_connect {|conn|	create_http_get_request(uri) }
+    uri = @@MESSAGING_URIS[action]
+    response = http_connect {|conn|	create_http_get_request(uri, options) }
     bless_models(Twitter::Message.unmarshal(response.body))
   end
   

data/lib/twitter/client/profile.rb

@@ -0,0 +1,29 @@
+class Twitter::Client
+  @@PROFILE_URIS = {
+    :info => '/account/update_profile',
+    :colors => '/account/update_profile_colors',
+    :device => '/account/update_delivery_device',
+  }
+  
+  # Provides access to the Twitter Profile API.
+  # 
+  # You can update profile information.  You can update the types of profile 
+  # information:
+  # * :info (name, email, url, location, description)
+  # * :colors (background_color, text_color, link_color, sidebar_fill_color, 
+  # sidebar_border_color)
+  # * :device (set device to either "sms", "im" or "none")
+  # 
+  # Example:
+  #  user = client.profile(:info, :location => "University Library")
+  #  puts user.inspect
+  def profile(action, attributes)
+    connection = create_http_connection
+    connection.start do |connection|
+      response = http_connect(attributes.to_http_str) do |conn|
+        create_http_post_request(@@PROFILE_URIS[action])
+      end
+      bless_models(Twitter::User.unmarshal(response.body))
+    end
+  end
+end

data/lib/twitter/client/search.rb

@@ -0,0 +1,27 @@
+class Twitter::Client
+
+  @@SEARCH_URIS = {
+    :basic => "/search.json",
+  }
+
+  # Provides access to Twitter's Search API.
+  # 
+  # Example:
+  #  # For keyword search
+  #  iterator = @twitter.search(:q => "coworking")
+  #  while (tweet = iterator.next)
+  #    puts tweet.text
+  #  end
+  # 
+  # An <tt>ArgumentError</tt> will be raised if an invalid <tt>action</tt> 
+  # is given.  Valid actions are:
+  # * +:received+
+  # * +:sent+
+  def search(options = {})
+#    raise ArgumentError, "Invalid messaging action: #{action}"
+    uri = @@SEARCH_URIS[:basic]
+    response = http_connect(nil, false, :search) {|conn|	create_http_get_request(uri, options) }
+    json = JSON.parse(response.body)
+    bless_models(Twitter::Status.unmarshal(JSON.dump(json["results"])))
+  end
+end

data/lib/twitter/client/status.rb

@@ -3,6 +3,7 @@ class Twitter::Client
   	:get => '/statuses/show.json',
   	:post => '/statuses/update.json',
   	:delete => '/statuses/destroy.json',
+  	:reply => '/statuses/update.json',
   }
   
   # Provides access to individual statuses via Twitter's Status APIs
@@ -11,6 +12,7 @@ class Twitter::Client
   # * <tt>:get</tt> to retrieve status content.  Assumes <tt>value</tt> given responds to :to_i message in meaningful way to yield intended status id.
   # * <tt>:post</tt> to publish a new status
   # * <tt>:delete</tt> to remove an existing status.  Assumes <tt>value</tt> given responds to :to_i message in meaningful way to yield intended status id.
+  # * <tt>:reply</tt> to reply to an existing status.  Assumes <tt>value</tt> given is <tt>Hash</tt> which contains <tt>:in_reply_to_status_id</tt> and <tt>:status</tt>
   # 
   # <tt>value</tt> should be set to:
   # * the status identifier for <tt>:get</tt> case
@@ -27,11 +29,12 @@ class Twitter::Client
   # * +:get+
   # * +:post+
   # * +:delete+
-  def status(action, value)
+  def status(action, value = nil)
+    return self.timeline_for(action, value || {}) if :replies == action
     raise ArgumentError, "Invalid status action: #{action}" unless @@STATUS_URIS.keys.member?(action)
     return nil unless value
-  	uri = @@STATUS_URIS[action]
-  	response = nil
+    uri = @@STATUS_URIS[action]
+    response = nil
     case action
     when :get
     	response = http_connect {|conn|	create_http_get_request(uri, :id => value.to_i) }
@@ -39,6 +42,9 @@ class Twitter::Client
     	response = http_connect({:status => value, :source => @@config.source}.to_http_str) {|conn| create_http_post_request(uri) }
     when :delete
     	response = http_connect {|conn| create_http_delete_request(uri, :id => value.to_i) }
+    when :reply
+      return nil if (!value.is_a?(Hash) || !value[:status] || !value[:in_reply_to_status_id])
+      response = http_connect(value.merge(:source => @@config.source).to_http_str) {|conn| create_http_post_request(uri) }
     end
     bless_model(Twitter::Status.unmarshal(response.body))
   end

data/lib/twitter/client/timeline.rb

@@ -5,6 +5,7 @@ class Twitter::Client
     :friend => '/statuses/friends_timeline.json',
     :user => '/statuses/user_timeline.json',
     :me => '/statuses/user_timeline.json',
+    :replies => '/statuses/replies.json',
   }
 
   # Provides access to Twitter's Timeline APIs