palidanx-koala 0.9.0

data/spec/koala/realtime_updates/realtime_updates_tests.rb

@@ -0,0 +1,187 @@
+class FacebookRealtimeUpdatesTests < Test::Unit::TestCase
+  include Koala
+  
+  describe "Koala RealtimeUpdates" do
+    before :all do
+      # get oauth data
+      @oauth_data = $testing_data["oauth_test_data"]
+      @app_id = @oauth_data["app_id"]
+      @secret = @oauth_data["secret"]
+      @callback_url = @oauth_data["callback_url"]
+      @app_access_token = @oauth_data["app_access_token"]
+      
+      # check OAuth data
+      unless @app_id && @secret && @callback_url && @app_access_token
+        raise Exception, "Must supply OAuth app id, secret, app_access_token, and callback to run live subscription tests!" 
+      end
+      
+      # get subscription data
+      @subscription_data = $testing_data["subscription_test_data"]
+      @verify_token = @subscription_data["verify_token"]
+      @challenge_data = @subscription_data["challenge_data"]
+      @subscription_path = @subscription_data["subscription_path"]
+      
+      # check subscription data
+      unless @verify_token && @challenge_data && @subscription_path
+        raise Exception, "Must supply verify_token and equivalent challenge_data to run live subscription tests!" 
+      end
+    end
+
+    describe "when initializing" do
+      # basic initialization
+      it "should initialize properly with an app_id and an app_access_token" do
+        updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :app_access_token => @app_access_token)
+        updates.should be_a(Facebook::RealtimeUpdates)
+      end
+      
+      # attributes
+      it "should allow read access to app_id, app_access_token, and secret" do
+        updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :app_access_token => @app_access_token)
+        # this should not throw errors
+        updates.app_id && updates.app_access_token && updates.secret
+      end
+      
+      it "should not allow write access to app_id" do
+        updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :app_access_token => @app_access_token)
+        # this should not throw errors
+        lambda { updates.app_id = 2 }.should raise_error(NoMethodError)
+      end
+
+      it "should not allow write access to app_access_token" do
+        updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :app_access_token => @app_access_token)
+        # this should not throw errors
+        lambda { updates.app_access_token = 2 }.should raise_error(NoMethodError)
+      end
+    
+      it "should not allow write access to secret" do
+        updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :app_access_token => @app_access_token)
+        # this should not throw errors
+        lambda { updates.secret = 2 }.should raise_error(NoMethodError)
+      end
+      
+      # init with secret / fetching the token
+      it "should initialize properly with an app_id and a secret" do 
+        updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :secret => @secret)
+        updates.should be_a(Facebook::RealtimeUpdates)      
+      end
+
+      it "should fetch an app_token from Facebook when provided an app_id and a secret" do 
+        updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :secret => @secret)
+        updates.app_access_token.should_not be_nil
+      end
+      
+      it "should use the OAuth class to fetch a token when provided an app_id and a secret" do
+        oauth = Facebook::OAuth.new(@app_id, @secret)
+        token = oauth.get_app_access_token
+        oauth.should_receive(:get_app_access_token).and_return(token)
+        Facebook::OAuth.should_receive(:new).with(@app_id, @secret).and_return(oauth) 
+        updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :secret => @secret)
+      end
+    end
+  
+    describe "when used" do
+      before :each do 
+        @updates = Facebook::RealtimeUpdates.new(:app_id => @app_id, :secret => @secret)
+      end
+      
+      it "should send a subscription request to a valid server" do
+        result = @updates.subscribe("user", "name", @subscription_path, @verify_token)
+        result.should be_true
+      end
+      
+      it "should send a subscription request to a valid server" do
+        result = @updates.subscribe("user", "name", @subscription_path, @verify_token)
+        result.should be_true
+      end
+      
+      it "should send a subscription request to an invalid path on a valid server" do
+        lambda { result = @updates.subscribe("user", "name", @subscription_path + "foo", @verify_token) }.should raise_exception(Koala::Facebook::APIError)
+      end
+      
+      it "should fail to send a subscription request to an invalid server" do
+        lambda { @updates.subscribe("user", "name", "foo", @verify_token) }.should raise_exception(Koala::Facebook::APIError)
+      end
+    
+      it "should unsubscribe a valid individual object successfully" do 
+        @updates.unsubscribe("user").should be_true
+      end
+
+      it "should unsubscribe all subscriptions successfully" do 
+        @updates.unsubscribe.should be_true
+      end
+
+      it "should fail when an invalid object is provided to unsubscribe" do 
+        lambda { @updates.unsubscribe("kittens") }.should raise_error(Koala::Facebook::APIError)
+      end
+      
+      it "should is subscriptions properly" do
+        @updates.list_subscriptions.should be_a(Array)
+      end
+    end # describe "when used"
+    
+    describe "when meeting challenge" do
+      it "should return false if hub.mode isn't subscribe" do
+        params = {'hub.mode' => 'not subscribe'}
+        Facebook::RealtimeUpdates.meet_challenge(params).should be_false
+      end
+      
+      it "should return false if not given a verify_token or block" do
+        params = {'hub.mode' => 'subscribe'}
+        Facebook::RealtimeUpdates.meet_challenge(params).should be_false
+      end
+      
+      describe "and mode is 'subscribe'" do
+        before(:each) do 
+          @params = {'hub.mode' => 'subscribe'}
+        end
+        
+        describe "and a token is given" do
+          before(:each) do
+            @token = 'token'
+            @params['hub.verify_token'] = @token
+          end
+          
+          it "should return false if the given verify token doesn't match" do
+            Facebook::RealtimeUpdates.meet_challenge(@params, @token + '1').should be_false
+          end
+          
+          it "should return the challenge if the given verify token matches" do
+            @params['hub.challenge'] = 'challenge val'
+            Facebook::RealtimeUpdates.meet_challenge(@params, @token).should == @params['hub.challenge']
+          end
+        end
+        
+        describe "and a block is given" do
+          it "should give the block the token as a parameter" do
+            Facebook::RealtimeUpdates.meet_challenge(@params)do |token|
+              token.should == @token
+            end
+          end
+          
+          it "should return false if the given block return false" do
+            Facebook::RealtimeUpdates.meet_challenge(@params)do |token|
+              false
+            end.should be_false
+          end
+          
+          it "should return false if the given block returns nil" do
+            Facebook::RealtimeUpdates.meet_challenge(@params)do |token|
+              nil
+            end.should be_false
+          end
+          
+          it "should return the challenge if the given block returns true" do
+            @params['hub.challenge'] = 'challenge val'
+            Facebook::RealtimeUpdates.meet_challenge(@params) do |token|
+              true
+            end.should be_true
+          end
+        end
+      
+      end # describe "and mode is subscribe"
+      
+    end # describe "when meeting challenge"
+    
+  end # describe
+
+end #class

data/spec/koala/rest_api/rest_api_no_access_token_tests.rb

@@ -0,0 +1,94 @@
+shared_examples_for "Koala RestAPI without an access token" do
+  # REST_CALL
+  describe "when making a rest request" do
+    it "should use the proper path" do
+      method = stub('methodName')
+      @api.should_receive(:api).with(
+        "method/#{method}",
+        anything,
+        anything,
+        anything
+      )
+      
+      @api.rest_call(method)  
+    end
+    
+    it "should always use the rest api" do
+      @api.should_receive(:api).with(
+        anything,
+        anything,
+        anything,
+        :rest_api => true
+      )  
+      
+      @api.rest_call('anything')
+    end
+    
+    it "should take an optional hash of arguments" do
+      args = {:arg1 => 'arg1'}
+      
+      @api.should_receive(:api).with(
+        anything,
+        hash_including(args),
+        anything,
+        anything
+      )
+      
+      @api.rest_call('anything', args)
+    end
+    
+    it "should always ask for JSON" do
+      @api.should_receive(:api).with(
+        anything,
+        hash_including('format' => 'json'),
+        anything,
+        anything
+      )
+      
+      @api.rest_call('anything')
+    end
+  end 
+
+  # FQL_QUERY
+  describe "when making a FQL request" do
+    it "should call fql.query method" do
+      @api.should_receive(:rest_call).with(
+        "fql.query", 
+        anything
+      ).and_return(Koala::Response.new(200, "2", {}))
+      
+      @api.fql_query stub('query string')
+    end
+    
+    it "should pass a query argument" do
+      query = stub('query string')
+      
+      @api.should_receive(:rest_call).with(
+        anything,
+        hash_including("query" => query)
+      )
+      
+      @api.fql_query(query)
+    end
+  
+    it "should be able to access public information via FQL" do
+      @result = @api.fql_query("select first_name from user where uid = 216743")
+      @result.size.should == 1
+      @result.first["first_name"].should == "Chris"
+    end
+    
+    it "should not be able to access protected information via FQL" do
+      lambda { @api.fql_query("select read_stream from permissions where uid = 216743") }.should raise_error(Koala::Facebook::APIError)
+    end
+  end
+end
+
+class FacebookRestAPINoAccessTokenTest < Test::Unit::TestCase
+  before :each do
+    @api = Koala::Facebook::RestAPI.new
+  end
+  
+  describe "Koala RestAPI without an access token" do
+    it_should_behave_like "Koala RestAPI without an access token" 
+  end
+end

