joelind-koala 0.8.1

data/CHANGELOG

@@ -0,0 +1,88 @@
+v0.8.0
+-- Breaking interface changes
+  -- Removed string overloading for the methods, per 0.7.3, which caused Marshaling issues
+  -- Removed ability to provide a string as the second argument to url_for_access_token, per 0.5.0
+
+v0.7.4 
+-- Fixed bug with get_user_from_cookies
+
+v0.7.3
+-- Added support for picture sizes -- thanks thhermansen for the patch!
+-- Adjusted the return values for several methods (get_access_token, get_app_access_token, get_token_from_session_key, get_tokens_from_session_keys, get_user_from_cookies)
+  -- These methods now return strings, rather than hashes, which makes more sense
+  -- The strings are overloaded with an [] method for backwards compatibility (Ruby is truly amazing)
+    -- Using those methods triggers a deprecation warning
+    -- This will be removed by 1.0
+  -- There are new info methods (get_access_token_info, get_app_access_token_info, get_token_info_from_session_keys, and get_user_info_from_cookies) that natively return hashes, for when you want the expiration date
+-- Responses with HTTP status 500+ now properly throw errors under Net::HTTP 
+-- Updated changelog
+-- Added license
+
+v0.7.2
+-- Added support for exchanging session keys for OAuth access tokens (get_token_from_session_key for single keys, get_tokens_from_session_keys for multiple)
+-- Moved Koala files into a koala/ subdirectory to minimize risk of name collisions
+-- Added OAuth Playground git submodule as an example 
+-- Updated tests, readme, and changelog
+
+v0.7.1
+-- Updated RealtimeUpdates#list_subscriptions and GraphAPI#get_connections to now return an 
+array of results directly (rather than a hash with one key)
+-- Fixed a bug with Net::HTTP-based HTTP service in which the headers hash was improperly formatted
+-- Updated readme
+
+v0.7.0
+-- Added RealtimeUpdates class, which can be used to manage subscriptions for user updates (see http://developers.facebook.com/docs/api/realtime)
+-- Added picture method to graph API, which fetches an object's picture from the redirect headers.
+-- Added _greatly_ improved testing with result mocking, which is now the default set of tests
+-- Renamed live testing spec to koala_spec_without_mocks.rb
+-- Added Koala::Response class, which encapsulates HTTP results since Facebook sometimes sends data in the status or headers
+-- Much internal refactoring
+-- Updated readme, changelog, etc.
+
+
+v0.6.0
+-- Added support for the old REST API thanks to cbaclig's great work
+-- Updated tests to conform to RSpec standards
+-- Updated changelog, readme, etc.
+
+v0.5.1
+-- Documentation is now on the wiki, updated readme accordingly.
+
+v0.5.0
+-- Added several new OAuth methods for making and parsing access token requests
+-- Added test suite for the OAuth class
+-- Made second argument to url_for_access_token a hash (strings still work but trigger a deprecation warning)
+-- Added fields to facebook_data.yml
+-- Updated readme
+
+v0.4.1
+-- Encapsulated GraphAPI and OAuth classes in the Koala::Facebook module for clarity (and to avoid claiming the global Facebook class)
+-- Moved make_request method to Koala class from GraphAPI instance (for use by future OAuth class functionality)
+-- Renamed request method to api for consistancy with Javascript library
+-- Updated tests and readme
+
+v0.4.0
+-- Adopted the Koala name
+-- Updated readme and tests
+-- Fixed cookie verification bug for non-expiring OAuth tokens
+
+v0.3.1
+-- Bug fixes.
+
+v0.3
+-- Renamed Graph API class from Facebook::GraphAPI to FacebookGraph::API
+-- Created FacebookGraph::OAuth class for tokens and OAuth URLs
+-- Updated method for including HTTP service (think we've got it this time) 
+-- Updated tests
+-- Added CHANGELOG and gemspec
+
+v0.2
+-- Gemified the project
+-- Split out HTTP services into their own file, and adjusted inclusion method
+
+v0.1
+-- Added modular support for Typhoeus
+-- Added tests
+
+v0.0
+-- Hi from F8!  Basic read/write from the graph is working

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2010 Alex Koppel
+
+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/Manifest

@@ -0,0 +1,29 @@
+CHANGELOG
+LICENSE
+Manifest
+Rakefile
+init.rb
+koala.gemspec
+lib/koala.rb
+lib/koala/graph_api.rb
+lib/koala/http_services.rb
+lib/koala/realtime_updates.rb
+lib/koala/rest_api.rb
+readme.md
+spec/facebook_data.yml
+spec/koala/api_base_tests.rb
+spec/koala/graph_and_rest_api/graph_and_rest_api_no_token_tests.rb
+spec/koala/graph_and_rest_api/graph_and_rest_api_with_token_tests.rb
+spec/koala/graph_api/graph_api_no_access_token_tests.rb
+spec/koala/graph_api/graph_api_with_access_token_tests.rb
+spec/koala/live_testing_data_helper.rb
+spec/koala/net_http_service_tests.rb
+spec/koala/oauth/oauth_tests.rb
+spec/koala/realtime_updates/realtime_updates_tests.rb
+spec/koala/rest_api/rest_api_no_access_token_tests.rb
+spec/koala/rest_api/rest_api_with_access_token_tests.rb
+spec/koala_spec.rb
+spec/koala_spec_helper.rb
+spec/koala_spec_without_mocks.rb
+spec/mock_facebook_responses.yml
+spec/mock_http_service.rb

data/Rakefile

@@ -0,0 +1,17 @@
+# Rakefile
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+# gem management
+Echoe.new('joelind-koala', '0.8.1') do |p|
+  p.summary    = "A lightweight, flexible library for Facebook with support for the Graph API, the old REST API, realtime updates, and OAuth validation."
+  p.description = "Koala is a lightweight, flexible Ruby SDK for Facebook.  It allows read/write access to the social graph via the Graph API and the older REST API, as well as support for realtime updates and OAuth and Facebook Connect authentication.  Koala is fully tested and supports Net::HTTP and Typhoeus connections out of the box and can accept custom modules for other services. Build of 0.8.1 for testing compatibility."
+  p.url            = "http://github.com/joelind/koala"
+  p.author         = ["Alex Koppel", "Chris Baclig", "Rafi Jacoby", "Context Optional", "Joe Lind"]
+  p.email          = "joelind@gmail.com"
+  p.ignore_pattern = ["tmp/*", "script/*", "pkg/*"]
+  p.development_dependencies = []
+  p.retain_gemspec = true
+  p.project        = "joelind-koala"
+end

data/init.rb

@@ -0,0 +1,2 @@
+# init.rb
+require 'koala'

data/joelind-koala.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{joelind-koala}
+  s.version = "0.8.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Alex Koppel, Chris Baclig, Rafi Jacoby, Context Optional, Joe Lind"]
+  s.date = %q{2010-08-15}
+  s.description = %q{Koala is a lightweight, flexible Ruby SDK for Facebook.  It allows read/write access to the social graph via the Graph API and the older REST API, as well as support for realtime updates and OAuth and Facebook Connect authentication.  Koala is fully tested and supports Net::HTTP and Typhoeus connections out of the box and can accept custom modules for other services. Build of 0.8.1 for testing compatibility.}
+  s.email = %q{joelind@gmail.com}
+  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "lib/koala.rb", "lib/koala/graph_api.rb", "lib/koala/http_services.rb", "lib/koala/realtime_updates.rb", "lib/koala/rest_api.rb"]
+  s.files = ["CHANGELOG", "LICENSE", "Manifest", "Rakefile", "init.rb", "koala.gemspec", "lib/koala.rb", "lib/koala/graph_api.rb", "lib/koala/http_services.rb", "lib/koala/realtime_updates.rb", "lib/koala/rest_api.rb", "readme.md", "spec/facebook_data.yml", "spec/koala/api_base_tests.rb", "spec/koala/graph_and_rest_api/graph_and_rest_api_no_token_tests.rb", "spec/koala/graph_and_rest_api/graph_and_rest_api_with_token_tests.rb", "spec/koala/graph_api/graph_api_no_access_token_tests.rb", "spec/koala/graph_api/graph_api_with_access_token_tests.rb", "spec/koala/live_testing_data_helper.rb", "spec/koala/net_http_service_tests.rb", "spec/koala/oauth/oauth_tests.rb", "spec/koala/realtime_updates/realtime_updates_tests.rb", "spec/koala/rest_api/rest_api_no_access_token_tests.rb", "spec/koala/rest_api/rest_api_with_access_token_tests.rb", "spec/koala_spec.rb", "spec/koala_spec_helper.rb", "spec/koala_spec_without_mocks.rb", "spec/mock_facebook_responses.yml", "spec/mock_http_service.rb", "joelind-koala.gemspec"]
+  s.homepage = %q{http://github.com/joelind/koala}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Joelind-koala", "--main", "readme.md"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{joelind-koala}
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{A lightweight, flexible library for Facebook with support for the Graph API, the old REST API, realtime updates, and OAuth validation.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/koala.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{koala}
+  s.version = "0.8.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Alex Koppel, Chris Baclig, Rafi Jacoby, Context Optional, Joe Lind"]
+  s.date = %q{2010-08-15}
+  s.description = %q{Koala is a lightweight, flexible Ruby SDK for Facebook.  It allows read/write access to the social graph via the Graph API and the older REST API, as well as support for realtime updates and OAuth and Facebook Connect authentication.  Koala is fully tested and supports Net::HTTP and Typhoeus connections out of the box and can accept custom modules for other services. Build of 0.8.1 for testing compatibility.}
+  s.email = %q{joelind@gmail.com}
+  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "lib/koala.rb", "lib/koala/graph_api.rb", "lib/koala/http_services.rb", "lib/koala/realtime_updates.rb", "lib/koala/rest_api.rb"]
+  s.files = ["CHANGELOG", "LICENSE", "Manifest", "Rakefile", "init.rb", "koala.gemspec", "lib/koala.rb", "lib/koala/graph_api.rb", "lib/koala/http_services.rb", "lib/koala/realtime_updates.rb", "lib/koala/rest_api.rb", "readme.md", "spec/facebook_data.yml", "spec/koala/api_base_tests.rb", "spec/koala/graph_and_rest_api/graph_and_rest_api_no_token_tests.rb", "spec/koala/graph_and_rest_api/graph_and_rest_api_with_token_tests.rb", "spec/koala/graph_api/graph_api_no_access_token_tests.rb", "spec/koala/graph_api/graph_api_with_access_token_tests.rb", "spec/koala/live_testing_data_helper.rb", "spec/koala/net_http_service_tests.rb", "spec/koala/oauth/oauth_tests.rb", "spec/koala/realtime_updates/realtime_updates_tests.rb", "spec/koala/rest_api/rest_api_no_access_token_tests.rb", "spec/koala/rest_api/rest_api_with_access_token_tests.rb", "spec/koala_spec.rb", "spec/koala_spec_helper.rb", "spec/koala_spec_without_mocks.rb", "spec/mock_facebook_responses.yml", "spec/mock_http_service.rb"]
+  s.homepage = %q{http://github.com/joelind/koala}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Koala", "--main", "readme.md"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{joelind-koala}
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{A lightweight, flexible library for Facebook with support for the Graph API, the old REST API, realtime updates, and OAuth validation.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/koala/graph_api.rb

@@ -0,0 +1,131 @@
+module Koala
+  module Facebook
+    GRAPH_SERVER = "graph.facebook.com"
+
+    module GraphAPIMethods
+      # A client for the Facebook Graph API.
+      # 
+      # See http://developers.facebook.com/docs/api for complete documentation
+      # for the API.
+      # 
+      # The Graph API is made up of the objects in Facebook (e.g., people, pages,
+      # events, photos) and the connections between them (e.g., friends,
+      # photo tags, and event RSVPs). This client provides access to those
+      # primitive types in a generic way. For example, given an OAuth access
+      # token, this will fetch the profile of the active user and the list
+      # of the user's friends:
+      # 
+      #    graph = Koala::Facebook::GraphAPI.new(access_token)
+      #    user = graph.get_object("me")
+      #    friends = graph.get_connections(user["id"], "friends")
+      # 
+      # You can see a list of all of the objects and connections supported
+      # by the API at http://developers.facebook.com/docs/reference/api/.
+      # 
+      # You can obtain an access token via OAuth or by using the Facebook
+      # JavaScript SDK. See http://developers.facebook.com/docs/authentication/
+      # for details.
+      # 
+      # If you are using the JavaScript SDK, you can use the
+      # Koala::Facebook::OAuth.get_user_from_cookie() method below to get the OAuth access token
+      # for the active user from the cookie saved by the SDK.
+            
+      def get_object(id, args = {})
+        # Fetchs the given object from the graph.
+        graph_call(id, args)
+      end
+    
+      def get_objects(ids, args = {})
+        # Fetchs all of the given object from the graph.
+        # We return a map from ID to object. If any of the IDs are invalid,
+        # we raise an exception.
+        graph_call("", args.merge("ids" => ids.join(",")))
+      end
+    
+      def get_connections(id, connection_name, args = {})
+        # Fetchs the connections for given object.
+        graph_call("#{id}/#{connection_name}", args)["data"]
+      end
+    
+      def get_picture(object, args = {})
+        result = graph_call("#{object}/picture", args, "get", :http_component => :headers)
+        result["Location"]
+      end    
+      
+      def put_object(parent_object, connection_name, args = {})
+        # Writes the given object to the graph, connected to the given parent.
+        # 
+        # For example,
+        # 
+        #     graph.put_object("me", "feed", :message => "Hello, world")
+        # 
+        # writes "Hello, world" to the active user's wall. Likewise, this
+        # will comment on a the first post of the active user's feed:
+        # 
+        #     feed = graph.get_connections("me", "feed")
+        #     post = feed["data"][0]
+        #     graph.put_object(post["id"], "comments", :message => "First!")
+        # 
+        # See http://developers.facebook.com/docs/api#publishing for all of
+        # the supported writeable objects.
+        # 
+        # Most write operations require extended permissions. For example,
+        # publishing wall posts requires the "publish_stream" permission. See
+        # http://developers.facebook.com/docs/authentication/ for details about
+        # extended permissions.
+
+        raise APIError.new({"type" => "KoalaMissingAccessToken", "message" => "Write operations require an access token"}) unless @access_token
+        graph_call("#{parent_object}/#{connection_name}", args, "post")
+      end
+    
+      def put_wall_post(message, attachment = {}, profile_id = "me")
+        # Writes a wall post to the given profile's wall.
+        # 
+        # We default to writing to the authenticated user's wall if no
+        # profile_id is specified.
+        # 
+        # attachment adds a structured attachment to the status message being
+        # posted to the Wall. It should be a dictionary of the form:
+        # 
+        #     {"name": "Link name"
+        #      "link": "http://www.example.com/",
+        #      "caption": "{*actor*} posted a new review",
+        #      "description": "This is a longer description of the attachment",
+        #      "picture": "http://www.example.com/thumbnail.jpg"}
+
+        self.put_object(profile_id, "feed", attachment.merge({:message => message}))
+      end
+    
+      def put_comment(object_id, message)
+        # Writes the given comment on the given post.
+        self.put_object(object_id, "comments", {:message => message})
+      end
+    
+      def put_like(object_id)
+        # Likes the given post.
+        self.put_object(object_id, "likes")
+      end
+    
+      def delete_object(id)
+        # Deletes the object with the given ID from the graph.
+        graph_call(id, {}, "delete")
+      end
+    
+      def search(search_terms, args = {})
+        # Searches for a given term
+        graph_call("search", args.merge({:q => search_terms}))
+      end
+    
+      def graph_call(*args)
+        response = api(*args) do |response|
+          # check for Graph API-specific errors
+          if response.is_a?(Hash) && error_details = response["error"]
+            raise APIError.new(error_details)
+          end
+        end
+      
+        response
+      end
+    end
+  end
+end

data/lib/koala/http_services.rb

@@ -0,0 +1,70 @@
+module Koala
+  class Response
+    attr_reader :status, :body, :headers
+    def initialize(status, body, headers)
+      @status = status
+      @body = body
+      @headers = headers
+    end
+  end
+
+  module NetHTTPService
+    # this service uses Net::HTTP to send requests to the graph
+    def self.included(base)
+      base.class_eval do
+        require 'net/http' unless defined?(Net::HTTP)
+        require 'net/https'
+
+        def self.make_request(path, args, verb, options = {})
+          # We translate args to a valid query string. If post is specified,
+          # we send a POST request to the given path with the given arguments.
+
+          # if the verb isn't get or post, send it as a post argument
+          args.merge!({:method => verb}) && verb = "post" if verb != "get" && verb != "post"
+
+          server = options[:rest_api] ? Facebook::REST_SERVER : Facebook::GRAPH_SERVER
+          http = Net::HTTP.new(server, 443)
+          http.use_ssl = true
+          # we turn off certificate validation to avoid the 
+          # "warning: peer certificate won't be verified in this SSL session" warning
+          # not sure if this is the right way to handle it
+          # see http://redcorundum.blogspot.com/2008/03/ssl-certificates-and-nethttps.html
+          http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+          result = http.start { |http|
+            response, body = (verb == "post" ? http.post(path, encode_params(args)) : http.get("#{path}?#{encode_params(args)}"))
+            Koala::Response.new(response.code.to_i, body, response)
+          }
+        end
+
+        protected
+        def self.encode_params(param_hash)
+          # TODO investigating whether a built-in method handles this
+          # if no hash (e.g. no auth token) return empty string
+          ((param_hash || {}).collect do |key_and_value| 
+            key_and_value[1] = key_and_value[1].to_json if key_and_value[1].class != String
+            "#{key_and_value[0].to_s}=#{CGI.escape key_and_value[1]}"
+          end).join("&")
+        end
+      end
+    end
+  end
+
+  module TyphoeusService
+    # this service uses Typhoeus to send requests to the graph
+    def self.included(base)
+      base.class_eval do
+        require 'typhoeus' unless defined?(Typhoeus)
+        include Typhoeus
+
+        def self.make_request(path, args, verb, options = {})
+          # if the verb isn't get or post, send it as a post argument
+          args.merge!({:method => verb}) && verb = "post" if verb != "get" && verb != "post"
+          server = options[:rest_api] ? Facebook::REST_SERVER : Facebook::GRAPH_SERVER
+          response = self.send(verb, "https://#{server}/#{path}", :params => args)
+          Koala::Response.new(response.code, response.body, response.headers_hash)
+        end
+      end # class_eval
+    end
+  end
+end

data/lib/koala/realtime_updates.rb

@@ -0,0 +1,95 @@
+require 'koala'
+
+module Koala
+  module Facebook
+    module RealtimeUpdateMethods
+      # note: to subscribe to real-time updates, you must have an application access token
+      
+      def self.included(base)
+        # make the attributes readable
+        base.class_eval do
+          attr_reader :app_id, :app_access_token, :secret
+          
+          # parses the challenge params and makes sure the call is legitimate
+          # returns the challenge string to be sent back to facebook if true
+          # returns false otherwise
+          # this is a class method, since you don't need to know anything about the app
+          # saves a potential trip fetching the app access token
+          def self.meet_challenge(params, verify_token = nil, &verification_block)
+            if params["hub.mode"] == "subscribe" &&
+                # you can make sure this is legitimate through two ways
+                # if your store the token across the calls, you can pass in the token value
+                # and we'll make sure it matches
+                (verify_token && params["hub.verify_token"] == verify_token) ||        
+                # alternately, if you sent a specially-constructed value (such as a hash of various secret values)
+                # you can pass in a block, which we'll call with the verify_token sent by Facebook
+                # if it's legit, return anything that evaluates to true; otherwise, return nil or false
+                (verification_block && yield(params["hub.verify_token"]))
+              params["hub.challenge"]
+            else
+              false
+            end
+          end
+        end
+      end
+      
+      def initialize(options = {})
+        @app_id = options[:app_id]
+        @app_access_token = options[:app_access_token]
+        @secret = options[:secret]
+        unless @app_id && (@app_access_token || @secret) # make sure we have what we need
+          raise ArgumentError, "Initialize must receive a hash with :app_id and either :app_access_token or :secret! (received #{options.inspect})"
+        end
+        
+        # fetch the access token if we're provided a secret
+        if @secret && !@app_access_token
+          oauth = Koala::Facebook::OAuth.new(@app_id, @secret)
+          @app_access_token = oauth.get_app_access_token
+        end
+      end
+      
+      # subscribes for realtime updates
+      # your callback_url must be set up to handle the verification request or the subscription will not be set up
+      # http://developers.facebook.com/docs/api/realtime
+      def subscribe(object, fields, callback_url, verify_token)
+        args = {
+          :object => object, 
+          :fields => fields,
+          :callback_url => callback_url,
+          :verify_token => verify_token
+        }
+        # a subscription is a success if Facebook returns a 200 (after hitting your server for verification)
+        api(subscription_path, args, 'post', :http_component => :status) == 200
+      end
+          
+      # removes subscription for object
+      # if object is nil, it will remove all subscriptions
+      def unsubscribe(object = nil)
+        args = {}
+        args[:object] = object if object
+        api(subscription_path, args, 'delete', :http_component => :status) == 200
+      end
+  
+      def list_subscriptions
+        api(subscription_path)["data"]
+      end
+      
+      def api(*args) # same as GraphAPI
+        response = super(*args) do |response|
+          # check for subscription errors
+          if response.is_a?(Hash) && error_details = response["error"]
+            raise APIError.new(error_details)
+          end
+        end
+      
+        response
+      end    
+      
+      protected
+      
+      def subscription_path
+        @subscription_path ||= "#{@app_id}/subscriptions"
+      end
+    end
+  end
+end

data/lib/koala/rest_api.rb

@@ -0,0 +1,23 @@
+module Koala
+  module Facebook
+    REST_SERVER = "api.facebook.com"
+    
+    module RestAPIMethods
+      def fql_query(fql)
+        rest_call('fql.query', 'query' => fql)
+      end
+      
+      def rest_call(method, args = {})
+        response = api("method/#{method}", args.merge('format' => 'json'), 'get', :rest_api => true) do |response|
+          # check for REST API-specific errors
+          if response.is_a?(Hash) && response["error_code"]
+            raise APIError.new("type" => response["error_code"], "message" => response["error_msg"])
+          end
+        end
+        
+        response
+      end
+    end
+    
+  end # module Facebook
+end # module Koala