fgraph 0.1.0

data/History

@@ -0,0 +1,2 @@
+0.0.1 - May 9, 2010
+  * Initial release

data/License

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Herryanto Siatono
+
+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.rdoc

@@ -0,0 +1,136 @@
+= fgraph
+
+* http://github.com/jugend/fgraph
+
+== Description
+
+Facebook Graph Ruby API implementation with Ruby magic (http://graph.facebook.com).
+
+== Installation
+
+  sudo gem install fgraph
+
+=== Facebook Graph Cheat Sheet
+
+  sudo gem install cheat
+  cheat fbgraph
+
+=== Single object query
+
+  # Users: https://graph.facebook.com/btaylor  (Bret Taylor)
+  FGraph.object('btaylor')
+
+  # Pages: https://graph.facebook.com/cocacola (Coca-Cola page)
+  FGraph.object('cocacola')
+
+  # Fields selection with metadata
+  FGraph.object('btaylor', :fields => 'id,name,picture', :metadata => 1)
+
+  # Page photos
+  FGraph.object('/cocacola/photos')
+  FGraph.object_photos('cocacola')
+
+  # Current user: https://graph.facebook.com/me?access_token=...
+  FGraph.me(:access_token => '...')
+
+  # Current user's friends: https://graph.facebook.com/me/friends?access_token=...
+  FGraph.me('friends', :access_token => '...')
+  FGraph.me_friends(:access_token => '...')
+
+=== Multiple objects query
+
+  # Multiple users select: https://graph.facebook.com?ids=arjun,vernal
+  FGraph.objects('arjun', 'vernel')
+
+  # Filter fields: https://graph.facebook.com?ids=arjun,vernal&fields=id,name,picture
+  FGraph.objects('arjun', 'vernel', :fields => 'id,name,picture')
+
+=== OAuth
+
+OAuth authorization URL:
+  # https://graph.facebook.com/oauth/authorize?
+  #   client_id=...&
+  #   redirect_uri=http://www.example.com/oauth_redirect&
+  #   scope=publish_stream
+  FGraph.oauth_authorize_url('[client id]', 'http://www.example.com/oauth_redirect', :scope => 
+    'publish_stream')
+
+OAuth Access Token:
+  # https://graph.facebook.com/oauth/access_token?
+  #   client_id=...&
+  #   client_secret=...&
+  #   redirect_uri=http://www.example.com/oauth_redirect&
+  #   code=...
+  FGraph.oauth_access_token('[client id]', '[client secret]', 
+     :redirect_uri => ''http://www.example.com/oauth_redirect', 
+     :code => '[authorization code]')
+
+OAuth Application Access Token, required to access application anlytics data:
+  # https://graph.facebook.com/oauth/access_token?
+  #   client_id=...&
+  #   client_secret=...&
+  #   type=client_cred
+  FGraph.oauth_access_token('[client id]', '[client secret]', :type => 'client_cred')
+
+=== Publish to Facebook Graph
+
+  # Post to user's feed.
+  #   curl -F 'access_token=...' \
+  #     -F 'message=Hello, Arjun. I like this new API.' \
+  #     https://graph.facebook.com/arjun/feed
+  FGraph.publish('arjun/feed', :message => 'Hello, Arjun. I like this n  ew API.', 
+    :access_token => '...')
+  FGraph.publish_feed('arjun', :message => '...', :access_token => '...  ')
+  FGraph.publish_feed('me', ':message => '...', :access_token => '...')
+
+=== Remove from Facebook Graph
+
+  # DELETE https://graph.facebook.com/ID?access_token=... HTTP/1.1
+  FGraph.remove('[ID]')
+  FGraph.remove('[ID]/likes')
+  FGraph.remove_likes('[ID]')
+
+=== Search
+
+  # https://graph.facebook.com/search?q=watermelon&type=post
+  FGraph.search('watermelon', :type => 'post')
+  FGraph.search_post('watermelon')
+
+=== Insights
+
+  # https://graph.facebook.com/app_id/insights?access_token=...
+  FGraph.insights('[app_id]', '[app_access_token]')
+
+  # https://graph.facebook.com/app_id/insights/application_api_call/day?access_token=...
+  FGraph.insights('[app_id]', '[app_access_token]', :metric_path => 'application_api_call/day')
+
+=== Pagination Options
+
+* <tt>limit</tt> - max no of records
+* <tt>offset</tt> - offset
+* <tt>until</tt> - since (a unix timestamp or any date accepted by strtotime, e.g. yesterday)
+
+== License
+
+(The MIT License)
+
+Copyright (c) 2010 Herryanto Siatono http://www.pluitsolutions.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/Rakefile

@@ -0,0 +1,37 @@
+require 'rake'
+require 'jeweler'
+
+begin
+  Jeweler::Tasks.new do |gem|
+    gem.name = "fgraph"
+    gem.summary = "Ruby Facebook Graph API"
+    gem.description = "Ruby Facebook Graph API"
+    gem.email = "herryanto@gmail.com"
+    gem.homepage = "http://github.com/jugend/fgraph"
+    gem.authors = ["Herryanto Siatono"]
+    gem.files = FileList["[A-Z]*", "{examples,lib,test}/**/*"]
+    
+    gem.add_dependency("httparty", "~> 0.5.0")
+    # gem.add_dependency("hashie", "~> 0.2.0")
+    
+    gem.add_development_dependency("shoulda", "~> 2.10.0")
+    gem.add_development_dependency("jnunemaker-matchy", "~> 0.4.0")
+    gem.add_development_dependency("mocha", "~> 0.9.0")
+    gem.add_development_dependency("fakeweb", "~> 1.2.0")
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+
+Jeweler::GemcutterTasks.new
+
+require "rake/testtask"
+Rake::TestTask.new(:test) do |test|
+  test.libs << "test"
+  test.ruby_opts << "-rubygems"
+  test.pattern = "test/**/*_test.rb"
+  test.verbose = true
+end
+
+task :default  => :test
+task :test     => :check_dependencies

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:major: 0
+:minor: 1
+:patch: 0
+:build: 

data/examples/get_access_token.rb

@@ -0,0 +1,19 @@
+# Retrieve your code by accessing Authorization URL From your browser, 
+# it should redirect to 'redirect_uri' with 'code' param.
+# Replace the FACEBOOK_XXX constants accordingly.
+#
+# Authorization URL, access from your browser to get Authorization Code
+# https://graph.facebook.com/oauth/authorize?client_id=878116c4a4a76f25e4beb97ab096cc92&redirect_uri=http%3A%2F%2Fbookjetty.pluitsolutions.com%2F&scope=publish_stream
+
+FACEBOOK_APP_ID = '878116c4a4a76f25e4beb97ab096cc92'
+FACEBOOK_APP_SECRET = '41f0e7ee8b6409dce1610de9926477c4'
+FACEBOOK_OAUTH_REDIRECT_URI = 'http://bookjetty.pluitsolutions.com/'
+FACEBOOK_OAUTH_CODE = '2.Dq5RDPHxhsgaeScc_fiigg__.3600.1273831200-756314021|4Eew6iuIg0x69N1d3Cr99gdVGwU.'
+FACEBOOK_OAUTH_SCOPE = ''
+
+require 'pp'
+require 'rubygems'
+require File.dirname(__FILE__) + '/../lib/fgraph'
+
+pp FGraph.oauth_access_token(FACEBOOK_APP_ID, FACEBOOK_OAUTH_REDIRECT_URI,
+  FACEBOOK_APP_SECRET, FACEBOOK_OAUTH_CODE)

data/examples/publish_feed.rb

@@ -0,0 +1,16 @@
+# Replace FACEBOOK_ACCESS_TOKEN with valid token with publish_stream extended permission
+#
+# Post to user's feed.
+#   curl -F 'access_token=...' -F 'message=Hello, Arjun. I like this new API.' https://graph.facebook.com/me/feed
+# curl -F 'access_token=112157085478818|2.AlP5TBjZ9F6wOXPX_V0GTg__.3600.1273777200-756314021|NV7Dnuol59KbQr6W1axv6ZmytaI.' -F 'message=Hello, Arjun. I like this new API.' https://graph.facebook.com/me/feed
+FACEBOOK_ACCESS_TOKEN = '112157085478818|2.Dq5RDPHxhsgaeScc_fiigg__.3600.1273831200-756314021|Tvm41skDwOdGR2O3Lz4owMVz1lM.'
+
+require 'rubygems'
+require 'pp'
+require File.dirname(__FILE__) + '/../lib/fgraph'
+
+# Post to current user's f eed
+pp FGraph.publish_feed('me', :message => 'Hello. I like this new API.', 
+  :access_token => FACEBOOK_ACCESS_TOKEN)
+  
+puts "Message successfully posted."

data/lib/fgraph.rb

@@ -0,0 +1,321 @@
+require 'httparty'
+require 'cgi'
+require 'oauth2'
+require 'fgraph/client'
+
+module FGraph
+  include HTTParty
+  base_uri 'https://graph.facebook.com'
+  format :json
+  
+  # Facebook Error
+  class FacebookError < StandardError
+    attr_reader :data
+    
+    def initialize(data)
+      @data = data
+      super("(#{data['type']}) #{data['message']}")
+    end
+  end
+  
+  class QueryParseError < FacebookError; end
+  class GraphMethodError < FacebookError; end
+  class OAuthError < FacebookError; end
+  class OAuthAccessTokenError < OAuthError; end
+  
+  # Single object query.
+  # 
+  #   # Users: https://graph.facebook.com/btaylor  (Bret Taylor)
+  #   FGraph.object('btaylor')
+  #
+  #   # Pages: https://graph.facebook.com/cocacola (Coca-Cola page)
+  #   FGraph.object('cocacola')
+  #
+  #   # Fields selection with metadata
+  #   FGraph.object('btaylor', :fields => 'id,name,picture', :metadata => 1)
+  #
+  #   # Page photos
+  #   FGraph.object('/cocacola/photos')
+  #   FGraph.object_photos('cocacola')
+  #
+  def self.object(id, options={})
+    perform_get("/#{id}", options)
+  end
+  
+  # call-seq:
+  #   FGraph.objects(id, id)

+  #   FGraph.objects(id, id, options_hash)
+  #
+  # Multiple objects query.
+  # 
+  #   # Multiple users select: https://graph.facebook.com?ids=arjun,vernal
+  #   FGraph.objects('arjun', 'vernel')
+  #
+  #   # Filter fields: https://graph.facebook.com?ids=arjun,vernal&fields=id,name,picture
+  #   FGraph.objects('arjun', 'vernel', :fields => 'id,name,picture')
+  #
+  def self.objects(*args)
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    options = options.merge(:ids => args.join(','))
+    perform_get("/", options)
+  end
+  
+  # call-seq:
+  #   FGraph.me(category)

+  #   FGraph.me(category, options_hash)
+  # 
+  # Returns current user object details.
+  # 
+  # <tt>category</tt> - <tt>friends|home|feed|likes|movies|books|notes|photos|videos|events|groups</tt>
+  #
+  #   # Current user: https://graph.facebook.com/me?access_token=...
+  #   FGraph.me(:access_token => '...')
+  # 
+  #   # Current user's friends: https://graph.facebook.com/me/friends?access_token=...
+  #   FGraph.me('friends', :access_token => '...')
+  #   FGraph.me_friends(:access_token => '...')
+  #
+  def self.me(*args)
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    category = args.shift
+    
+    path = "me"
+    path += "/#{category}" unless category.blank?
+    self.object(path, options)
+  end
+  
+  # Request authorization from Facebok to fetch private data in the profile or permission to publish on a
+  # user's behalf. Returns Oauth Authorization URL, redirect to this URL to allow user to authorize your
+  # application from Facebook.
+  #
+  # <tt>client_id</tt> - Facebook API Key
+  # <tt>redirect_uri</tt> - Needs to begin with your app's Connect URL. For instance, if your Connect URL 
+  # is http://www.example.com then your redirect URI could be http://www.example.com/oauth_redirect.
+  # <tt>scope (optional)</tt> -
+  #
+  # ==== Options
+  # * <tt>scope</tt> -  Extended permission required to fetch private data or request permision to 
+  # publish to Facebook on a user's behalf.
+  # * <tt>display</tt> - Other display type for authentication/authorization form, i.e. popup, touch.
+  #
+  #   # https://graph.facebook.com/oauth/authorize?
+  #   #   client_id=...&
+  #   #   redirect_uri=http://www.example.com/oauth_redirect&
+  #   #   scope=publish_stream
+  #
+  #   FGraph.oauth_authorize_url('[client id]', 'http://www.example.com/oauth_redirect', :scope => 
+  #     'publish_stream')
+  #
+  def self.oauth_authorize_url(client_id, redirect_uri, options={})
+    self.format_url('/oauth/authorize', {
+      :client_id => client_id,
+      :redirect_uri => redirect_uri
+    }.merge(options))
+  end
+  
+  # Return OAuth access_token. There are two types of access token, user access token and application 
+  # access token.
+  #
+  # User access_token requires <tt>code</tt> and and <tt>redirect_uri</tt> options. <tt>code</tt> is
+  # the autorization code appended as query string to redirect URI when accessing oauth authorization URL.
+  #
+  #   # https://graph.facebook.com/oauth/access_token?
+  #   #   client_id=...&
+  #   #   client_secret=...&
+  #   #   redirect_uri=http://www.example.com/oauth_redirect&
+  #   #   code=...
+  #   FGraph.oauth_access_token('[client id]', '[client secret]', 
+  #      :redirect_uri => ''http://www.example.com/oauth_redirect', 
+  #      :code => '[authorization code]')
+  #
+  # Application access token requires <tt>:type => 'client_cred'</td> option. Used to access application
+  # insights data.
+  #
+  #   # https://graph.facebook.com/oauth/access_token?
+  #   #   client_id=...&
+  #   #   client_secret=...&
+  #   #   type=client_cred
+  #   FGraph.oauth_access_token('[client id]', '[client secret]', :type => 'client_cred')
+  #
+  def self.oauth_access_token(client_id, client_secret, options={})
+    url = self.format_url('/oauth/access_token', {
+      :client_id => client_id,
+      :client_secret => client_secret
+    }.merge(options || {}))
+    
+    response = self.perform_get(url)
+    response_hash = {}
+    response.split('&').each do |value|
+      value_pair = value.split('=')
+      response_hash[value_pair[0]] = value_pair[1]
+    end
+    response_hash
+  end
+  
+  # Shortcut to retrieve application access token.
+  def self.oauth_app_access_token(client_id, client_secret)
+    self.oauth_access_token(client_id, client_secret, :type => 'client_cred')
+  end
+  
+  # Publish to Facebook, you would need to be authorized and provide access token.
+  #
+  #   # Post to user's feed.
+  #   #   curl -F 'access_token=...' \
+  #   #     -F 'message=Hello, Arjun. I like this new API.' \
+  #   #     https://graph.facebook.com/arjun/feed
+  #   FGraph.publish('arjun/feed', :message => 'Hello, Arjun. I like this new API.', 
+  #     :access_token => '...')
+  #   FGraph.publish_feed('arjun', :message => '...', :access_token => '...')
+  #   FGraph.publish_feed('me', ':message => '...', :access_token => '...')
+  #
+  # ==== Options
+  #
+  #   Method                Description                             Options
+  #   -------------------------------------------------------------------------------------
+  #   /PROFILE_ID/feed      write to the given profile's feed/wall  :message, :picture, 
+  #                                                                 :link, :name, description
+  #   /POST_ID/comments     comment on the given post               :message
+  #   /POST_ID/likes        like the given post                     none
+  #   /PROFILE_ID/notes     write a note on the given profile       :message, :subject
+  #   /PROFILE_ID/links     write a link on the given profile       :link, :message
+  #   /EVENT_ID/attending   attend the given event                  none
+  #   /EVENT_ID/maybe       maybe attend the given event            none
+  #   /EVENT_ID/declined    decline the given event                 none
+  # 
+  def self.publish(id, options={})
+    self.perform_post("/#{id}", options)
+  end
+  
+  # Delete objects in the graph.
+  #
+  #   # DELETE https://graph.facebook.com/ID?access_token=... HTTP/1.1
+  #   
+  #   FGraph.remove('[ID]')
+  #   FGraph.remove('[ID]/likes')
+  #   FGraph.remove_likes('[ID]')
+  #
+  def self.remove(id, options={})
+    self.perform_delete("/#{id}", options)
+  end
+  
+  # Search over all public objects in the social graph.
+  # 
+  #   # https://graph.facebook.com/search?q=watermelon&type=post
+  #   FGraph.search('watermelon', :type => 'post')
+  #   FGraph.search_post('watermelon')
+  #
+  # ==== Options
+  # * <tt>type</tt> - <tt>album|event|group|link|note|page|photo|post|status|user|video</tt>
+  # * <tt>limit</tt> - max no of records
+  # * <tt>offset</tt> - offset
+  # * <tt>until</tt> - since (a unix timestamp or any date accepted by strtotime, e.g. yesterday)
+  def self.search(query, options={})
+    self.perform_get("/search", {
+      :q => query
+    }.merge(options|| {}))
+  end
+  
+  # Download insights data for your application.
+  #
+  #   # https://graph.facebook.com/app_id/insights?access_token=...
+  #   FGraph.insights('[app_id]', '[app_access_token]')
+  #
+  #   # https://graph.facebook.com/app_id/insights/application_api_call/day?access_token=...
+  #   FGraph.insights('[app_id]', '[app_access_token]', :metric_path => 'application_api_call/day')
+  # 
+  # ==== Options
+  # * <tt>metric_path</tt> - e.g. application_api_calls/day
+  # * <tt>since</tt> - since (a unix timestamp or any date accepted by strtotime, e.g. yesterday)
+  # * <tt>until</tt> - until (a unix timestamp or any date accepted by strtotime, e.g. yesterday)
+  def self.insights(app_id, app_access_token, options={})
+    metric_path = options.delete(:metric_path)
+    
+    path = "/#{app_id}/insights"
+    path += "/#{metric_path}" if metric_path
+      
+    self.perform_get(path, {
+      :access_token => app_access_token
+    }.merge(options || {}))
+  end
+  
+  def self.perform_get(uri, options = {})
+    handle_response(get(uri, {:query => options}))
+  end
+  
+  def self.perform_post(uri, options = {})
+    handle_response(post(uri, {:body => options}))
+  end
+  
+  def self.perform_delete(uri, options = {})
+    handle_response(delete(uri, {:body => options}))
+  end
+  
+  def self.handle_response(response)
+    # Check for error
+    return response unless response['error']
+    
+    case response['error']['type']
+      when 'QueryParseException'
+        raise QueryParseError, response['error']
+      when 'GraphMethodException'
+        raise GraphMethodError, response['error']
+      when 'OAuthException'
+        raise OAuthError, response['error']
+      when 'OAuthAccessTokenException'
+        raise OAuthAccessTokenError, response['error']
+      else
+        raise FacebookError, response['error']
+    end
+  end
+  
+  def self.format_url(path, options={})
+    url = self.base_uri.dup
+    url << path
+    unless options.blank?
+      url << "?"
+      
+      option_count = 0
+      
+      stringified_options = {}
+      options.each do |key, value|
+        stringified_options[key.to_s] = value
+      end
+      options = stringified_options
+      
+      options.each do |option|
+        next if option[1].blank?
+        url << "&" if option_count > 0
+        url << "#{option[0]}=#{CGI.escape(option[1].to_s)}"
+        option_count += 1
+      end
+    end
+    url
+  end
+  
+  def self.method_missing(name, *args, &block)
+    names = name.to_s.split('_')
+    super unless names.length > 1
+    
+    case names.shift
+      when 'object'
+        # object_photos
+        self.object("#{args[0]}/#{names[0]}", args[1])
+      when 'me'
+        # me_photos
+        self.me(names[0], args[0])
+      when 'publish'
+        # publish_feed(id)
+        self.publish("#{args[0]}/#{names[0]}", args[1])
+      when 'remove'
+        # remove_feed(id)
+        self.remove("#{args[0]}/#{names[0]}", args[1])
+      when 'search'
+        # search_user(query)
+        options = args[1] || {}
+        options[:type] = names[0]
+        self.search(args[0], options)
+      else
+        super
+    end
+  end
+end

data/lib/fgraph/client.rb

@@ -0,0 +1,111 @@
+require 'oauth2'
+
+module FGraph
+  
+  # Facebook proxy class to call Facebook Graph API methods with default options.
+  # Please refer to FGraph method documentation for more information.
+  class Client
+    attr_reader :oauth_client, :client_id, :client_secret, :options
+
+    # Initialize Client with default options, so options are not required to be passed
+    # when calling respective Facebook Graph API methods.
+    # 
+    # ==== Options
+    # * <tt>client_id</tt> - Application API key
+    # * <tt>client_secret</tt> - Application Secret
+    # * <tt>app_id</tt> - Application ID
+    # * <tt>access_token</tt> - Access token, required to publish to Facebook Graph or access
+    #   current user profile.
+    # * <tt>app_access_token</tt> - Application access token, required to access Facebook insights.
+    #   Auto generated if client_id and client_secret option are provided.
+    def initialize(options={})
+      @options = options
+    end
+    
+    def oauth_authorize_url(redirect_uri)
+      FGraph.oauth_authorize_url(self.options[:client_id], redirect_uri)
+    end
+    
+    def oauth_access_token(redirect_uri, code)
+      FGraph.oauth_access_token(self.options[:client_id], self.options[:client_secret],
+        :redirect_uri => redirect_uri, :code => code)
+    end
+    
+    def oauth_app_access_token
+      FGraph.oauth_app_access_token(self.options[:client_id], self.options[:client_secret])
+    end
+    
+    def object(id, options={})
+      FGraph.object(id, {:access_token => self.options[:access_token]}.merge(options || {}))
+    end
+    
+    def objects(*args)
+      return if args.blank?
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:access_token] = self.options[:access_token]
+      args << options
+      
+      FGraph.objects(args)
+    end
+    
+    def me(*args)
+      return if args.blank?
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:access_token] = self.options[:access_token]
+      args << options
+      
+      FGraph.me(args)
+    end
+    
+    def publish(id, options={})
+      FGraph.publish(id, {
+        :access_token => self.options[:access_token]
+      }.merge(options || {}))
+    end
+    
+    def remove(id, options={})
+      FGraph.remove(id, {
+        :access_token => self.options[:access_token]
+      }.merge(options || {}))
+      
+    end
+    
+    def search(query, options={})
+      FGraph.search(query, options)
+    end
+    
+    def insights(options={})
+      unless self.options[:app_access_token]
+        self.options[:app_access_token] = self.oauth_app_access_token
+      end
+      FGraph.insights(self.options[:app_id], self.options[:app_access_token], options)
+    end
+    
+    def method_missing(name, *args, &block)
+      names = name.to_s.split('_')
+      super unless names.length > 1
+    
+      case names.shift
+        when 'object'
+          # object_photos
+          self.object("#{args[0]}/#{names[0]}", args[1])
+        when 'me'
+          # me_photos
+          self.me(names[0], args[0])
+        when 'publish'
+          # publish_feed(id)
+          self.publish("#{args[0]}/#{names[0]}", args[1])
+        when 'remove'
+          # remove_feed(id)
+          self.remove("#{args[0]}/#{names[0]}", args[1])
+        when 'search'
+          # search_user(query)
+          options = args[1] || {}
+          options[:type] = names[0]
+          self.search(args[0], options)
+        else
+          super
+      end
+    end
+  end
+end 

