twitter_oauth 0.4.2 → 0.4.3

data/README.textile

@@ -80,3 +80,48 @@ client = TwitterOAuth::Client.new(
 client.authorized?
 => true
 </code></pre>
+
+h2. Working with a Proxy
+
+Services such as "Apigee Analytics and API Management":http://apigee.com/ require you to proxy your API requests through their servers.  The workflow is as follows.
+
+First you need to authorize the Twitter user via OAuth directly via the Twitter API (this part cannot be proxied)
+
+<pre><code>client = TwitterOAuth::Client.new(
+    :consumer_key => 'YOUR_APP_CONSUMER_KEY',
+    :consumer_secret => 'YOURA_APP_CONSUMER_SECRET'
+)
+request_token = client.request_token(:oauth_callback => 'YOUR_CALLBACK_URL')
+
+request_token.authorize_url
+=> http://twitter.com/oauth/authorize?oauth_token=TOKEN
+</code></pre>
+
+The user is sent to Twitter to allow the application to access their account and then you need to obtain the access token for the user
+
+<pre><code>access_token = client.authorize(
+  request_token.token,
+  request_token.secret,
+  :oauth_verifier => params[:oauth_verifier]
+)
+
+client.authorized?
+=> true
+</code></pre>
+
+Now you can make all further API calls through the proxy of your choice:
+
+<pre><code>access_token = @user.access_token # assuming @user
+client = TwitterOAuth::Client.new(
+    :proxy => 'http://XXX.YYY.apigee.com',
+    :consumer_key => 'YOUR_CONSUMER_KEY',
+    :consumer_secret => 'YOUR-CONSUMER-SECRET',
+    :token => access_token.token, 
+    :secret => access_token.secret
+)
+
+client.authorized?
+=> true
+
+client.update('Proxy via Apigee is working')
+</code></pre>

data/lib/twitter_oauth.rb

@@ -5,5 +5,5 @@ require 'mime/types'
 require 'twitter_oauth/client'
 
 module TwitterOAuth
-  VERSION = '0.4.0'
+  VERSION = '0.4.3'
 end

data/lib/twitter_oauth/status.rb

@@ -21,5 +21,10 @@ module TwitterOAuth
       post("/statuses/retweet/#{id}.json")
     end
     
+    # Returns the 100 most recent retweets of the tweet.
+    def retweets(id)
+      get("/statuses/retweets/#{id}.json")
+    end
+    
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: twitter_oauth
 version: !ruby/object:Gem::Version 
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors: 
 - Richard Taylor
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-10 00:00:00 +01:00
+date: 2010-08-11 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency