koala 0.10.0 → 1.0.0

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: koala
 version: !ruby/object:Gem::Version 
-  prerelease: false
+  hash: 23
+  prerelease: 
   segments: 
+  - 1
   - 0
-  - 10
   - 0
-  version: 0.10.0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Alex Koppel, Chris Baclig, Rafi Jacoby, Context Optional
@@ -14,43 +15,102 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-15 00:00:00 +01:00
-default_executable: 
+date: 2011-05-01 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: json
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
+        hash: 15
         segments: 
         - 1
         - 0
         version: "1.0"
   type: :runtime
+  name: json
   version_requirements: *id001
-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.
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 0
+        version: "1.0"
+  type: :runtime
+  name: multipart-post
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 2
+        - 5
+        - 0
+        version: 2.5.0
+  type: :development
+  name: rspec
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 49
+        segments: 
+        - 0
+        - 8
+        - 7
+        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.
 email: alex@alexkoppel.com
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
+- readme.md
 - 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
-- lib/koala/test_users.rb
 files: 
+- .gitignore
 - CHANGELOG
+- Gemfile
 - LICENSE
 - Manifest
 - Rakefile
-- init.rb
 - koala.gemspec
 - lib/koala.rb
 - lib/koala/graph_api.rb
@@ -58,27 +118,29 @@ files:
 - lib/koala/realtime_updates.rb
 - lib/koala/rest_api.rb
 - lib/koala/test_users.rb
+- lib/koala/uploadable_io.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/graph_api/graph_collection_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/test_users/test_users_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
-has_rdoc: true
+- spec/cases/api_base_spec.rb
+- spec/cases/graph_and_rest_api_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/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/fixtures/beach.jpg
+- 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/mock_http_service.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: []
 
@@ -88,31 +150,53 @@ rdoc_options:
 - --inline-source
 - --title
 - Koala
-- --main
-- readme.md
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 11
       segments: 
       - 1
       - 2
       version: "1.2"
 requirements: []
 
-rubyforge_project: koala
-rubygems_version: 1.3.6
+rubyforge_project: 
+rubygems_version: 1.7.2
 signing_key: 
 specification_version: 3
-summary: A lightweight, flexible library for Facebook with support for the Graph API, the old REST API, realtime updates, and OAuth validation.
-test_files: []
-
+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
+- spec/cases/graph_and_rest_api_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/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/fixtures/beach.jpg
+- 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/mock_http_service.rb
+- spec/support/rest_api_shared_examples.rb
+- spec/support/setup_mocks_or_live.rb
+- spec/support/uploadable_io_shared_examples.rb

data/init.rb

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

data/spec/koala/api_base_tests.rb

@@ -1,102 +0,0 @@
-class ApiBaseTests < Test::Unit::TestCase
-
-  describe "Koala API base class" do
-    before(:each) do
-      @service = Koala::Facebook::API.new  
-    end
-    
-    it "should not include an access token if none was given" do
-      Koala.should_receive(:make_request).with(
-        anything,
-        hash_not_including('access_token' => 1),
-        anything,
-        anything
-      ).and_return(Koala::Response.new(200, "", ""))
-      
-      @service.api('anything')
-    end
-    
-    it "should include an access token if given" do
-      token = 'adfadf'
-      service = Koala::Facebook::API.new token
-      
-      Koala.should_receive(:make_request).with(
-        anything,
-        hash_including('access_token' => token),
-        anything,
-        anything
-      ).and_return(Koala::Response.new(200, "", ""))
-      
-      service.api('anything')
-    end
-    
-    it "should have an attr_reader for access token" do
-      token = 'adfadf'
-      service = Koala::Facebook::API.new token
-      service.access_token.should == token
-    end
-    
-    it "should get the attribute of a Koala::Response given by the http_component parameter" do
-      http_component = :method_name
-      
-      response = mock('Mock KoalaResponse', :body => '', :status => 200)
-      response.should_receive(http_component).and_return('')
-      
-      Koala.stub(:make_request).and_return(response)
-      
-      @service.api('anything', 'get', {}, :http_component => http_component)
-    end
-    
-    it "should return the body of the request as JSON if no http_component is given" do
-      response = stub('response', :body => 'body', :status => 200)
-      Koala.stub(:make_request).and_return(response)
-      
-      json_body = mock('JSON body')
-      JSON.stub(:parse).and_return([json_body])
-      
-      @service.api('anything').should == json_body
-    end
-    
-    it "should execute a block with the response body if passed one" do
-      body = '{}'
-      Koala.stub(:make_request).and_return(Koala::Response.new(200, body, {}))
-      
-      yield_test = mock('Yield Tester')
-      yield_test.should_receive(:pass)
-      
-      @service.api('anything') do |arg| 
-        yield_test.pass
-        arg.should == JSON.parse(body)
-      end
-    end
-    
-    it "should raise an API error if the HTTP response code is greater than or equal to 500" do
-      Koala.stub(:make_request).and_return(Koala::Response.new(500, 'response body', {}))
-      
-      lambda { @service.api('anything') }.should raise_exception(Koala::Facebook::APIError)
-    end
-    
-    it "should handle rogue true/false as responses" do
-      Koala.should_receive(:make_request).and_return(Koala::Response.new(200, 'true', {}))
-      @service.api('anything').should be_true
-      
-      Koala.should_receive(:make_request).and_return(Koala::Response.new(200, 'false', {}))
-      @service.api('anything').should be_false
-    end
-    
-    describe "with regard to leading slashes" do 
-      it "should add a leading / to the path if not present" do
-        path = "anything"
-        Koala.should_receive(:make_request).with("/#{path}", anything, anything, anything).and_return(Koala::Response.new(200, 'true', {}))
-        @service.api(path)      
-      end
-    
-      it "shouldn't change the path if a leading / is present" do
-        path = "/anything"
-        Koala.should_receive(:make_request).with(path, anything, anything, anything).and_return(Koala::Response.new(200, 'true', {}))
-        @service.api(path)              
-      end
-    end
-    
-  end
-end

data/spec/koala/graph_and_rest_api/graph_and_rest_api_no_token_tests.rb

@@ -1,10 +0,0 @@
-class GraphAndRestAPINoTokenTests < Test::Unit::TestCase
-  describe "Koala GraphAndRestAPI without an access token" do
-    before(:each) do
-      @api = Koala::Facebook::GraphAndRestAPI.new
-    end
-    
-    it_should_behave_like "Koala RestAPI without an access token"
-    it_should_behave_like "Koala GraphAPI without an access token"
-  end
-end

data/spec/koala/graph_and_rest_api/graph_and_rest_api_with_token_tests.rb

@@ -1,11 +0,0 @@
-class GraphAndRestAPIWithTokenTests < Test::Unit::TestCase
-  describe "Koala GraphAndRestAPI without an access token" do
-    include LiveTestingDataHelper
-    it_should_behave_like "Koala RestAPI with an access token"
-    it_should_behave_like "Koala GraphAPI with an access token"
-    
-    before(:each) do
-      @api = Koala::Facebook::GraphAndRestAPI.new(@token)
-    end
-  end
-end

data/spec/koala/graph_api/graph_api_no_access_token_tests.rb

@@ -1,114 +0,0 @@
-shared_examples_for "Koala GraphAPI without an access token" do
-  it "should get public data about a user" do
-    result = @api.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 = @api.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 = @api.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
-    lambda { @api.get_object("me") }.should raise_error(Koala::Facebook::APIError)
-  end
-
-  it "should be able to get multiple objects" do
-    results = @api.get_objects(["contextoptional", "naitik"])
-    results.length.should == 2
-  end
-
-  it "shouldn't be able to access connections from users" do
-    lambda { @api.get_connections("lukeshepard", "likes") }.should raise_error(Koala::Facebook::APIError)
-  end
-
-  it "should be able to access a user's picture" do
-    @api.get_picture("chris.baclig").should =~ /http\:\/\//
-  end
-
-  it "should be able to access a user's picture, given a picture type"  do
-    @api.get_picture("chris.baclig", {:type => 'large'}).should =~ /^http\:\/\//
-  end
-
-  it "should be able to access connections from public Pages" do
-    result = @api.get_connections("contextoptional", "photos")
-    result.should be_a(Array)
-  end
-  
-  # paging
-  # see also graph_collection_tests
-  it "should make a request for a page when provided a specific set of page params" do
-    query = [1, 2]
-    @api.should_receive(:graph_call).with(*query)
-    @api.get_page(query)
-  end
-
-  it "should not be able to put an object" do
-    lambda { @result = @api.put_object("lukeshepard", "feed", :message => "Hello, world") }.should raise_error(Koala::Facebook::APIError)
-    puts "Error!  Object #{@result.inspect} somehow put onto Luke Shepard's wall!" if @result
-  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
-    (lambda do
-      attachment = {:name => "Context Optional", :link => "http://www.contextoptional.com/"}
-      @result = @api.put_wall_post("Hello, world", attachment, "contextoptional") 
-    end).should raise_error(Koala::Facebook::APIError)
-    puts "Error!  Object #{@result.inspect} somehow put onto Context Optional's wall!" if @result
-  end
-
-  it "should not be able to comment on an object" do
-    # random public post on the ContextOptional wall
-    lambda { @result = @api.put_comment("7204941866_119776748033392", "The hackathon was great!") }.should raise_error(Koala::Facebook::APIError)
-    puts "Error!  Object #{@result.inspect} somehow commented on post 7204941866_119776748033392!" if @result    
-  end
-
-  it "should not be able to like an object" do
-    lambda { @api.put_like("7204941866_119776748033392") }.should raise_error(Koala::Facebook::APIError)
-  end
-  
-  # DELETE
-  it "should not be able to delete posts" do 
-    # test post on the Ruby SDK Test application
-    lambda { @result = @api.delete_object("115349521819193_113815981982767") }.should raise_error(Koala::Facebook::APIError)
-  end
-
-  # SEARCH
-  it "should be able to search" do
-    result = @api.search("facebook")
-    result.length.should be_an(Integer)
-  end
-
-  it_should_behave_like "Koala GraphAPI with GraphCollection"
-  
-  # API
-  it "should never use the rest api server" do
-    Koala.should_receive(:make_request).with(
-      anything,
-      anything,
-      anything,
-      hash_not_including(:rest_api => true)
-    ).and_return(Koala::Response.new(200, "", {}))      
-    
-    @api.api("anything")
-  end
-end
-
-class FacebookNoAccessTokenTests < Test::Unit::TestCase
-  describe "Koala GraphAPI without an access token" do
-    before :each do
-      @api = Koala::Facebook::GraphAPI.new
-    end  
-    
-    it_should_behave_like "Koala GraphAPI without an access token"
-  end
-end
-  

