koala 1.0.0 → 1.2.0

metadata

@@ -1,202 +1,178 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: koala
-version: !ruby/object:Gem::Version 
-  hash: 23
+version: !ruby/object:Gem::Version
+  version: 1.2.0
   prerelease: 
-  segments: 
-  - 1
-  - 0
-  - 0
-  version: 1.0.0
 platform: ruby
-authors: 
+authors:
 - Alex Koppel, Chris Baclig, Rafi Jacoby, Context Optional
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-05-01 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+date: 2011-09-27 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: &70248641333480 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 15
-        segments: 
-        - 1
-        - 0
-        version: "1.0"
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :runtime
-  name: json
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *70248641333480
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: &70248641333000 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 15
-        segments: 
-        - 1
-        - 0
-        version: "1.0"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
   type: :runtime
-  name: multipart-post
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *70248641333000
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70248641332520 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 27
-        segments: 
-        - 2
-        - 5
-        - 0
-        version: 2.5.0
+      - !ruby/object:Gem::Version
+        version: '2.5'
   type: :development
-  name: rspec
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: *70248641332520
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70248641332040 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 49
-        segments: 
-        - 0
-        - 8
-        - 7
+      - !ruby/object:Gem::Version
         version: 0.8.7
   type: :development
-  name: rake
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 31
-        segments: 
-        - 0
-        - 2
-        - 4
-        version: 0.2.4
-  type: :development
-  name: typhoeus
-  version_requirements: *id005
-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.
+  version_requirements: *70248641332040
+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: 
+extra_rdoc_files:
 - readme.md
 - CHANGELOG
-files: 
+files:
+- .autotest
 - .gitignore
+- .travis.yml
 - CHANGELOG
 - Gemfile
 - LICENSE
 - Manifest
 - Rakefile
+- autotest/discover.rb
 - koala.gemspec
 - lib/koala.rb
+- lib/koala/batch_operation.rb
 - lib/koala/graph_api.rb
-- lib/koala/http_services.rb
+- lib/koala/graph_batch_api.rb
+- lib/koala/graph_collection.rb
+- lib/koala/http_service.rb
+- lib/koala/oauth.rb
 - lib/koala/realtime_updates.rb
 - lib/koala/rest_api.rb
 - lib/koala/test_users.rb
 - lib/koala/uploadable_io.rb
+- lib/koala/utils.rb
+- lib/koala/version.rb
 - readme.md
-- spec/cases/api_base_spec.rb
+- spec/cases/api_spec.rb
+- spec/cases/error_spec.rb
 - spec/cases/graph_and_rest_api_spec.rb
+- spec/cases/graph_api_batch_spec.rb
 - spec/cases/graph_api_spec.rb
-- spec/cases/http_services/http_service_spec.rb
-- spec/cases/http_services/net_http_service_spec.rb
-- spec/cases/http_services/typhoeus_service_spec.rb
+- spec/cases/graph_collection_spec.rb
+- spec/cases/http_service_spec.rb
+- spec/cases/koala_spec.rb
 - spec/cases/oauth_spec.rb
 - spec/cases/realtime_updates_spec.rb
 - spec/cases/rest_api_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/spec_helper.rb
 - spec/support/graph_api_shared_examples.rb
-- spec/support/live_testing_data_helper.rb
+- spec/support/json_testing_fix.rb
+- spec/support/koala_test.rb
 - spec/support/mock_http_service.rb
+- spec/support/ordered_hash.rb
 - spec/support/rest_api_shared_examples.rb
-- spec/support/setup_mocks_or_live.rb
 - spec/support/uploadable_io_shared_examples.rb
 homepage: http://github.com/arsduo/koala
 licenses: []
-
 post_install_message: 
-rdoc_options: 
+rdoc_options:
 - --line-numbers
 - --inline-source
 - --title
 - Koala
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: 2837078681376474267
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 11
-      segments: 
-      - 1
-      - 2
-      version: "1.2"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '1.2'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.7.2
+rubygems_version: 1.8.8
 signing_key: 
 specification_version: 3
-summary: A lightweight, flexible library for Facebook with support for the Graph API, the REST API, realtime updates, and OAuth authentication.
-test_files: 
-- spec/cases/api_base_spec.rb
+summary: A lightweight, flexible library for Facebook with support for the Graph API,
+  the REST API, realtime updates, and OAuth authentication.
+test_files:
+- spec/cases/api_spec.rb
+- spec/cases/error_spec.rb
 - spec/cases/graph_and_rest_api_spec.rb
+- spec/cases/graph_api_batch_spec.rb
 - spec/cases/graph_api_spec.rb
-- spec/cases/http_services/http_service_spec.rb
-- spec/cases/http_services/net_http_service_spec.rb
-- spec/cases/http_services/typhoeus_service_spec.rb
+- spec/cases/graph_collection_spec.rb
+- spec/cases/http_service_spec.rb
+- spec/cases/koala_spec.rb
 - spec/cases/oauth_spec.rb
 - spec/cases/realtime_updates_spec.rb
 - spec/cases/rest_api_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/spec_helper.rb
 - spec/support/graph_api_shared_examples.rb
-- spec/support/live_testing_data_helper.rb
+- spec/support/json_testing_fix.rb
+- spec/support/koala_test.rb
 - spec/support/mock_http_service.rb
+- spec/support/ordered_hash.rb
 - spec/support/rest_api_shared_examples.rb