data/spec/koala/rest_api/rest_api_with_access_token_tests.rb

@@ -0,0 +1,36 @@
+shared_examples_for "Koala RestAPI with an access token" do
+  # FQL
+  it "should be able to access public information via FQL" do
+    result = @api.fql_query('select first_name from user where uid = 216743')
+    result.size.should == 1
+    result.first['first_name'].should == 'Chris'
+  end
+
+  it "should be able to access protected information via FQL" do
+    # Tests agains the permissions fql table
+    
+    # get the current user's ID
+    # we're sneakily using the Graph API, which should be okay since it has its own tests
+    g = Koala::Facebook::GraphAPI.new(@token)
+    id = g.get_object("me", :fields => "id")["id"]
+
+    # now send a query about your permissions
+    result = @api.fql_query("select read_stream from permissions where uid = #{id}")
+
+    result.size.should == 1
+    # we assume that you have read_stream permissions, so we can test against that
+    # (should we keep this?)
+    result.first["read_stream"].should == 1
+  end
+end
+
+class FacebookRestAPIWithAccessTokenTests < Test::Unit::TestCase
+  describe "Koala RestAPI with an access token" do
+    it_should_behave_like "live testing examples"
+    it_should_behave_like "Koala RestAPI with an access token"
+    
+    before :each do
+      @api = Koala::Facebook::RestAPI.new(@token)
+    end
+  end
+end

data/spec/koala_spec.rb

@@ -0,0 +1,18 @@
+require 'koala_spec_helper'
+require 'mock_http_service'
+
+# Runs Koala specs using stubs for HTTP requests
+#
+# Valid OAuth token and code are not necessary to run these
+# specs.  Because of this, specs do not fail due to Facebook
+# imposed rate-limits or server timeouts. 
+# 
+# However as a result they are more brittle since
+# we are not testing the latest responses from the Facebook servers.
+# Therefore, to be certain all specs pass with the current 
+# Facebook services, run koala_spec_without_mocks.rb.
+
+
+Koala.http_service = Koala::MockHTTPService
+
+$testing_data = Koala::MockHTTPService::TEST_DATA

data/spec/koala_spec_helper.rb

@@ -0,0 +1,31 @@
+require 'test/unit'
+require 'rubygems'
+require 'spec/test/unit'
+
+# load the libraries
+require 'koala'
+
+# load testing data libraries
+require 'koala/live_testing_data_helper'
+
+# API tests
+require 'koala/api_base_tests'
+
+require 'koala/graph_api/graph_collection_tests'
+require 'koala/graph_api/graph_api_no_access_token_tests'
+require 'koala/graph_api/graph_api_with_access_token_tests'
+
+require 'koala/rest_api/rest_api_no_access_token_tests'
+require 'koala/rest_api/rest_api_with_access_token_tests'
+
+require 'koala/graph_and_rest_api/graph_and_rest_api_no_token_tests'
+require 'koala/graph_and_rest_api/graph_and_rest_api_with_token_tests'
+
+# OAuth tests
+require 'koala/oauth/oauth_tests'
+
+# Subscriptions tests
+require 'koala/realtime_updates/realtime_updates_tests'
+
+# Services tests
+require 'koala/net_http_service_tests'

data/spec/koala_spec_without_mocks.rb

@@ -0,0 +1,19 @@
+require 'koala_spec_helper'
+
+# Runs Koala specs through the Facebook servers
+#
+# Note that you need a valid OAuth token and code for these
+# specs to run.  See facebook_data.yml for more information.
+
+# load testing data (see note in readme.md)
+# I'm seeing a bug with spec and gets where the facebook_test_suite.rb file gets read in when gets is called
+# until that's solved, we'll need to store/update tokens in the access_token file
+$testing_data = YAML.load_file(File.join(File.dirname(__FILE__), 'facebook_data.yml')) rescue {}
+
+unless $testing_data["oauth_token"]
+  puts "Access token tests will fail until you store a valid token in facebook_data.yml"
+end
+
+unless $testing_data["oauth_test_data"] && $testing_data["oauth_test_data"]["code"] && $testing_data["oauth_test_data"]["secret"]
+  puts "Cookie tests will fail until you store valid data for the cookie hash, app_id, and app secret in facebook_data.yml"
+end

data/spec/mock_facebook_responses.yml