data/test/fgraph/client_test.rb

@@ -0,0 +1,155 @@
+require 'test_helper'
+
+class ClientTest < Test::Unit::TestCase
+  FACEBOOK_API_KEY = '878116c4a4b79f25e4beb97ab096cc92'
+  FACEBOOK_APP_SECRET = '41f0e7ee8b6501dca1610de9926477c4'
+  FACEBOOK_APP_ID = '112157085578818'
+  FACEBOOK_OAUTH_REDIRECT_URI = 'http://www.example.com/oauth_redirect'
+  FACEBOOK_OAUTH_CODE = '2.0eXhebBSDTpoe08qIaocNQ__.3600.1273748400-503153225|caqygNb5Gobz6lpj3HXjlthDxds.'
+  FACEBOOK_OAUTH_ACCESS_TOKEN = "115187085478818|rDIv_5zgjCSM_fWBv5Z-lQr5gFk."
+  FACEBOOK_OAUTH_APP_ACCESS_TOKEN = "112167085478818|rDIv_5zgjCSM_fWBv5Z-lQr5gFk."
+  
+  def fb_client
+    FGraph::Client.new(
+      :client_id => FACEBOOK_API_KEY,
+      :client_secret => FACEBOOK_APP_SECRET,
+      :access_token => FACEBOOK_OAUTH_ACCESS_TOKEN
+    )
+  end
+  
+  context "FGraph::Client#oauth_authorize_url" do
+    should "call FGraph.oauth_authorize_url with :client_id option" do
+      FGraph.expects(:oauth_authorize_url).with(FACEBOOK_API_KEY, FACEBOOK_OAUTH_REDIRECT_URI)
+      fb_client.oauth_authorize_url(FACEBOOK_OAUTH_REDIRECT_URI)
+    end
+  end
+  
+  context "FGraph::Client#oauth_access_token" do
+    should "call FGraph.oauth_access_token with :client_id and :client_secret options" do
+      FGraph.expects(:oauth_access_token).with(FACEBOOK_API_KEY, FACEBOOK_APP_SECRET, 
+        :redirect_uri => FACEBOOK_OAUTH_REDIRECT_URI, :code => FACEBOOK_OAUTH_CODE)
+        
+      fb_client.oauth_access_token(FACEBOOK_OAUTH_REDIRECT_URI, FACEBOOK_OAUTH_CODE)
+    end
+  end
+  
+  context "FGraph::Client#object" do
+    should "call FGraph.object with :access_token option" do
+      object_id = '12345'
+      FGraph.expects(:object).with(object_id, 
+        :access_token => FACEBOOK_OAUTH_ACCESS_TOKEN,
+        :fields => 'user_photos'
+      )
+        
+      fb_client.object(object_id, :fields => 'user_photos')
+    end
+    
+    should "support #object_[category] method" do
+      client = fb_client
+      client.expects(:object).with('arun/photos', {:limit => 5})
+      client.object_photos('arun', {:limit => 5})
+    end
+  end
+
+  context "FGraph::Client#objects" do
+    should "call FGraph.objects with :access_token option" do
+      FGraph.expects(:objects).with(['1', '2', {
+        :access_token => FACEBOOK_OAUTH_ACCESS_TOKEN, 
+        :fields => 'user_photos'
+      }])
+      
+      fb_client.objects('1', '2', :fields => 'user_photos')
+    end
+  end
+  
+  context "FGraph::Client#me" do
+    should "call FGraph.me with :access_token option" do
+      FGraph.expects(:me).with([{
+        :access_token => FACEBOOK_OAUTH_ACCESS_TOKEN, 
+        :fields => 'user_photos'
+      }])
+      
+      fb_client.me(:fields => 'user_photos')
+    end
+    
+    should "support #me_[category] method" do
+      client = fb_client
+      client.expects(:me).with('photos', {:limit => 5})
+      client.me_photos(:limit => 5)
+    end
+  end
+  
+  context "FGraph::Client#publish" do
+    should "call FGraph.publish with :access_token option" do
+      id = '1'
+      FGraph.expects(:publish).with(id, {
+        :access_token => FACEBOOK_OAUTH_ACCESS_TOKEN, 
+        :message => 'hello'
+      })
+      
+      fb_client.publish(id, :message => 'hello')
+    end
+    
+    should "support publish_[category] method" do
+      client = fb_client
+      client.expects(:publish).with('me/feed', {:limit => 5})
+      client.publish_feed('me', {:limit => 5})
+    end
+  end
+  
+  context "FGraph::Client#remove" do
+    should "call FGraph.remove with :access_token option" do
+      id = '1'
+      FGraph.expects(:remove).with(id, {
+        :access_token => FACEBOOK_OAUTH_ACCESS_TOKEN
+      })
+      
+      fb_client.remove(id)
+    end
+    
+    should "support remove_[category] method" do
+      client = fb_client
+      client.expects(:remove).with('12345/likes', {:limit => 5})
+      client.remove_likes('12345', :limit => 5)
+    end
+  end
+  
+  context "FGraph::Client#search" do
+    should "call FGraph.search with options" do
+      query = 'watermelon'
+      options = {:limit => 5}
+      FGraph.expects(:search).with(query, options)
+      
+      fb_client.search(query, options)
+    end
+    
+    should "support dynamic method search_[type] method" do
+      client = fb_client
+      client.expects(:search).with('watermelon', {
+        :type => 'post'
+      })
+      client.search_post('watermelon')
+    end
+  end
+  
+  context "FGraph::Client#insights" do
+    should "auto populate :app_id and :oauth_app_access_token" do
+      client = fb_client 
+      client.options[:app_id] = FACEBOOK_APP_ID
+      client.options[:app_access_token] = FACEBOOK_OAUTH_APP_ACCESS_TOKEN
+      
+      FGraph.expects(:insights).with(FACEBOOK_APP_ID, FACEBOOK_OAUTH_APP_ACCESS_TOKEN, {})
+      client.insights
+    end
+    
+    should "auto retrieve :oauth_app_access_token option" do
+      client = fb_client
+      
+      client.expects(:oauth_app_access_token).returns(FACEBOOK_OAUTH_APP_ACCESS_TOKEN)
+      FGraph.expects(:insights).with(nil, FACEBOOK_OAUTH_APP_ACCESS_TOKEN, {
+        :metric_path => 'application_api_calls/day'
+      })
+      client.insights(:metric_path => 'application_api_calls/day')
+    end
+  end
+end