-- spec/support/setup_mocks_or_live.rb
 - spec/support/uploadable_io_shared_examples.rb

data/lib/koala/http_services.rb

@@ -1,146 +0,0 @@
-module Koala
-  class Response
-    attr_reader :status, :body, :headers
-    def initialize(status, body, headers)
-      @status = status
-      @body = body
-      @headers = headers
-    end
-  end
-
-  module HTTPService
-    # common functionality for all HTTP services
-    def self.included(base)
-      base.class_eval do
-        class << self
-          attr_accessor :always_use_ssl
-        end
-               
-        def self.server(options = {})
-          "#{options[:beta] ? "beta." : ""}#{options[:rest_api] ? Facebook::REST_SERVER : Facebook::GRAPH_SERVER}"          
-        end
-                                      
-        protected
-        
-        def self.params_require_multipart?(param_hash)
-          param_hash.any? { |key, value| value.kind_of?(Koala::UploadableIO) }
-        end
-    
-        def self.multipart_requires_content_type?
-          true
-        end
-      end
-    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"
-        require "net/http/post/multipart"
-
-        include Koala::HTTPService
-
-        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.
-
-          # by default, we use SSL only for private requests
-          # this makes public requests faster
-          private_request = args["access_token"] || @always_use_ssl || options[:use_ssl]
-
-          # 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 = create_http(server(options), private_request, options)
-          http.use_ssl = true if private_request
-
-          result = http.start do |http|
-            response, body = if verb == "post"
-              if params_require_multipart? args
-                http.request Net::HTTP::Post::Multipart.new path, encode_multipart_params(args)
-              else
-                http.post(path, encode_params(args))
-              end
-            else
-              http.get("#{path}?#{encode_params(args)}")
-            end
-            
-            Koala::Response.new(response.code.to_i, body, response)
-          end
-        end
-
-        protected
-        def self.encode_params(param_hash)
-          # unfortunately, we can't use to_query because that's Rails, not Ruby
-          # 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
-        
-        def self.encode_multipart_params(param_hash)
-          Hash[*param_hash.collect do |key, value| 
-            [key, value.kind_of?(Koala::UploadableIO) ? value.to_upload_io : value]
-          end.flatten]
-        end
-
-        def self.create_http(server, private_request, options)
-          if options[:proxy]
-            proxy = URI.parse(options[:proxy])
-            http  = Net::HTTP.new(server, private_request ? 443 : nil,
-                                  proxy.host, proxy.port, proxy.user, proxy.password)
-          else
-            http = Net::HTTP.new(server, private_request ? 443 : nil)
-          end
-          if options[:timeout]
-            http.open_timeout = options[:timeout]
-            http.read_timeout = options[:timeout]
-          end
-          http
-        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
-        
-        include Koala::HTTPService
-
-        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"
-
-          # switch any UploadableIOs to the files Typhoeus expects 
-          args.each_pair {|key, value| args[key] = value.to_file if value.is_a?(UploadableIO)}
-
-          # you can pass arguments directly to Typhoeus using the :typhoeus_options key
-          typhoeus_options = {:params => args}.merge(options[:typhoeus_options] || {})
-
-          # by default, we use SSL only for private requests (e.g. with access token)
-          # this makes public requests faster
-          prefix = (args["access_token"] || @always_use_ssl || options[:use_ssl]) ? "https" : "http"
-
-          response = self.send(verb, "#{prefix}://#{server(options)}#{path}", typhoeus_options)
-          Koala::Response.new(response.code, response.body, response.headers_hash)
-        end
-        
-        private
-        
-        def self.multipart_requires_content_type?
-          false # Typhoeus handles multipart file types, we don't have to require it
-        end
-      end # class_eval
-    end
-  end
-end

data/spec/cases/http_services/http_service_spec.rb

@@ -1,54 +0,0 @@
-require 'spec_helper'
-
-
-class Bear
-  include Koala::HTTPService
-end
-
-describe "Koala::HTTPService" do
-
-  describe "common methods" do
-    describe "always_use_ssl accessor" do
-      it "should be added" do
-        # in Ruby 1.8, .methods returns strings
-        # in Ruby 1.9, .method returns symbols 
-        Bear.methods.collect {|m| m.to_sym}.should include(:always_use_ssl)
-        Bear.methods.collect {|m| m.to_sym}.should include(:always_use_ssl=)
-      end
-    end
-    
-    describe "server" do
-      describe "without options[:beta]" do
-        it "should return the rest server if options[:rest_api]" do
-          Bear.server(:rest_api => true).should == Koala::Facebook::REST_SERVER
-        end
-
-        it "should return the rest server if !options[:rest_api]" do
-          Bear.server(:rest_api => false).should == Koala::Facebook::GRAPH_SERVER
-          Bear.server({}).should == Koala::Facebook::GRAPH_SERVER
-        end
-      end
-      
-      describe "without options[:beta]" do
-        before :each do
-          @options = {:beta => true}
-        end
-        
-        it "should return the rest server if options[:rest_api]" do
-          server = Bear.server(@options.merge(:rest_api => true))
-          server.should =~ Regexp.new(Koala::Facebook::REST_SERVER)
-          server.should =~ /beta\./
-        end
-
-        it "should return the rest server if !options[:rest_api]" do
-          server = Bear.server(:beta => true)
-          server.should =~ Regexp.new(Koala::Facebook::GRAPH_SERVER)
-          server.should =~ /beta\./
-        end
-      end
-      
-    end
-
-  end
-
-end