@@ -0,0 +1,241 @@
+# Responses by MockHTTPService are taken directly from 
+# this file.
+# 
+# Structure
+# ----------
+#
+# path:
+#   arguments:    # sorted by key
+#     method:     # HTTP method (GET, POST, DELETE, etc.)
+#       with_token:
+#       no_token:
+
+# ====== REST API ===== 
+rest_api:
+
+# -- Stubbed Responses --
+  /method/fql.query:
+    query=select first_name from user where uid = 216743:
+      get: 
+        no_token: '[{"first_name":"Chris"}]'
+        with_token: '[{"first_name":"Chris"}]'
+    query=select read_stream from permissions where uid = 216743:
+      get:
+        with_token: '[{"read_stream":1}]' 
+        no_token: '{"error_code":104,"error_msg":"Requires valid signature","request_args":[{"key":"method","value":"fql.query"},{"key":"format","value":"json"},{"key":"query","value":"select read_stream from permissions where uid = 216743"}]}'
+
+
+# ====== GRAPH API =====
+graph_api:
+
+# -- Common Responses --
+
+  # Error responses for when a token is required, but not given
+  token_required_responses: &token_required
+    no_token: '{"error":{"type":"OAuthAccessTokenException", "message":"An access token is required to request this resource."}}'
+  
+  # Common mock item responses
+  item_deleted: &item_deleted
+    delete:
+      with_token: 'true'
+
+  # OAuth error response
+  oauth_error: &oauth_error
+    no_token: '{"error": {"type": "OAuthException", "message": "Error validating verification code."}}'
+
+  # Subscription error response
+  verification_error: &verification_error
+    with_token: '{"error": {"type": "OAuthException", "message": "Error validating verification code."}}'
+      
+# -- Stubbed Responses --
+  root:
+    ids=contextoptional,naitik: 
+      get:
+        with_token: '[{}, {}]'
+        no_token: '[{}, {}]'
+  /me:
+    no_args:
+      get:
+        <<: *token_required
+        with_token: '{"updated_time": 1}'
+    fields=id:
+      get: 
+        with_token: '{"id": "216743"}'
+        
+  /me/feed:
+    message=Hello, world, from the test suite!: 
+      post: 
+        with_token: '{"id": "MOCK_FEED_ITEM"}'
+    message=Hello, world, from the test suite, testing comments!:
+      post:
+        with_token: '{"id": "MOCK_FEED_ITEM"}'
+    message=the cats are asleep: 
+      post: 
+        with_token: '{"id": "FEED_ITEM_CATS"}'
+    message=Hello, world, from the test suite delete method!: 
+      post: 
+        with_token: '{"id": "FEED_ITEM_DELETE"}'
+    link=http://www.contextoptional.com/&message=Hello, world, from the test suite again!&name=Context Optional:
+      post:
+        with_token: '{"id": "FEED_ITEM_CONTEXT"}'
+        
+  /koppel:
+    no_args:
+      get:
+        with_token: '{"id": 1, "name": 1, "updated_time": 1}'
+        no_token: '{"id": 1, "name": 1}'
+                
+  /contextoptional:
+    no_args:
+      get:
+        with_token: '{"id": 1, "name": 1}'
+        no_token: '{"id": 1, "name": 1}'
+        
+  /contextoptional/photos: 
+    no_args: 
+      get: 
+        with_token: '{"data": [{}], "paging": {"previous": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000", "next": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000"}}'
+        no_token: '{"data": [{}], "paging": {"previous": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000", "next": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000"}}'
+    
+  /lukeshepard/likes: 
+    no_args: 
+      get: 
+        <<: *token_required
+        with_token: '{"data": [{}]}'
+        
+  /chris.baclig/picture:
+    no_args:
+      get:
+        no_token:
+          code: 302
+          headers:
+            Location: http://facebook.com/
+        with_token:
+          code: 302
+          headers:
+            Location: http://facebook.com/
+    type=large:
+      get:
+        no_token:
+          code: 302
+          headers:
+            Location: http://facebook.com/large
+        with_token:
+          code: 302
+          headers:
+            Location: http://facebook.com/large
+
+
+  /search:
+    q=facebook:
+      get: 
+        with_token: '{"data": [{"id": "507731521_100412693339488"}], "paging": {"previous": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000", "next": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000"}}'
+        no_token: '{"data": [{"id": "507731521_100412693339488"}], "paging": {"previous": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000", "next": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000"}}'
+    "limit=25&q=facebook&until=2010-09-23T21:17:33+0000":
+      get: 
+        with_token: '{"data": [{"id": "507731521_100412693339488"}], "paging": {"previous": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000", "next": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000"}}'
+        no_token: '{"data": [{"id": "507731521_100412693339488"}], "paging": {"previous": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000", "next": "https:\/\/graph.facebook.com\/7204941866\/photos?limit=25&until=2008-09-15T18%3A30%3A25%2B0000"}}'
+      
+  '/115349521819193_113815981982767':
+    no_args:
+      delete:
+        <<: *token_required
+  
+  # -- OAuth responses --
+  /oauth/access_token: 
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&code=<%= OAUTH_CODE %>&redirect_uri=<%= OAUTH_DATA["callback_url"] %>:
+      get:
+        no_token: access_token=<%= ACCESS_TOKEN %>
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&code=foo&redirect_uri=<%= OAUTH_DATA["callback_url"] %>: 
+      get: 
+        <<: *oauth_error
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&type=client_cred:
+      post:
+        no_token: access_token=<%= ACCESS_TOKEN %>
+  /oauth/exchange_sessions:
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&sessions=<%= OAUTH_DATA["session_key"] %>&type=client_cred: 
+      post:
+        no_token: '[{"access_token":"<%= ACCESS_TOKEN %>","expires":4315}]'
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&sessions=<%= OAUTH_DATA["multiple_session_keys"].join(",") %>&type=client_cred: 
+      post:
+        no_token: '[{"access_token":"<%= ACCESS_TOKEN %>","expires":4315}, {"access_token":"<%= ACCESS_TOKEN %>","expires":4315}]'
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&sessions=<%= ["foo"].concat(OAUTH_DATA["multiple_session_keys"]).join(",") %>&type=client_cred: 
+      post:
+        no_token: '[null, {"access_token":"<%= ACCESS_TOKEN %>","expires":4315}, {"access_token":"<%= ACCESS_TOKEN %>","expires":4315}]'
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&sessions=foo,bar&type=client_cred: 
+      post:
+        no_token: '[null, null]'
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&sessions=foo&type=client_cred: 
+      post:
+        no_token: '[null]'
+
+
+
+# -- Subscription Responses -- 
+  /<%= APP_ID %>/subscriptions:
+    callback_url=<%= SUBSCRIPTION_DATA["subscription_path"] %>&fields=name&object=user&verify_token=<%= SUBSCRIPTION_DATA["verify_token"] %>:
+      post: 
+        with_token:
+          code: 200
+    callback_url=<%= SUBSCRIPTION_DATA["subscription_path"] %>foo&fields=name&object=user&verify_token=<%= SUBSCRIPTION_DATA["verify_token"] %>:
+      post: 
+        with_token: '{"error":{"type":"Exception","message":"(#2200) subscription validation failed"}}'
+    callback_url=foo&fields=name&object=user&verify_token=<%= SUBSCRIPTION_DATA["verify_token"] %>:
+      post: 
+        with_token: '{"error":{"type":"Exception","message":"(#100) callback_url URL is not properly formatted"}}'
+    object=user:
+      delete:
+        with_token:
+          code: 200
+    object=kittens:
+      delete:
+        with_token: '{"error":{"type":"Exception","message":"(#100) Invalid parameter"}}'
+    no_args:
+      delete: 
+        with_token:
+          code: 200
+      get:
+        with_token: '{"data":[{"callback_url":"http://oauth.twoalex.com/subscriptions", "fields":["name"], "object":"user", "active":true}]}'
+
+
+    callback_url=<%= SUBSCRIPTION_DATA["subscription_path"] %>:
+      get:
+        with_token: '{"data":[{"callback_url":"http://oauth.twoalex.com/subscriptions", "fields":["name"], "object":"user", "active":true}]}'
+
+# -- Mock Item Responses --
+
+  /MOCK_FEED_ITEM/likes:
+    no_args:
+      post:
+        with_token: '{"id": "MOCK_LIKE"}'
+        
+  /MOCK_FEED_ITEM/comments:
+    message=it's my comment!:
+      post:
+        with_token: '{"id": "MOCK_COMMENT"}'
+  
+  /MOCK_FEED_ITEM:
+    no_args:
+      <<: *item_deleted
+  
+  /FEED_ITEM_CONTEXT:
+    no_args: 
+      <<: *item_deleted
+      get:
+        with_token: '{"link":"http://www.contextoptional.com/", "name": "Context Optional"}'
+  
+  /FEED_ITEM_CATS:
+    no_args:
+      <<: *item_deleted
+      get: 
+        with_token: '{"message": "the cats are asleep"}'
+  
+  /FEED_ITEM_DELETE:
+    no_args:
+      <<: *item_deleted
+      
+  /MOCK_COMMENT:
+    no_args:
+      <<: *item_deleted
+      get:
+        with_token: "{\"message\": \"it\'s my comment!\"}"