namxam-rfgraph 0.4

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2010 Conor Hunt <conor.hunt@gmail.com>
+
+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.md

@@ -0,0 +1,52 @@
+Ruby Facebook Graph API Wrapper
+===============================
+
+A simple Ruby wrapper to help use the Facebook Graph API.
+
+Documentation on the Graph API is available here:
+[http://developers.facebook.com/docs/](http://developers.facebook.com/docs/)
+
+This code is based off of the Python SDK - [http://github.com/facebook/python-sdk/](http://github.com/facebook/python-sdk/)
+
+Install
+-------
+
+gem install rfgraph
+
+Example
+-------
+
+Without auth token
+
+    require 'rfgraph'
+    req = RFGraph::Request.new
+    req.get_object("19292868552")
+    req.get_object("99394368305/photos")
+    req.get_object("331218348435", :metadata => 1)
+
+With auth token
+
+    require 'rfgraph'
+    fauth = RFGraph::Auth.new(APP_ID, APP_SECRET)
+
+    # Get the URL to redirect your user to in their web browser.
+    # For options see: http://developers.facebook.com/docs/authentication/
+    # For scope permissions see: http://developers.facebook.com/docs/authentication/permissions
+    auth_url = fauth.authorize_url("http://yourwebsite.com/callback", :display => :popup, :scope => [])
+
+    # Get the code that facebook returns after the user auths your app and turn that into a auth token
+    # Make sure that the callback url is the same as in the previous request, otherwise the request will fail
+    auth_token = fauth.authorize("http://yourwebsite.com/callback", FACEBOOK_CODE)
+
+    # Make some requests using the auth token
+    request = RFGraph::Request.new(auth_token)
+    request.get_object("me")
+    request.get_object("me/friends")
+
+    request.put_wall_post("Awesome message!")
+
+COPYRIGHT
+---------
+
+Copyright (c) 2010 Conor Hunt <conor.hunt@gmail.com>
+Released under the MIT license

data/lib/rfgraph.rb

@@ -0,0 +1,19 @@
+require 'rfgraph/request'
+require 'rfgraph/auth'
+
+module RFGraph
+  BASE_URL = "https://graph.facebook.com"
+
+  def self.get_user_from_cookie(cookies, app_id, app_secret)
+    # TODO
+  end
+
+  class RFGraphError < RuntimeError
+    attr_accessor :code
+
+    def initialize(code, message)
+      @code = code
+      super(message)
+    end
+  end
+end

data/lib/rfgraph/auth.rb

@@ -0,0 +1,45 @@
+require 'open-uri'
+require 'cgi'
+
+module RFGraph
+  class Auth
+    attr_accessor :app_id
+    attr_accessor :app_secret
+    attr_accessor :access_token
+    attr_accessor :expires
+
+    def initialize(app_id, app_secret)
+      @app_id = app_id
+      @app_secret = app_secret
+    end
+
+    # Options:
+    # * :display - page (default), popup, wap, touch. See: http://developers.facebook.com/docs/authentication/.
+    # * :scope - either a String "user_photos,user_videos,stream_publish" or an
+    # Array like [:user_photos, :user_videos, :stream_publish]
+    # For more permission scopes, see http://developers.facebook.com/docs/authentication/permissions
+    #
+    # All other options in the options Hash will be put in the authorize_url.
+    def authorize_url(callback_url, options = {})
+      url = "#{BASE_URL}/oauth/authorize?client_id=#{app_id}&redirect_uri=#{callback_url}"
+      scope = options.delete(:scope)
+      url += "&scope=#{scope.join(',')}" unless scope.blank?
+      url += "&#{options.to_query}" unless options.blank? # Add other options. FIXME: to_query method requires Rails?!
+      return url
+    end
+    
+    # Take the oauth2 request token and turn it into an access token 
+    # which can be used to access private data
+    def authorize(callback_url, code)
+      data = open("#{BASE_URL}/oauth/access_token?client_id=#{app_id}&redirect_uri=#{CGI.escape callback_url}&client_secret=#{app_secret}&code=#{CGI.escape code}").read
+      
+      # The expiration date is not necessarily set, as the app might have
+      # requested offline_access to the data
+      match_data = data.match(/expires=([^&]+)/)
+      @expires = match_data && match_data[1] || nil
+      
+      # Extract the access token
+      @access_token = data.match(/access_token=([^&]+)/)[1]
+    end
+  end
+end

data/lib/rfgraph/request.rb

@@ -0,0 +1,82 @@
+require 'json'
+require 'net/http'
+require 'net/https'
+
+module RFGraph
+  class Request
+    attr_accessor :access_token
+
+    def initialize(access_token = nil)
+      @access_token = access_token
+    end
+
+    def get_object(id, args = {})
+      request(id, args)
+    end
+
+    def get_objects(ids, args = {})
+      args["ids"] = ids.join(",")
+      return request("", args)
+    end
+
+    def get_connections(id, connection_name, args = {})
+      return request(id + "/" + connection_name, args)
+    end
+
+    def put_object(parent_object, connection_name, data = {})
+      raise RFGraphError.new(-1, "Access token required for put requests") if access_token.nil?
+      post_request(parent_object + "/" + connection_name, data)
+    end
+
+    def put_wall_post(message, attachment = {}, profile_id = "me")
+      put_object(profile_id, "feed", attachment.merge({'message' => message}))
+    end
+
+    def put_comment(object_id, message)
+      put_object(object_id, "comments", {"message" => message})
+    end
+
+    def put_like(object_id)
+      put_object(object_id, "likes")
+    end
+
+    def delete_object(id)
+      post_request(id, {"method"=> "delete"})
+    end
+
+    def post_request(path, post_args = {})
+      request(path, {}, post_args)
+    end
+
+    def request(path, url_args = {}, post_args = nil)
+      if access_token
+        if post_args
+          post_args["access_token"] = access_token
+        else
+          url_args["access_token"] = access_token
+        end
+      end
+
+      encoded_url_args = url_args.collect {|k,v| "#{CGI.escape k.to_s}=#{CGI.escape v.to_s}" }.join("&")
+      url = URI.parse("#{BASE_URL}/#{path}?#{encoded_url_args}")
+      http = Net::HTTP.new(url.host, url.port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+      response = if post_args
+        encoded_post_args = post_args.collect {|k,v| "#{CGI.escape k.to_s}=#{CGI.escape v.to_s}" }.join("&")
+        http.post("#{url.path}?#{url.query}", encoded_post_args)
+      else
+        http.get("#{url.path}?#{url.query}")
+      end
+
+      response = JSON.parse(response.body)
+
+      if response["error"]
+        raise RFGraphError.new(response["error"]["code"], response["error"]["message"])
+      end
+
+      response
+    end
+  end
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: namxam-rfgraph
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 4
+  version: "0.4"
+platform: ruby
+authors: 
+- Conor Hunt
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-30 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 4
+        version: 1.2.4
+  type: :runtime
+  version_requirements: *id001
+description: Ruby wrapper for Facebook Graph API
+email: conor.hunt@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.md
+- LICENSE
+- lib/rfgraph/auth.rb
+- lib/rfgraph/request.rb
+- lib/rfgraph.rb
+has_rdoc: true
+homepage: http://github.com/conorh/rfgraph
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for Facebook Graph API
+test_files: []
+