data/spec/koala/graph_api/graph_api_with_access_token_tests.rb

@@ -1,150 +0,0 @@
-shared_examples_for "Koala GraphAPI with an access token" do
-  it "should get public data about a user" do
-      result = @api.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 = @api.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 = @api.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 = @api.get_object("me")
-      result["updated_time"].should
-    end
-  
-    it "should be able to get multiple objects" do
-      result = @api.get_objects(["contextoptional", "naitik"])
-      result.length.should == 2
-    end
-  
-    it "should be able to access a user's picture" do
-      @api.get_picture("chris.baclig").should =~ /http\:\/\//
-    end
-  
-    it "should be able to access a user's picture, given a picture type"  do
-      @api.get_picture("chris.baclig", {:type => 'large'}).should =~ /^http\:\/\//
-    end
-  
-    it "should be able to access connections from users" do
-      result = @api.get_connections("lukeshepard", "likes")
-      result.length.should > 0
-    end
-
-    it "should be able to access connections from public Pages" do
-      result = @api.get_connections("contextoptional", "photos")
-      result.should be_a(Array)
-    end
-    
-    # paging
-    # see also graph_collection_tests
-    it "should make a request for a page when provided a specific set of page params" do
-      query = [1, 2]
-      @api.should_receive(:graph_call).with(*query)
-      @api.get_page(query)
-    end
-    
-    
-    # PUT
-    it "should be able to write an object to the graph" do
-      result = @api.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 be able to delete posts" do 
-      result = @api.put_wall_post("Hello, world, from the test suite delete method!")
-      object_id_to_delete = result["id"]
-      delete_result = @api.delete_object(object_id_to_delete)
-      delete_result.should == true
-    end
-
-    # additional put tests
-    it "should be able to verify messages posted to a wall" do
-      message = "the cats are asleep"
-      put_result = @api.put_wall_post(message)
-      @temporary_object_id = put_result["id"]
-      get_result = @api.get_object(@temporary_object_id)
-      
-      # make sure the message we sent is the message that got posted
-      get_result["message"].should == message
-    end
-
-    it "should be able to post a message with an attachment to a feed" do
-      result = @api.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 verify a message with an attachment posted to a feed" do
-      attachment = {"name" => "Context Optional", "link" => "http://www.contextoptional.com/"}
-      result = @api.put_wall_post("Hello, world, from the test suite again!", attachment)
-      @temporary_object_id = result["id"]
-      get_result = @api.get_object(@temporary_object_id)
-
-      # make sure the result we fetch includes all the parameters we sent
-      it_matches = attachment.inject(true) {|valid, param| valid && (get_result[param[0]] == attachment[param[0]])}
-      it_matches.should == true 
-    end
-
-    it "should be able to comment on an object" do
-      result = @api.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 = @api.put_comment(@temporary_object_id, "it's my comment!")
-      comment_result.should_not be_nil
-    end
-    
-    it "should be able to verify a comment posted about an object" do
-      message_text = "Hello, world, from the test suite, testing comments!"
-      result = @api.put_wall_post(message_text)
-      @temporary_object_id = result["id"]
-      
-      # this will be deleted when the post gets deleted 
-      comment_text = "it's my comment!"
-      comment_result = @api.put_comment(@temporary_object_id, comment_text)
-      get_result = @api.get_object(comment_result["id"])
-
-      # make sure the text of the comment matches what we sent
-      get_result["message"].should == comment_text
-    end
-
-    it "should be able to like an object" do
-      result = @api.put_wall_post("Hello, world, from the test suite, testing comments!")
-      @temporary_object_id = result["id"]
-      like_result = @api.put_like(@temporary_object_id)
-    end
-
-    # SEARCH
-    it "should be able to search" do
-      result = @api.search("facebook")
-      result.length.should be_an(Integer)
-    end
-
-    # API
-    # the above tests test this already, but we should consider additional api tests
-
-    it_should_behave_like "Koala GraphAPI with GraphCollection"
-end
-
-class FacebookWithAccessTokenTests < Test::Unit::TestCase
-  describe "Koala GraphAPI with an access token" do
-    include LiveTestingDataHelper
-    it_should_behave_like "Koala GraphAPI with an access token"
-    
-    before :each do
-      @api = Koala::Facebook::GraphAPI.new(@token)
-    end
-  end
-end