data/test/fgraph_test.rb

@@ -0,0 +1,236 @@
+require 'test_helper'
+
+class FGraphTest < Test::Unit::TestCase
+  FACEBOOK_API_KEY = '878116c4a4b79f25e4beb97ab096cc92'
+  FACEBOOK_APP_SECRET = '41f0e7ee8b6501dca1610de9926477c4'
+  FACEBOOK_APP_ID = '112157085578818'
+  FACEBOOK_OAUTH_REDIRECT_URI = 'http://www.example.com/oauth_redirect'
+  FACEBOOK_OAUTH_CODE = '2.0eXhebBSDTpoe08qIaocNQ__.3600.1273748400-503153225|caqygNb5Gobz6lpj3HXjlthDxds.'
+  FACEBOOK_OAUTH_ACCESS_TOKEN = "115187085478818|rDIv_5zgjCSM_fWBv5Z-lQr5gFk."
+  FACEBOOK_OAUTH_APP_ACCESS_TOKEN = "112167085478818|rDIv_5zgjCSM_fWBv5Z-lQr5gFk."
+  
+  context "FGraph.object" do
+    should "return object hash" do
+      stub_get('/cocacola', 'object_cocacola.json')
+      object = FGraph.object('cocacola')
+      
+      object.should_not be_nil
+      object['name'].should == 'Coca-Cola'
+    end
+    
+    should "call handle_response" do
+      stub_get('/cocacola', 'object_cocacola.json')
+      FGraph.expects(:handle_response).once
+      object = FGraph.object('cocacola')
+    end
+    
+    should "parse options into get options" do
+      options = {:fields => 'id,name,picture'}
+      FGraph.expects(:perform_get).with('/cocacola', options)
+      FGraph.object('cocacola', options)
+    end
+  end
+  
+  context "FGraph.objects" do
+    should "call perform_get with ids and query options" do
+      options = {:fields => 'id,name'}
+      FGraph.expects(:perform_get).with('/', options.merge(:ids => 'herry,john'))
+      FGraph.objects('herry', 'john', options)
+    end
+  end
+  
+  context "FGraph.me" do
+    access_token = {:access_token => FACEBOOK_OAUTH_ACCESS_TOKEN}
+    
+    should "get object with /me path" do
+      FGraph.expects(:object).with('me', access_token)
+      FGraph.me(access_token)
+    end
+    
+    should "get object with /me/likes path" do
+      FGraph.expects(:object).with('me/likes', access_token)
+      FGraph.me('likes', access_token)
+    end
+  end
+  
+  context "FGraph.oauth_authorize_url" do
+    should "should call format_url with appropriate hash" do
+      FGraph.expects(:format_url).with('/oauth/authorize', {
+        :client_id => FACEBOOK_API_KEY,
+        :redirect_uri => FACEBOOK_OAUTH_REDIRECT_URI
+      })
+      
+      FGraph.oauth_authorize_url(FACEBOOK_API_KEY, FACEBOOK_OAUTH_REDIRECT_URI)
+    end
+    
+    should "should call format_url with options" do
+      FGraph.expects(:format_url).with('/oauth/authorize', {
+        :client_id => FACEBOOK_API_KEY,
+        :redirect_uri => FACEBOOK_OAUTH_REDIRECT_URI,
+        :scope => 'user_photos'
+      })
+      
+      FGraph.oauth_authorize_url(FACEBOOK_API_KEY, FACEBOOK_OAUTH_REDIRECT_URI,
+        :scope => 'user_photos')
+    end
+  end
+  
+  context "FGraph.oauth_access_token" do
+    should "return user access token and expires" do
+      stub_get(FGraph.format_url('/oauth/access_token', {
+        :client_id => FACEBOOK_API_KEY,
+        :client_secret => FACEBOOK_APP_SECRET,
+        :redirect_uri => FACEBOOK_OAUTH_REDIRECT_URI,
+        :code => FACEBOOK_OAUTH_CODE
+      }), 'access_token.txt')
+      
+      token = FGraph.oauth_access_token(FACEBOOK_API_KEY, FACEBOOK_APP_SECRET, 
+        :redirect_uri => FACEBOOK_OAUTH_REDIRECT_URI, 
+        :code => FACEBOOK_OAUTH_CODE)
+      
+      token['access_token'].should == 'thisisanaccesstoken'
+      token['expires'].should == '4000'
+    end
+  end
+  
+  context "FGraph.publish" do
+    options = { :message => 'test message'}
+      
+    should "call perform_post" do
+      FGraph.expects(:perform_post).with("/me/feed", options)
+      FGraph.publish('me/feed', options)
+    end
+    
+    should "have publish_[category] method" do
+      FGraph.expects(:publish).with('me/feed', options)
+      FGraph.publish_feed('me', options)
+    end
+  end
+  
+  context "FGraph.delete" do
+    options = {}
+
+    should "call perform_delete" do
+      FGraph.expects(:perform_delete).with('/12345', options)
+      FGraph.remove('12345', options)
+    end
+    
+    should "support remove_[category] method" do
+      FGraph.expects(:remove).with('12345/likes', options)
+      FGraph.remove_likes('12345', options)
+    end
+  end
+  
+  context "FGraph.search" do
+    should "call perform_get('/search')" do
+      FGraph.expects(:perform_get).with('/search', {
+        :q => 'watermelon',
+        :type => 'post'
+      })
+      
+      FGraph.search('watermelon', :type => 'post')
+    end
+    
+    should "support dynamic method search_[type] method" do
+      FGraph.expects(:search).with('watermelon', {
+        :type => 'post'
+      })
+      
+      FGraph.search_post('watermelon')
+    end
+  end
+  
+  context "Facebook.insights" do
+    should "call perform_get('/[app_id]/insights')" do
+      FGraph.expects(:perform_get).with("/#{FACEBOOK_APP_ID}/insights", {
+        :access_token => FACEBOOK_OAUTH_APP_ACCESS_TOKEN
+      })
+      
+      FGraph.insights(FACEBOOK_APP_ID, FACEBOOK_OAUTH_APP_ACCESS_TOKEN)
+    end
+    
+    should "process :metric_path option" do
+      FGraph.expects(:perform_get).with("/#{FACEBOOK_APP_ID}/insights/application_api_call/day", {
+        :access_token => FACEBOOK_OAUTH_APP_ACCESS_TOKEN
+      })
+      
+      FGraph.insights(FACEBOOK_APP_ID, FACEBOOK_OAUTH_APP_ACCESS_TOKEN, {
+        :metric_path => 'application_api_call/day'
+      })
+    end
+  end
+  
+  context "FGraph.method_missing" do
+    options = options = {:filter => 'id,name,picture'}
+    
+    should "auto map object_[category] method" do
+      FGraph.expects(:object).with('arun/photos', options)
+      FGraph.object_photos('arun', options)
+    end
+    
+    should "auto map me_[category] method" do
+      FGraph.expects(:me).with('photos', options)
+      FGraph.me_photos(options)
+    end
+    
+    should "raise no method error if missing method name does not start with object_ or me_" do
+      lambda do
+        FGraph.xyz_photos
+      end.should raise_error(NoMethodError)
+    end
+  end
+  
+  context "FGraph.format_url" do
+    should "return URL without query string" do
+      formatted_url = FGraph.format_url('/test')
+      formatted_url.should == "https://graph.facebook.com/test"
+    end
+    
+    should "return URL with query string with escaped value" do
+      formatted_url = FGraph.format_url('/test',  {:username => 'john lim'})
+      formatted_url.should == "https://graph.facebook.com/test?username=john+lim"
+    end
+
+    should "return URL with multiple options" do
+      formatted_url = FGraph.format_url('/test', {:username => 'john', :age => 20})
+      formatted_url.should =~ /username=john/
+      formatted_url.should =~ /age=20/
+      formatted_url.should =~ /&/
+    end
+
+    should "return URL without empty options" do
+      formatted_url = FGraph.format_url('/test', {:username => 'john', :age => nil})
+      formatted_url.should == "https://graph.facebook.com/test?username=john"
+    end
+  end
+  
+  context "FGraph.handle_response" do
+    should "raise QueryParseError" do
+      lambda do
+        object = FGraph.handle_response(response_error('QueryParseException'))
+      end.should raise_error(FGraph::QueryParseError)
+    end
+    
+    should "raise GraphMethodError" do
+      lambda do
+        object = FGraph.handle_response(response_error('GraphMethodException'))
+      end.should raise_error(FGraph::GraphMethodError)
+    end
+    
+    should "raise OAuthError" do
+      lambda do
+        object = FGraph.handle_response(response_error('OAuthException'))
+      end.should raise_error(FGraph::OAuthError)
+    end
+    
+    should "raise OAuthAccessTokenError" do
+      lambda do
+        object = FGraph.handle_response(response_error('OAuthAccessTokenException'))
+      end.should raise_error(FGraph::OAuthAccessTokenError)
+    end
+  end
+  
+  def response_error(type, msg=nil)
+    {'error' => { 'type' => type, 'message' => msg}}
+  end
+end

