facebook_oauth 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) Richard Taylor
+
+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.textile

@@ -0,0 +1,70 @@
+h1. Facebook OAuth Graph API client library for Ruby
+
+h2. Install the gem
+
+sudo gem install facebook_oauth
+
+h2. Using the gem
+
+To make authorized requests with the client library you'll need to "create a Facebook Application":http://www.facebook.com/developers/createapp.php.
+
+h2. Authorized request example
+
+To use the full power of the Facebook API you need to authorize your application and a valid Facebook user via OAuth.
+An example showing how to update the status of an authorized user is below.
+
+Firstly we need to create an instance of the client with your application client credentials you have been given by Facebook
+when you set up your application.
+
+<pre><code>client = FacebookOAuth::Client.new(
+    :application_id => 'YOUR_APPLICATION_ID',
+    :application_secret => 'YOUR_APP_SECRET_KEY',
+    :callback => 'http://example.com/facebook/callback'
+)
+
+client.authorize_url
+=> "https://graph.facebook.com/oauth/authorize?scope=SCOPE&client_id=ID&type=web_server&redirect_uri=CALLBACK"
+</code></pre>
+
+In your application your user would be redirected to Facebook to authorize the application at this point. The code continues below assuming the user has authorized your application, facebook will return to your callback URL with a <code>code</code> parameter.
+
+<pre><code>access_token = client.authorize(:code => code)
+
+client.me.info # returns your user information
+</code></pre>
+
+Now if you keep hold of the access_token.token (usually in the database) for this user you won't need to re-authorize them next time.  When you create an instance of the client you can just pass in the access token and secret that you have stored.
+
+<pre><code>access_token = @user.access_token # assuming @user
+client = FacebookOAuth::Client.new(
+    :application_id => 'YOUR_APPLICATION_ID',
+    :application_secret => 'YOUR_APP_SECRET_KEY',
+    :callback => 'http://example.com/facebook/callback',
+    :token => access_token
+)
+
+client.me.info # returns your user information
+</code></pre>
+
+
+h2. Supported objects
+
+    * Me (a special object that represents the current authorized user)
+
+    * Album
+    * Event
+    * Group
+    * Link
+    * Note
+    * Page
+    * Photo
+    * Post
+    * Status
+    * User
+    * Video
+
+You can access any object listed above in the same way via the API.  For example, event attendees would be:
+
+<code>client.event('event_id').attending</code> 
+
+Check out the "Facebook API Reference":http://developers.facebook.com/docs/reference/api/ to see what methods are available.

data/lib/facebook_oauth.rb

@@ -0,0 +1,8 @@
+require 'oauth2'
+require 'json'
+require 'mime/types'
+
+require 'facebook_oauth/client'
+
+module FacebookOAuth
+end

data/lib/facebook_oauth/client.rb

@@ -0,0 +1,59 @@
+require 'facebook_oauth/objects'
+
+module FacebookOAuth
+  class Client
+    
+    def initialize(options = {})
+      @application_id = options[:application_id]
+      @application_secret = options[:application_secret]
+      @callback = options[:callback]
+      @token = options[:token]
+    end
+  
+    def authorize_url(options = {})
+      options[:scope] ||= 'email,offline_access'
+      consumer.web_server.authorize_url(
+        :redirect_uri => options[:callback] || @callback,
+        :scope => options[:scope]
+      )
+    end
+    
+    def authorize(options = {})
+      @access_token ||= consumer.web_server.get_access_token(
+        options[:code],
+        :redirect_uri => options[:callback] || @callback
+      )
+      @token ||= @access_token.token
+      @access_token
+    end
+    
+    private
+      def consumer
+        @consumer ||= OAuth2::Client.new(
+          @application_id,
+          @application_secret,
+          { :site=>"https://graph.facebook.com" }
+        )
+      end
+
+      def access_token
+        @access_token ||= OAuth2::AccessToken.new(consumer, @token)
+      end
+      
+      def _get(url)
+        oauth_response = access_token.get(url)
+        JSON.parse(oauth_response)
+      end
+
+      def _post(url, body = '', headers = {})
+        oauth_response = access_token.post(url, body, headers)
+        JSON.parse(oauth_response)
+      end
+
+      def _delete(url)
+        oauth_response = access_token.delete(url)
+        JSON.parse(oauth_response)
+      end
+  end
+end
+   

data/lib/facebook_oauth/objects.rb

@@ -0,0 +1,70 @@
+module FacebookOAuth
+  class Client
+    
+    def me(id = 'me')
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def album(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def event(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def group(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def link(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def note(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def page(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def photo(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def post(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def status(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def user(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+    def video(id)
+      FacebookOAuth::FacebookObject.new(id, self)
+    end
+    
+  end
+  
+  class FacebookObject
+    def initialize(oid, client)
+      @oid = oid
+      @client = client
+    end
+    
+    def info
+      @client.send(:_get, @oid)
+    end
+    
+    def method_missing(a)
+      puts a.inspect
+      @client.send(:_get, "#{@oid}/#{a.to_s}")
+    end
+    
+  end
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification 
+name: facebook_oauth
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Richard Taylor
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-06 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: oauth2
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.0.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.9
+    - - <=
+      - !ruby/object:Gem::Version 
+        version: 1.2.4
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mime-types
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.16"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: facebook_oauth is a Ruby client library for facebook using the oauth method.
+email: moomerman@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- README.textile
+- lib/facebook_oauth.rb
+- lib/facebook_oauth/client.rb
+- lib/facebook_oauth/objects.rb
+has_rdoc: true
+homepage: http://github.com/moomerman/facebook_oauth
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: facebook_oauth
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 2
+summary: facebook_oauth is a Ruby client library for facebook using the oauth method.
+test_files: []
+