grackle 0.2.1 → 0.3.0

data/CHANGELOG.rdoc

@@ -1,3 +1,9 @@
+== 0.3.0 (2013-03-31)
+* Make Twitter API 1.1 endpoint the default. This will be a breaking change if you expect 1.0 out of the box
+
+== 0.2.2 (2013-01-24, Unreleased)
+* Add :v1_1 api endpoint to client mapping to api.twitter.com/1.1; the default is still :v1. (Thanks @jcsalterego)
+
 == 0.2.1 (2012-08-14)
 * Add :valid_http_codes option that tells grackle not to raise an error when encountering those statuses.
 

data/README.rdoc

@@ -3,22 +3,22 @@ by Hayes Davis
 - http://twitter.com/hayesdavis
 - hayes [at] unionmetrics [dot] com
 - http://unionmetrics.com
-- http://hayesdavis.net
+- http://hayesdavis.tumblr.com
 
 == DESCRIPTION
-Grackle is a lightweight Ruby wrapper around the Twitter REST and Search APIs.
-It's based on my experience using the Twitter API to build http://cheaptweet.com
-and http://tweetreach.com. The main goal of Grackle is to never require a
-release when the Twitter API changes (which it often does) or in the face of a
-particular Twitter API bug. As such it's somewhat different from other Twitter
-API libraries. It doesn't try to hide the Twitter "methods" under an access
-layer nor does it introduce concrete classes for the various objects returned by
-Twitter. Instead, calls to the Grackle client map directly to Twitter API URLs.
-The objects returned by API calls are generated as OpenStructs on the fly and
-make no assumptions about the presence or absence of any particular attributes.
-Taking this approach means that changes to URLs used by Twitter, parameters
-required by those URLs or return values will not require a new release. It will
-potentially require, however, some modifications to your code that uses Grackle.
+Grackle is a lightweight Ruby wrapper around the Twitter REST API. It's based on
+my experience using the Twitter API to build http://tweetreach.com. The main
+goal of Grackle is to never require a release when the Twitter API changes
+(which it often does) or in the face of a particular Twitter API bug. As such
+it's somewhat different from other Twitter API libraries. It doesn't try to hide
+the Twitter "methods" under an access layer nor does it introduce concrete
+classes for the various objects returned by Twitter. Instead, calls to the
+Grackle client map directly to Twitter API URLs. The objects returned by API
+calls are generated as OpenStructs on the fly and make no assumptions about the
+presence or absence of any particular attributes. Taking this approach means
+that changes to URLs used by Twitter, parameters required by those URLs or
+return values will not require a new release. It will potentially require,
+however, some modifications to your code that uses Grackle.
 
 === Support and Announcements
 The preferred forum for questions and discussions is the Google group at
@@ -26,7 +26,14 @@ http://groups.google.com/group/gracklerb. You can email me directly or @reply me
 on Twitter, but the group is better since the questions and responses will be
 available to everyone. I'll also make announcements there. There are some
 examples on the wiki at http://wiki.github.com/hayesdavis/grackle. If you prefer
-your information in 140 characters, follow @gracklerb[http://twitter.com/gracklerb].
+your information in 140 characters, follow
+@gracklerb[http://twitter.com/gracklerb].
+
+=== Twitter API 1.1 and Grackle 0.3.0
+Grackle 0.3.0 defaults to Twitter API 1.1 out of the box. If you have code that
+still relies on API 1.0, you can upgrade Grackle and still use API 1.0 by
+specifying that the client use the :v1 API:
+  client = Grackle::Client.new(:api=>:v1)
 
 ==USING GRACKLE
 
@@ -40,12 +47,15 @@ Before you do anything else, you'll need to
     :consumer_key=>'SOMECONSUMERKEYFROMTWITTER', :consumer_secret=>'SOMECONSUMERTOKENFROMTWITTER',
     :token=>'ACCESSTOKENACQUIREDONUSERSBEHALF', :token_secret=>'SUPERSECRETACCESSTOKENSECRET'
   })
-  
-OAuth can be a bit complicated. See the wiki[http://wiki.github.com/hayesdavis/grackle/grackle-and-oauth] 
-for more information on acquiring the keys, tokens and secrets needed to 
+
+OAuth can be a bit complicated. See the wiki[http://wiki.github.com/hayesdavis/grackle/grackle-and-oauth]
+for more information on acquiring the keys, tokens and secrets needed to
 successfully authenticate with OAuth.
 
-====Using No Auth
+====Using No Auth (DEPRECATED)
+As of May 7th, 2013, Twitter will be shutting down all API 1 endpoints and
+requiring all clients to use API 1.1 which requires OAuth authentication for all
+API calls.
   client = Grackle::Client.new
 
 ====Using Basic Auth (DEPRECATED)
@@ -55,23 +65,24 @@ As of August 31st, 2010, Twitter has deprecated basic authentication in favor of
 See Grackle::Client for more information about valid arguments to the constructor. It's quite configurable. Among other things, you can turn on ssl and specify custom headers. The calls below are pretty much as simple as it gets.
 
 ===Grackle Method Syntax
-Grackle uses a method syntax that corresponds to the Twitter API URLs with a few twists. Where you would have a slash in 
-a Twitter URL, that becomes a "." in a chained set of Grackle method calls. Each call in the method chain is used to build 
-Twitter URL path until a particular call is encountered which causes the request to be sent. Methods which will cause a 
-request to be execute include:
+Grackle uses a method syntax that corresponds to the Twitter API URLs with a few
+twists. Where you would have a slash in  a Twitter URL, that becomes a "." in a
+chained set of Grackle method calls. Each call in the method chain is used to
+build  Twitter URL path until a particular call is encountered which causes the
+request to be sent. Methods which will cause a  request to be execute include:
 - A method call ending in "?" will cause an HTTP GET to be executed
 - A method call ending in "!" will cause an HTTP POST to be executed
 - If a valid format such as .json, .xml, .rss or .atom is encounted, a get will be executed with that format
 - A format method can also include a ? or ! to determine GET or POST in that format respectively
 
 ===GETting Data
-The preferred and simplest way of executing a GET is to use the "?" method notation. This will use the default client 
+The preferred and simplest way of executing a GET is to use the "?" method notation. This will use the default client
 format (usually JSON, but see Formats section below):
   client.users.show? :screen_name=>'some_user' #http://twitter.com/users/show.json?screen_name=some_user
 
 You can force XML format by doing:
   client.users.show.xml? :screen_name=>'some_user' #http://twitter.com/users/show.xml?screen_name=some_user
-  
+
 You can force JSON:
   client.users.show.json? :screen_name=>'some_user' #http://twitter.com/users/show.json?screen_name=some_user
 
@@ -92,37 +103,42 @@ You can force a format. To update the authenticated user's status using the XML
 
 Or, with JSON
   client.statuses.update.json! :status=>'this status is from grackle' #POST to http://twitter.com/statuses/update.json
-  
+
 ===Using Other HTTP Verbs
 To use HTTP verbs like DELETE or PUT, Grackle provides a slightly different syntax:
   client.put{ hayesdavis.lists.my_list :name=>'New Name' } #HTTP PUT
   client.delete{ direct_messages.destroy :id=>1 } #HTTP DELETE
-  
-You may specify any method chain you wish in the block. Note that if your method chain inside the block 
+
+You may specify any method chain you wish in the block. Note that if your method chain inside the block
 ends in a ! or ?, that the HTTP verb for the block will still be used. This means that
   client.delete{ direct_messages.destroy! :id=>1 } #Uses HTTP DELETE, not POST
   client.direct_messages.destroy! :id=>1 #Uses HTTP POST
 
-If for some reason you don't like the preferred block syntax above, you may specify a 
+If for some reason you don't like the preferred block syntax above, you may specify a
 parameter to your method chain called :__method (note the double underscores) to specify the HTTP verb:
   client.direct_messages.destroy! :id=>1, :__method=>:delete #HTTP DELETE
 
 ===Toggling APIs
-DEPRECATION NOTICE: The :rest API key (pointing to twitter.com) has been 
-deprecated in favor of the versioned API :v1 (pointing to api.twitter.com/1). 
-:v1 is now the default if you do not specify an API. Please do not use :rest 
-in your code.
+As of Grackle 0.3.0, the Grackle::Client sends all requests to the 1.1 Twitter
+API by default. If you want to send requests to the Twitter 1.0 API (which has
+been deprecated by Twitter and will be unavailable after May 7th, 2013), just
+use the Grackle::Client#api= method and set it to :v1. To toggle back, set it
+to :v1_1. All requests made after setting this attribute will go to that API.
 
-By default, the Grackle::Client sends all requests to the versioned Twitter REST API. If you want to send requests to 
-the Twitter Search API, just set Grackle::Client.api to :search. To toggle back, set it to be :v1. All requests made 
-after setting this attribute will go to that API.
+For convenience, you can also set the desired API in the Client constructor:
+  client = Grackle::Client.new(:api=>:v1)
 
-If you want to make a specific request to one API and not change the Client's overall api setting beyond that request, you can use the 
-bracket syntax like so:
-  client[:search].trends.daily? :exclude=>'hashtags'
-  client[:v1].users.show? :id=>'hayesdavis'
- 
-Search and REST requests are all built using the same method chaining and termination conventions.
+If you want to make a specific request to one API and not change the Client's
+overall api setting beyond that request, you can use the bracket syntax like so:
+  client[:v1].users.show? :screen_name=>'hayesdavis'
+  client[:v1_1].users.show? :screen_name=>'hayesdavis'
+
+All APIs use the same method chaining and termination conventions.
+
+DEPRECATION NOTICE: The :rest API key (pointing to twitter.com), the :search API
+key (pointing to search.twitter.com) and the :v1 API key
+(pointing to api.twitter.com/1) have all been deprecated in favor of the
+the :v1_1 API (pointing to api.twitter.com/1.1).
 
 ===Parameter handling
 - All parameters are URL encoded as necessary.
@@ -130,8 +146,9 @@ Search and REST requests are all built using the same method chaining and termin
 - If you use a Time object as a parameter, .httpdate will be called on it and that value will be used
 
 ===Return Values
-Regardless of the format used, Grackle returns an OpenStruct (actually a Grackle::TwitterStruct) of data. The attributes 
-available on these structs correspond to the data returned by Twitter.
+Regardless of the format used, Grackle returns an OpenStruct (actually a
+Grackle::TwitterStruct) of data. The attributes  available on these structs
+correspond to the data returned by Twitter.
 
 ===Rate Limits and the Response
 The Grackle client has a response method which is populated with information
@@ -142,7 +159,13 @@ because they can be used to retrieve the rate limit information that Twitter
 includes in a response.
 
   user = client.users.show.hayesdavis?
-  client.response.headers["X-Ratelimit-Remaining"]
+  client.response.headers["X-Rate-Limit-Remaining"] # 1.1 API
+
+  user = client[:v1].users.show.hayesdavis?
+  client.response.headers["X-Ratelimit-Remaining"]  # 1.0 API
+
+Note that Twitter has renamed the rate limit headers in API 1.1 to use
+"rate-limit" instead of API 1.0's "ratelimit".
 
 Not all headers returned by Twitter are included by default. You can control
 which headers are accessible with the response_headers attribute on the Client.
@@ -151,28 +174,33 @@ header values will be Strings so you'll need to convert rate limits, etc to ints
 in your code.
 
 ===Dealing with Errors
-If the request to Twitter does not return a status code of 200, then a TwitterError is thrown. This contains the HTTP method used, 
-the full request URI, the response status, the response body in text and a response object build by parsing the formatted error 
-returned by Twitter. It's a good idea to wrap your API calls with rescue clauses for Grackle::TwitterError.
+If the request to Twitter does not return a status code of 200, then a
+TwitterError is thrown. This contains the HTTP method used,  the full request
+URI, the response status, the response body in text and a response object build
+by parsing the formatted error  returned by Twitter. It's a good idea to wrap
+your API calls with rescue clauses for Grackle::TwitterError.
 
-If there is an unexpected connection error or Twitter returns data in the wrong format (which it can do), you'll still get a TwitterError.
+If there is an unexpected connection error or Twitter returns data in the wrong
+format (which it can do), you'll still get a TwitterError.
 
 ===Formats
-Twitter allows you to request data in particular formats. Grackle automatically 
-parses JSON and XML formatted responses and returns an OpenStruct. The 
-Grackle::Client has a default_format you can specify. By default, the 
-default_format is :json. If you don't include a named format in your method 
-chain as described above, but use a "?" or "!" then the 
+Twitter allows you to request data in particular formats. Grackle automatically
+parses JSON and XML formatted responses and returns an OpenStruct. The
+Grackle::Client has a default_format you can specify. By default, the
+default_format is :json. If you don't include a named format in your method
+chain as described above, but use a "?" or "!" then the
 Grackle::Client.default_format is used.
 
-If you specify a format that Grackle doesn't parse for you, you'll receive a 
-string containing the raw response body. If you want to receive the raw 
-response body even for XML or JSON formatted responses, tell the Grackle client 
-to use the +StringHandler+ handler. For example, the following code sets the 
+If you specify a format that Grackle doesn't parse for you, you'll receive a
+string containing the raw response body. If you want to receive the raw
+response body even for XML or JSON formatted responses, tell the Grackle client
+to use the +StringHandler+ handler. For example, the following code sets the
 Grackle client to return JSON instead of an OpenStruct:
 
   client = Grackle::Client.new(:handlers=>{:json=>Grackle::Handlers::StringHandler.new })
 
+DEPRECATION NOTICE: As to Twitter API 1.1, XML is no longer an accepted format.
+
 ===Odds and Ends
 If you need to append something to the request path that isn't a valid ruby method, e.g.
   /1user/lists.json #1user isn't a valid Ruby method
@@ -183,7 +211,7 @@ you can use the Grackle::Client#_ method like so:
 
 You'll need the following gems to use all features of Grackle:
 - json
-- oauth 
+- oauth
 - mime-types
 
 === Ruby Version Support

data/lib/grackle/client.rb

@@ -87,16 +87,23 @@ module Grackle
     # refer to it wherever Grackle::Client uses an API symbol. You may wish 
     # to do this when Twitter introduces API versions greater than 1.
     TWITTER_API_HOSTS = {
-      :search=>'search.twitter.com', :v1=>'api.twitter.com/1',
+      :v1=>'api.twitter.com/1', :v1_1=>'api.twitter.com/1.1',
+      :search=>'search.twitter.com',
       :upload=>'upload.twitter.com/1'
     }
     TWITTER_API_HOSTS[:rest] = TWITTER_API_HOSTS[:v1]
+    DEFAULT_API_HOST = :v1_1
 
     # Contains the response headers from twitter
-    DEFAULT_RESPONSE_HEADERS =[
+    DEFAULT_RESPONSE_HEADERS = [
+      # These are API 1 rate limit header names
       'x-ratelimit-limit',
       'x-ratelimit-remaining',
-      'x-ratelimit-reset'
+      'x-ratelimit-reset',
+      # These are API 1.1 rate limit header names
+      'x-rate-limit-limit',
+      'x-rate-limit-remaining',
+      'x-rate-limit-reset'
     ]
 
     #Basic OAuth information needed to communicate with Twitter
@@ -117,10 +124,10 @@ module Grackle
     # - :default_format     - Symbol of format to use when no format is specified in an API call (e.g. :json, :xml)
     # - :headers            - Hash of string keys and values for headers to pass in the HTTP request to twitter
     # - :ssl                - true or false to turn SSL on or off. Default is off (i.e. http://)
-    # - :api                - one of :rest, :search or :v1. :v1 is the default and :rest is now deprecated
+    # - :api                - one of :rest, :search, :v1 or :v1_1. :v1_1 is the default. :rest and :search are now deprecated
     # - :auth               - Hash of authentication type and credentials. Must have :type key with value one of :basic or :oauth
-    #   - :type=>:basic     - Include :username and :password keys
     #   - :type=>:oauth     - Include :consumer_key, :consumer_secret, :token and :token_secret keys
+    #   - :type=>:basic     - DEPRECATED. Include :username and :password keys
     # - :auto_append_format - true or false to include format in URI (e.g. /test.json). Default is true
     # - :response_headers   - array of headers to return from the response
     # - :valid_http_codes   - array of HTTP codes to consider valid (non-error)
@@ -128,11 +135,11 @@ module Grackle
       self.transport = Transport.new
       self.handlers = {:json=>Handlers::JSONHandler.new,:xml=>Handlers::XMLHandler.new,:unknown=>Handlers::StringHandler.new}
       self.handlers.merge!(options[:handlers]||{})
-      self.default_format = options[:default_format] || :json 
+      self.default_format = options[:default_format] || :json
       self.auto_append_format = options[:auto_append_format] == false ? false : true
       self.headers = {"User-Agent"=>"Grackle/#{Grackle::VERSION}"}.merge!(options[:headers]||{})
       self.ssl = options[:ssl] == true
-      self.api = options[:api] || :v1
+      self.api = options[:api] || DEFAULT_API_HOST
       self.api_hosts = TWITTER_API_HOSTS.clone
       self.timeout = options[:timeout] || 60
       self.auto_append_ids = options[:auto_append_ids] == false ? false : true
@@ -140,7 +147,7 @@ module Grackle
       self.response_headers = options[:response_headers] || DEFAULT_RESPONSE_HEADERS.clone
       self.valid_http_codes = options[:valid_http_codes] || VALID_HTTP_CODES.clone
       if options.has_key?(:username) || options.has_key?(:password)
-        #Use basic auth if :username and :password args are passed in
+        # DEPRECATED: Use basic auth if :username and :password args are passed in
         self.auth.merge!({:type=>:basic,:username=>options[:username],:password=>options[:password]})
       end
       #Handle auth mechanism that permits basic or oauth
@@ -151,7 +158,7 @@ module Grackle
         end
       end
     end
-               
+
     def method_missing(name,*args,&block)
       if block_given?
         return request_with_http_method_block(name,&block)

data/lib/grackle/version.rb

@@ -1,9 +1,9 @@
 module Grackle
 
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 
   def self.version
     VERSION
   end
 
-end
+end

data/test/client_test.rb

@@ -119,7 +119,7 @@ class ClientTest < Test::Unit::TestCase
     assert_equal('http',client.transport.url.scheme)
     assert(!Net::HTTP.last_instance.use_ssl?,'Net::HTTP instance should not be set to use SSL')
     assert_equal('api.twitter.com',client.transport.url.host)
-    assert_equal('/1/users/show.json',client.transport.url.path)
+    assert_equal('/1.1/users/show.json',client.transport.url.path)
     assert_equal('test_user',client.transport.options[:params][:screen_name])
     assert_equal('screen_name=test_user',Net::HTTP.request.path.split(/\?/)[1])
     assert_equal(12345,value.id)
@@ -167,30 +167,47 @@ class ClientTest < Test::Unit::TestCase
     client.statuses.public_timeline?
     assert_match(/\.xml$/,client.transport.url.path)
   end
-  
-  def test_api
-    client = new_client(200,'[{"id":1,"text":"test 1"}]',:api=>:search)
-    client.search? :q=>'test'
-    assert_equal('search.twitter.com',client.transport.url.host)
 
-    client[:rest].users.show.some_user?
-    assert_equal('api.twitter.com',client.transport.url.host)
+  def test_api_selection_with_api_accessor_changes_api_for_subsequent_requests
+    client = new_client(200,'[{"id":1,"text":"test 1"}]')
+
+    # :rest and :v1 are DEPRECATED
+    {:rest=>"1", :v1=>"1",:v1_1=>"1.1"}.each do |api_key,version|
+      client.api = api_key
+      client.users.show.some_user?
+      assert_equal('api.twitter.com',client.transport.url.host)
+      assert_equal("/#{version}/users/show/some_user.json",client.transport.url.path)
+      assert_equal(api_key,client.api,"API changed for all requests")
+    end
 
+    # :search is DEPRECATED
     client.api = :search
     client.trends?
     assert_equal('search.twitter.com',client.transport.url.host)
-    
-    client.api = :v1
-    client.search? :q=>'test'
-    assert_equal('api.twitter.com',client.transport.url.host)
-    assert_match(%r{^/1/search},client.transport.url.path)
+    assert_equal("/trends.json",client.transport.url.path)
+    assert_equal(:search,client.api,"API changed to search for all requests")
+  end
 
-    client.api = :rest
-    client[:v1].users.show.some_user?
-    assert_equal('api.twitter.com',client.transport.url.host)
-    assert_match(%r{^/1/users/show/some_user},client.transport.url.path)
+  def test_api_selection_with_api_override_changes_api_for_specific_request
+    client = new_client(200,'[{"id":1,"text":"test 1"}]')
+
+    original_api = client.api
+
+    # :rest and :v1 are DEPRECATED
+    {:rest=>"1", :v1=>"1",:v1_1=>"1.1"}.each do |api_key,version|
+      client[api_key].users.show.some_user?
+      assert_equal('api.twitter.com',client.transport.url.host)
+      assert_equal("/#{version}/users/show/some_user.json",client.transport.url.path)
+      assert_equal(original_api,client.api,"API should not change")
+    end
+
+    # :search is DEPRECATED
+    client[:search].trends?
+    assert_equal('search.twitter.com',client.transport.url.host)
+    assert_equal("/trends.json",client.transport.url.path)
+    assert_equal(original_api,client.api,"API should not change")
   end
-  
+
   def test_headers
     client = new_client(200,'[{"id":1,"text":"test 1"}]',:headers=>{'User-Agent'=>'TestAgent/1.0','X-Test-Header'=>'Header Value'})
     client.statuses.public_timeline?
@@ -259,14 +276,14 @@ class ClientTest < Test::Unit::TestCase
     client = new_client(200,'[{"id":1,"text":"test 1"}]')
     time = Time.now-60*60
     client.statuses.public_timeline? :since=>time  
-    assert_equal("/1/statuses/public_timeline.json?since=#{CGI::escape(time.httpdate)}",Net::HTTP.request.path)
+    assert_equal("/1.1/statuses/public_timeline.json?since=#{CGI::escape(time.httpdate)}",Net::HTTP.request.path)
   end
 
   def test_simple_http_method_block
     client = new_client(200,'[{"id":1,"text":"test 1"}]')
     client.delete { direct_messages.destroy :id=>1, :other=>'value' }
     assert_equal(:delete,client.transport.method, "delete block should use delete method")
-    assert_equal("/1/direct_messages/destroy/1.json",Net::HTTP.request.path)
+    assert_equal("/1.1/direct_messages/destroy/1.json",Net::HTTP.request.path)
     assert_equal('value',client.transport.options[:params][:other])
     
     client = new_client(200,'{"id":54321,"screen_name":"test_user"}')
@@ -275,7 +292,7 @@ class ClientTest < Test::Unit::TestCase
     assert_equal('http',client.transport.url.scheme)
     assert(!Net::HTTP.last_instance.use_ssl?,'Net::HTTP instance should not be set to use SSL')
     assert_equal('api.twitter.com',client.transport.url.host)
-    assert_equal('/1/users/show.json',client.transport.url.path)
+    assert_equal('/1.1/users/show.json',client.transport.url.path)
     assert_equal('test_user',client.transport.options[:params][:screen_name])
     assert_equal('screen_name=test_user',Net::HTTP.request.path.split(/\?/)[1])
     assert_equal(54321,value.id)    
@@ -308,7 +325,7 @@ class ClientTest < Test::Unit::TestCase
     assert_equal('http',client.transport.url.scheme)
     assert(!Net::HTTP.last_instance.use_ssl?,'Net::HTTP instance should not be set to use SSL')
     assert_equal('api.twitter.com',client.transport.url.host)
-    assert_equal('/1/users/show/12345.json',client.transport.url.path)
+    assert_equal('/1.1/users/show/12345.json',client.transport.url.path)
     assert_equal(12345,value.id)
   end
   
@@ -333,10 +350,10 @@ class ClientTest < Test::Unit::TestCase
   def test_auto_append_ids_is_honored
     client = new_client(200,'{"id":12345,"screen_name":"test_user"}')
     client.users.show.json? :id=>12345
-    assert_equal('/1/users/show/12345.json',client.transport.url.path,"Id should be appended by default")
+    assert_equal('/1.1/users/show/12345.json',client.transport.url.path,"Id should be appended by default")
     client.auto_append_ids = false
     client.users.show.json? :id=>12345
-    assert_equal('/1/users/show.json',client.transport.url.path,"Id should not be appended")
+    assert_equal('/1.1/users/show.json',client.transport.url.path,"Id should not be appended")
     assert_equal(12345,client.transport.options[:params][:id], "Id should be treated as a parameter")
     assert_equal("id=#{12345}",Net::HTTP.request.path.split(/\?/)[1],"id should be part of the query string")    
   end
@@ -344,7 +361,7 @@ class ClientTest < Test::Unit::TestCase
   def test_auto_append_ids_can_be_set_in_constructor
     client = new_client(200,'{"id":12345,"screen_name":"test_user"}',:auto_append_ids=>false)
     client.users.show.json? :id=>12345
-    assert_equal('/1/users/show.json',client.transport.url.path,"Id should not be appended")
+    assert_equal('/1.1/users/show.json',client.transport.url.path,"Id should not be appended")
     assert_equal(12345,client.transport.options[:params][:id], "Id should be treated as a parameter")
     assert_equal("id=#{12345}",Net::HTTP.request.path.split(/\?/)[1],"id should be part of the query string")    
   end
@@ -352,23 +369,23 @@ class ClientTest < Test::Unit::TestCase
   def test_auto_append_format_is_honored
     client = new_client(200,'{"id":12345,"screen_name":"test_user"}')
     client.users.show.hayesdavis?
-    assert_equal('/1/users/show/hayesdavis.json',client.transport.url.path,"Format should be appended by default")
+    assert_equal('/1.1/users/show/hayesdavis.json',client.transport.url.path,"Format should be appended by default")
     client.auto_append_format = false
     client.users.show.hayesdavis?
-    assert_equal('/1/users/show/hayesdavis',client.transport.url.path,"Format should not be appended to the URI")
+    assert_equal('/1.1/users/show/hayesdavis',client.transport.url.path,"Format should not be appended to the URI")
   end
 
   def test_auto_append_format_can_be_set_in_constructor
     client = new_client(200,'{"id":12345,"screen_name":"test_user"}',:auto_append_format=>false)
     client.users.show.hayesdavis?
-    assert_equal('/1/users/show/hayesdavis',client.transport.url.path,"Format should not be appended to the URI")
+    assert_equal('/1.1/users/show/hayesdavis',client.transport.url.path,"Format should not be appended to the URI")
   end
 
   def test_default_api
     client = Grackle::Client.new
-    assert_equal(:v1,client.api,":v1 should be default api")
+    assert_equal(:v1_1,client.api,":v1_1 should be default api")
   end
-  
+
   # Methods like Twitter's DELETE list membership expect that the user id will 
   # be form encoded like a POST request in the body. Net::HTTP seems to think 
   # that DELETEs can't have body parameters so we have to work around that.
@@ -378,7 +395,7 @@ class ClientTest < Test::Unit::TestCase
     assert_equal(:delete,client.transport.method,"Expected delete request")
     assert_equal('http',client.transport.url.scheme,"Expected scheme to be http")
     assert_equal('api.twitter.com',client.transport.url.host,"Expected request to be against twitter.com")
-    assert_equal('/1/some_user/some_list/members.json',client.transport.url.path)
+    assert_equal('/1.1/some_user/some_list/members.json',client.transport.url.path)
     assert_match(/user_id=12345/,Net::HTTP.request.body,"Parameters should be form encoded")
   end
 
@@ -414,7 +431,7 @@ class ClientTest < Test::Unit::TestCase
       assert_equal(:post,client.transport.method,"Expected post request")
       assert_equal('http',client.transport.url.scheme,"Expected scheme to be http")
       assert_equal('api.twitter.com',client.transport.url.host,"Expected request to be against twitter.com")
-      assert_equal('/1/statuses/update.json',client.transport.url.path)
+      assert_equal('/1.1/statuses/update.json',client.transport.url.path)
 
       if RUBY_VERSION >= "1.9.3"
         # 1.9.3 encodes a space with a + instead of %20

metadata

@@ -1,73 +1,75 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: grackle
-version: !ruby/object:Gem::Version
-  version: 0.2.1
-  prerelease: 
+version: !ruby/object:Gem::Version 
+  hash: 19
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 0
+  version: 0.3.0
 platform: ruby
-authors:
+authors: 
 - Hayes Davis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-15 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
+
+date: 2013-03-31 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: json
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: mime-types
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
   type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: mime-types
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: oauth
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
   type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: oauth
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-description: ! "    Grackle is a library for the Twitter REST and Search API designed
-  to not\n    require a new release in the face Twitter API changes or errors.\n"
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: "    Grackle is a lightweight library for the Twitter REST API designed to be\n    resilient to Twitter API changes or errors.\n"
 email: hayes@unionmetrics.com
 executables: []
+
 extensions: []
-extra_rdoc_files:
+
+extra_rdoc_files: 
 - README.rdoc
 - CHANGELOG.rdoc
-files:
+files: 
 - README.rdoc
 - CHANGELOG.rdoc
 - lib/grackle/client.rb
@@ -79,28 +81,39 @@ files:
 - test/client_test.rb
 - test/handlers_test.rb
 - test/test_helper.rb
+has_rdoc: true
 homepage: http://github.com/hayesdavis/grackle
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Grackle is a lightweight library for the Twitter REST and Search API.
+summary: Grackle is a lightweight library for the Twitter REST API.
 test_files: []
+