data/test/fixtures/access_token.txt

@@ -0,0 +1 @@
+access_token=thisisanaccesstoken&expires=4000

data/test/fixtures/object_cocacola.json

@@ -0,0 +1,10 @@
+{
+   "id": "40796308305",
+   "name": "Coca-Cola",
+   "picture": "http://profile.ak.fbcdn.net/object3/1853/100/s40796308305_2334.jpg",
+   "link": "http://www.facebook.com/coca-cola",
+   "category": "Consumer_products",
+   "username": "coca-cola",
+   "products": "Coca-Cola is the most popular and biggest-selling soft drink in history, as well as the best-known product in the world.\n\nCreated in Atlanta, Georgia, by Dr. John S. Pemberton, Coca-Cola was first offered as a fountain beverage by mixing Coca-Cola syrup with carbonated water. Coca-Cola was introduced in 1886, patented in 1887, registered as a trademark in 1893 and by 1895 it was being sold in every state and territory in the United States. In 1899, The Coca-Cola Company began franchised bottling operations in the United States.\n\nCoca-Cola might owe its origins to the United States, but its popularity has made it truly universal. Today, you can find Coca-Cola in virtually every part of the world.",
+   "fan_count": 5445797
+}

data/test/test_helper.rb

@@ -0,0 +1,34 @@
+require 'test/unit'
+require 'shoulda'
+require 'matchy'
+require 'mocha'
+require 'fakeweb'
+require 'pp'
+
+# FakeWeb.allow_net_connect = true
+# FakeWeb.allow_net_connect = false
+
+require File.dirname(__FILE__) + '/../lib/fgraph'
+
+def stub_get(url, filename, status=nil)
+  options = {:body => read_fixture(filename)}
+  options.merge!({:status => status}) unless status.nil?
+  FakeWeb.register_uri(:get, graph_url(url), options)
+end
+
+def stub_post(url, filename)
+  FakeWeb.register_uri(:post, graph_url(url), :body => read_fixture(filename))
+end
+
+def stub_put(url, filename)
+  FakeWeb.register_uri(:put, graph_url(url), :body => read_fixture(filename))
+end
+
+def read_fixture(filename)
+  return "" if filename == ""
+  File.read(File.dirname(__FILE__) + "/fixtures/" + filename)
+end
+
+def graph_url(url)
+  url =~ /^http/ ? url : "http://graph.facebook.com#{url}"
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification 
+name: fgraph
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Herryanto Siatono
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-20 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 5
+        - 0
+        version: 0.5.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 10
+        - 0
+        version: 2.10.0
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: jnunemaker-matchy
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 4
+        - 0
+        version: 0.4.0
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 9
+        - 0
+        version: 0.9.0
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 0
+        version: 1.2.0
+  type: :development
+  version_requirements: *id005
+description: Ruby Facebook Graph API
+email: herryanto@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- History
+- License
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- examples/get_access_token.rb
+- examples/publish_feed.rb
+- lib/fgraph.rb
+- lib/fgraph/client.rb
+- test/fgraph/client_test.rb
+- test/fgraph_test.rb
+- test/fixtures/access_token.txt
+- test/fixtures/object_cocacola.json
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/jugend/fgraph
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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 Facebook Graph API
+test_files: 
+- test/fgraph/client_test.rb
+- test/fgraph_test.rb
+- test/test_helper.rb
+- examples/get_access_token.rb
+- examples/publish_feed.rb