koala 0.4 → 3.7.0

metadata

@@ -1,80 +1,224 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: koala
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 4
-  version: "0.4"
+version: !ruby/object:Gem::Version
+  version: 3.7.0
 platform: ruby
-authors: 
-- Alex Koppel, Rafi Jacoby, Context Optional
-autorequire: 
+authors:
+- Alex Koppel
 bindir: bin
 cert_chain: []
-
-date: 2010-05-01 00:00:00 -07:00
-default_executable: 
-dependencies: []
-
-description: Koala is a lightweight, flexible Ruby SDK for Facebook's new Graph API.  It allows read/write access to the Facebook Graph and provides OAuth URLs and cookie validation for Facebook Connect sites.  Koala supports Net::HTTP and Typhoeus connections out of the box and can accept custom modules for other services.
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cgi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Koala is a lightweight, flexible Ruby SDK for Facebook.  It allows read/write
+  access to the social graph via the Graph and REST APIs, 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.
 email: alex@alexkoppel.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
-- CHANGELOG
-- lib/http_services.rb
-- lib/koala.rb
-files: 
-- CHANGELOG
+extra_rdoc_files:
+- changelog.md
+- readme.md
+files:
+- ".github/workflows/test.yml"
+- ".gitignore"
+- ".rspec"
+- ".yardopts"
+- Gemfile
+- ISSUE_TEMPLATE
+- LICENSE
 - Manifest
+- PULL_REQUEST_TEMPLATE
 - Rakefile
-- init.rb
+- changelog.md
+- code_of_conduct.md
 - koala.gemspec
-- lib/http_services.rb
 - lib/koala.rb
+- lib/koala/api.rb
+- lib/koala/api/batch_operation.rb
+- lib/koala/api/graph_api_methods.rb
+- lib/koala/api/graph_batch_api.rb
+- lib/koala/api/graph_collection.rb
+- lib/koala/api/graph_error_checker.rb
+- lib/koala/configuration.rb
+- lib/koala/errors.rb
+- lib/koala/http_service.rb
+- lib/koala/http_service/request.rb
+- lib/koala/http_service/response.rb
+- lib/koala/http_service/uploadable_io.rb
+- lib/koala/oauth.rb
+- lib/koala/realtime_updates.rb
+- lib/koala/test_users.rb
+- lib/koala/utils.rb
+- lib/koala/version.rb
 - readme.md
-- test/facebook_data.yml
-- test/koala/facebook_no_access_token_tests.rb
-- test/koala/facebook_with_access_token_tests.rb
-- test/koala_tests.rb
-has_rdoc: true
-homepage: http://github.com/arsduo/ruby-sdk
-licenses: []
-
-post_install_message: 
-rdoc_options: 
-- --line-numbers
-- --inline-source
-- --title
+- spec/cases/api_spec.rb
+- spec/cases/configuration_spec.rb
+- spec/cases/error_spec.rb
+- spec/cases/graph_api_batch_spec.rb
+- spec/cases/graph_api_spec.rb
+- spec/cases/graph_collection_spec.rb
+- spec/cases/graph_error_checker_spec.rb
+- spec/cases/http_service/request_spec.rb
+- spec/cases/http_service/response_spec.rb
+- spec/cases/http_service_spec.rb
+- spec/cases/koala_spec.rb
+- spec/cases/koala_test_spec.rb
+- spec/cases/oauth_spec.rb
+- spec/cases/realtime_updates_spec.rb
+- spec/cases/test_users_spec.rb
+- spec/cases/uploadable_io_spec.rb
+- spec/cases/utils_spec.rb
+- spec/fixtures/beach.jpg
+- spec/fixtures/cat.m4v
+- spec/fixtures/facebook_data.yml
+- spec/fixtures/mock_facebook_responses.yml
+- spec/fixtures/vcr_cassettes/app_test_accounts.yml
+- spec/fixtures/vcr_cassettes/friend_list_next_page.yml
+- spec/integration/graph_collection_spec.rb
+- spec/spec_helper.rb
+- spec/support/custom_matchers.rb
+- spec/support/graph_api_shared_examples.rb
+- spec/support/koala_test.rb
+- spec/support/mock_http_service.rb
+- spec/support/uploadable_io_shared_examples.rb
+homepage: http://github.com/arsduo/koala
+licenses:
+- MIT
+metadata: {}
+rdoc_options:
+- "--line-numbers"
+- "--inline-source"
+- "--title"
 - Koala
-- --main
-- readme.md
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
+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
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 1
-      - 2
-      version: "1.2"
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: koala
-rubygems_version: 1.3.6
-signing_key: 
-specification_version: 3
-summary: A lightweight, flexible library for Facebook's new Graph API
+rubygems_version: 3.8.0.dev
+specification_version: 4
+summary: A lightweight, flexible library for Facebook with support for the Graph API,
+  the REST API, realtime updates, and OAuth authentication.
 test_files: []
-

data/CHANGELOG

@@ -1,24 +0,0 @@
-v0.4.0
--- Adopted the Koala name
--- 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/init.rb

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

data/lib/http_services.rb

@@ -1,60 +0,0 @@
-module Koala
-  class GraphAPI
-    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'
-        end
-      end
-    
-      def make_request(path, args, verb)
-        # 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"
-
-        http = Net::HTTP.new(FACEBOOK_GRAPH_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)}")) 
-          body
-        }
-      end
-
-      protected
-      def 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
-
-    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
-        end      
-      end
-
-      def make_request(path, args, verb)
-        # 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"
-        self.class.send(verb, "https://#{FACEBOOK_GRAPH_SERVER}/#{path}", :params => args).body
-      end
-    end
-  end
-end

data/test/facebook_data.yml

@@ -1,5 +0,0 @@
-oauth_token: 115349521819193|2.qpo_Ei2sucL3L_yjapnhhQ__.3600.1272762000-2905623|GKjZ-GL5nGIN4lFDZSa-zzFcXvM.
-app_id: 
-secret: 
-callback_url: 
-cookie_hash: 

data/test/koala/facebook_no_access_token_tests.rb

@@ -1,119 +0,0 @@
-class FacebookNoAccessTokenTests < Test::Unit::TestCase
-  describe "Koala GraphAPI without an access token" do
-    before :each do
-      @graph = Koala::GraphAPI.new
-    end
-  
-    it "should get public data about a user" do
-      result = @graph.get_object("koppel")
-      # the results should have an ID and a name, among other things
-      (result["id"] && result["name"]).should
-    end
-
-    it "should not get private data about a user" do
-      result = @graph.get_object("koppel")
-      # updated_time should be a pretty fixed test case
-      result["updated_time"].should be_nil
-    end
-
-  
-    it "should get public data about a Page" do
-      result = @graph.get_object("contextoptional")
-      # the results should have an ID and a name, among other things
-      (result["id"] && result["name"]).should
-    end
-  
-    it "should not be able to get data about 'me'" do
-      begin
-        @graph.get_object("me")
-      rescue Koala::GraphAPIError => @right_err
-      rescue Exception => wrong_err
-      end
-      @right_err.should_not be_nil
-    end
-  
-    it "should be able to get multiple objects" do
-      results = @graph.get_objects(["contextoptional", "naitik"])
-      results.length.should == 2
-    end
-  
-    it "shouldn't be able to access connections from users" do
-      begin
-        @graph.get_connections("lukeshepard", "likes")
-      rescue Koala::GraphAPIError => @right_err
-      rescue Exception => wrong_err
-      end
-      @right_err.should_not be_nil
-    end
-
-    it "should be able to access connections from public Pages" do
-      result = @graph.get_connections("contextoptional", "likes")
-      result["data"].should be_a(Array)
-    end
-  
-    it "should not be able to put an object" do
-      begin
-        @result = @graph.put_object("lukeshepard", "feed", :message => "Hello, world")
-      rescue Koala::GraphAPIError => @right_err
-      rescue Exception => wrong_err
-      end
-      @right_err.should_not be_nil
-    end
-
-    # these are not strictly necessary as the other put methods resolve to put_object, but are here for completeness
-    it "should not be able to post to a feed" do
-      begin
-        @result = @graph.put_wall_post("Hello, world", {:name => "Context Optional", :link => "http://www.contextoptional.com/"}, "contextoptional")
-      rescue Koala::GraphAPIError => @right_err
-      rescue Exception => wrong_err
-      end
-      @right_err.should_not be_nil
-    end
-
-    it "should not be able to comment on an object" do
-      begin
-        # random public post on the ContextOptional wall
-        @result = @graph.put_comment("7204941866_119776748033392", "The hackathon was great!")
-      rescue Koala::GraphAPIError => @right_err
-      rescue Exception => wrong_err
-      end
-      @right_err.should_not be_nil
-    end
-
-    it "should not be able to like an object" do
-      begin
-        @result = @graph.put_like("7204941866_119776748033392")
-      rescue Koala::GraphAPIError => @right_err
-      rescue Exception => wrong_err
-      end
-      @right_err.should_not be_nil
-    end
-
-
-    # DELETE
-    it "should not be able to delete posts" do 
-      begin
-        # test post on the Ruby SDK Test application
-        @result = @graph.delete_object("115349521819193_113815981982767")
-      rescue Koala::GraphAPIError => @right_err
-      rescue Exception => wrong_err
-      end
-      @right_err.should_not be_nil
-    end
-
-    # SEARCH
-    it "should be able to search" do
-      result = @graph.search("facebook")
-      result["data"].should be_an(Array)
-    end
-
-    # REQUEST
-    # the above tests test this already, but we should do it explicitly
-    it "should be able to send get-only requests" do
-      # to be written
-    end
-    
-  end # describe
-
-end #class
-  

data/test/koala/facebook_with_access_token_tests.rb

@@ -1,106 +0,0 @@
-class FacebookWithAccessTokenTests < Test::Unit::TestCase
-  describe "Koala GraphAPI with an access token" do
-    before :each do
-      token = $testing_data["oauth_token"]
-      raise Exception, "Must supply access token to run FacebookWithAccessTokenTests!" unless token
-      @graph = Koala::GraphAPI.new(token)
-    end
-    
-    after :each do 
-      # clean up any temporary objects
-      if @temporary_object_id
-        puts "\nCleaning up temporary object #{@temporary_object_id.to_s}"
-        @graph.delete_object(@temporary_object_id)
-      end
-    end
-
-    it "should get public data about a user" do
-      result = @graph.get_object("koppel")
-      # the results should have an ID and a name, among other things
-      (result["id"] && result["name"]).should_not be_nil
-    end
-
-    it "should get private data about a user" do
-      result = @graph.get_object("koppel")
-      # updated_time should be a pretty fixed test case
-      result["updated_time"].should_not be_nil
-    end
-
-    it "should get public data about a Page" do
-      result = @graph.get_object("contextoptional")
-      # the results should have an ID and a name, among other things
-      (result["id"] && result["name"]).should
-    end
-  
-    it "should get data about 'me'" do
-      result = @graph.get_object("me")
-      result["updated_time"].should
-    end
-  
-    it "should be able to get multiple objects" do
-      result = @graph.get_objects(["contextoptional", "naitik"])
-      result.length.should == 2
-    end
-  
-    it "should be able to access connections from users" do
-      result = @graph.get_connections("lukeshepard", "likes")
-      result["data"].length.should > 0
-    end
-
-    it "should be able to access connections from public Pages" do
-      result = @graph.get_connections("contextoptional", "likes")
-      result["data"].should be_a(Array)
-    end
-    
-    # PUT
-    it "should be able to put an object" do
-      result = @graph.put_wall_post("Hello, world, from the test suite!")
-      @temporary_object_id = result["id"]
-      @temporary_object_id.should_not be_nil
-    end
-
-    # DELETE
-    it "should not be able to delete posts" do 
-      result = @graph.put_wall_post("Hello, world, from the test suite delete method!")
-      object_id_to_delete = result["id"]
-      delete_result = @graph.delete_object(object_id_to_delete)
-      delete_result.should == true
-    end
-
-    # these are not strictly necessary as the other put methods resolve to put_object, but are here for completeness
-    it "should be able to post to a feed" do
-      result = @graph.put_wall_post("Hello, world, from the test suite again!", {:name => "Context Optional", :link => "http://www.contextoptional.com/"})
-      @temporary_object_id = result["id"]
-      @temporary_object_id.should_not be_nil
-    end
-
-    it "should be able to comment on an object" do
-      result = @graph.put_wall_post("Hello, world, from the test suite, testing comments!")
-      @temporary_object_id = result["id"]
-      
-      # this will be deleted when the post gets deleted 
-      comment_result = @graph.put_comment(@temporary_object_id, "it's my comment!")
-      comment_result.should_not be_nil
-    end
-
-    it "should be able to like an object" do
-      result = @graph.put_wall_post("Hello, world, from the test suite, testing comments!")
-      @temporary_object_id = result["id"]
-      like_result = @graph.put_like(@temporary_object_id)
-    end
-
-    # SEARCH
-    it "should be able to search" do
-      result = @graph.search("facebook")
-      result["data"].should be_an(Array)
-    end
-
-    # REQUEST
-    # the above tests test this already, but we should do it explicitly
-    it "should be able to send get and put requests" do
-      # to be written
-    end
-    
-  end # describe
-
-end #class

data/test/koala_tests.rb

@@ -1,30 +0,0 @@
-puts __FILE__
-require 'test/unit'
-require 'rubygems'
-require 'spec/test/unit'
-
-require 'koala'
-require 'koala/facebook_no_access_token_tests'
-require 'koala/facebook_with_access_token_tests'
-
-class FacebookTestSuite
-  def self.suite
-    suite = Test::Unit::TestSuite.new
-    suite << FacebookNoAccessTokenTests.suite
-    suite << FacebookWithAccessTokenTests.suite
-    #suite << FacebookCookieTest.suite
-    suite
-  end
-end
-
-# 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("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 cookies = $testing_data["cookie_hash"]
-  puts "Cookie tests will fail until you store a valid token in facebook_data.yml"
-end