koala 1.2.0beta1 → 1.2.1

data/spec/support/rest_api_shared_examples.rb

@@ -1,7 +1,7 @@
 shared_examples_for "Koala RestAPI" do
   # REST_CALL
   describe "when making a rest request" do
-    it "should use the proper path" do
+    it "uses the proper path" do
       method = stub('methodName')
       @api.should_receive(:api).with(
         "method/#{method}",
@@ -13,7 +13,7 @@ shared_examples_for "Koala RestAPI" do
       @api.rest_call(method)
     end
 
-    it "should always use the rest api" do
+    it "always uses the rest api" do
       @api.should_receive(:api).with(
         anything,
         anything,
@@ -24,7 +24,7 @@ shared_examples_for "Koala RestAPI" do
       @api.rest_call('anything')
     end
 
-    it "should set the read_only option to true if the method is listed in the read-only list" do
+    it "sets the read_only option to true if the method is listed in the read-only list" do
       method = Koala::Facebook::RestAPI::READ_ONLY_METHODS.first
 
       @api.should_receive(:api).with(
@@ -37,7 +37,7 @@ shared_examples_for "Koala RestAPI" do
       @api.rest_call(method)
     end
 
-    it "should set the read_only option to false if the method is not inthe read-only list" do
+    it "sets the read_only option to false if the method is not inthe read-only list" do
       method = "I'm not a read-only method"
 
       @api.should_receive(:api).with(
@@ -51,7 +51,7 @@ shared_examples_for "Koala RestAPI" do
     end
 
 
-    it "should take an optional hash of arguments" do
+    it "takes an optional hash of arguments" do
       args = {:arg1 => 'arg1'}
 
       @api.should_receive(:api).with(
@@ -64,7 +64,7 @@ shared_examples_for "Koala RestAPI" do
       @api.rest_call('anything', args)
     end
 
-    it "should always ask for JSON" do
+    it "always asks for JSON" do
       @api.should_receive(:api).with(
         anything,
         hash_including('format' => 'json'),
@@ -75,7 +75,7 @@ shared_examples_for "Koala RestAPI" do
       @api.rest_call('anything')
     end
 
-    it "should pass any options provided to the API" do
+    it "passes any options provided to the API" do
       options = {:a => 2}
 
       @api.should_receive(:api).with(
@@ -111,13 +111,13 @@ shared_examples_for "Koala RestAPI" do
       @api.rest_call('anything', {}, {}, method)
     end
 
-    it "should throw an APIError if the result hash has an error key" do
+    it "throws an APIError if the result hash has an error key" do
       Koala.stub(:make_request).and_return(Koala::Response.new(500, {"error_code" => "An error occurred!"}, {}))
       lambda { @api.rest_call("koppel", {}) }.should raise_exception(Koala::Facebook::APIError)
     end
 
     describe "when making a FQL request" do
-      it "should call fql.query method" do
+      it "calls fql.query method" do
         @api.should_receive(:rest_call).with(
           "fql.query", anything, anything
         ).and_return(Koala::Response.new(200, "2", {}))
@@ -125,7 +125,7 @@ shared_examples_for "Koala RestAPI" do
         @api.fql_query stub('query string')
       end
 
-      it "should pass a query argument" do
+      it "passes a query argument" do
         query = stub('query string')
 
         @api.should_receive(:rest_call).with(
@@ -135,13 +135,13 @@ shared_examples_for "Koala RestAPI" do
         @api.fql_query(query)
       end
 
-      it "should pass on any other arguments provided" do
+      it "passes on any other arguments provided" do
         args = {:a => 2}
         @api.should_receive(:rest_call).with(anything, hash_including(args), anything)
         @api.fql_query("a query", args)
       end
 
-      it "should pass on any http options provided" do
+      it "passes on any http options provided" do
         opts = {:a => 2}
         @api.should_receive(:rest_call).with(anything, anything, hash_including(opts))
         @api.fql_query("a query", {}, opts)
@@ -149,7 +149,7 @@ shared_examples_for "Koala RestAPI" do
     end
 
     describe "when making a FQL-multiquery request" do
-      it "should call fql.multiquery method" do
+      it "calls fql.multiquery method" do
         @api.should_receive(:rest_call).with(
           "fql.multiquery", anything, anything
         ).and_return({})
@@ -157,7 +157,7 @@ shared_examples_for "Koala RestAPI" do
         @api.fql_multiquery 'query string'
       end
 
-      it "should pass a queries argument" do
+      it "passes a queries argument" do
         queries = stub('query string')
         queries_json = "some JSON"
         MultiJson.stub(:encode).with(queries).and_return(queries_json)
@@ -186,30 +186,34 @@ shared_examples_for "Koala RestAPI" do
         results.should == expected_results
       end
 
-      it "should pass on any other arguments provided" do
+      it "passes on any other arguments provided" do
         args = {:a => 2}
         @api.should_receive(:rest_call).with(anything, hash_including(args), anything)
         @api.fql_multiquery("a query", args)
       end
 
-      it "should pass on any http options provided" do
+      it "passes on any http options provided" do
         opts = {:a => 2}
         @api.should_receive(:rest_call).with(anything, anything, hash_including(opts))
         @api.fql_multiquery("a query", {}, opts)
       end
     end
   end
+
+  it "can use the beta tier" do
+    @api.fql_query("select first_name from user where uid = #{KoalaTest.user2_id}", {}, :beta => true)
+  end
 end
 
 shared_examples_for "Koala RestAPI with an access token" do
   # FQL
-  it "should be able to access public information via FQL" do
+  it "can access public information via FQL" do
     result = @api.fql_query("select first_name from user where uid = #{KoalaTest.user2_id}")
     result.size.should == 1
     result.first['first_name'].should == KoalaTest.user2_name
   end
 
-  it "should be able to access public information via FQL.multiquery" do
+  it "can access public information via FQL.multiquery" do
     result = @api.fql_multiquery(
       :query1 => "select first_name from user where uid = #{KoalaTest.user2_id}",
       :query2 => "select first_name from user where uid = #{KoalaTest.user1_id}"
@@ -219,7 +223,7 @@ shared_examples_for "Koala RestAPI with an access token" do
     result["query2"].first['first_name'].should == KoalaTest.user1_name
   end
 
-  it "should be able to access protected information via FQL" do
+  it "can access protected information via FQL" do
     # Tests agains the permissions fql table
 
     # get the current user's ID
@@ -235,8 +239,7 @@ shared_examples_for "Koala RestAPI with an access token" do
     result.first["read_stream"].should == 1
   end
 
-
-  it "should be able to access protected information via FQL.multiquery" do
+  it "can access protected information via FQL.multiquery" do
     result = @api.fql_multiquery(
       :query1 => "select post_id from stream where source_id = me()",
       :query2 => "select fromid from comment where post_id in (select post_id from #query1)",
@@ -245,20 +248,57 @@ shared_examples_for "Koala RestAPI with an access token" do
     result.size.should == 3
     result.keys.should include("query1", "query2", "query3")
   end
+  
+  
+  describe ".set_app_properties" do
+    it "sends Facebook the properties JSON-encoded as :properties" do
+      props = {:a => 2, :c => [1, 2, "d"]}
+      @api.should_receive(:rest_call).with(anything, hash_including(:properties => MultiJson.encode(props)), anything, anything)
+      @api.set_app_properties(props)
+    end
+
+    it "calls the admin.setAppProperties method" do
+      @api.should_receive(:rest_call).with("admin.setAppProperties", anything, anything, anything)
+      @api.set_app_properties({})
+    end
+
+    it "includes any other provided arguments" do
+      args = {:c => 3, :d => "a"}
+      @api.should_receive(:rest_call).with(anything, hash_including(args), anything, anything)
+      @api.set_app_properties({:a => 2}, args)
+    end
+
+    it "includes any http_options provided" do
+      opts = {:c => 3, :d => "a"}
+      @api.should_receive(:rest_call).with(anything, anything, opts, anything)
+      @api.set_app_properties({}, {}, opts)
+    end
+    
+    it "makes a POST" do
+      @api.should_receive(:rest_call).with(anything, anything, anything, "post")
+      @api.set_app_properties({})
+    end
 
+    it "can set app properties using the app's access token" do
+      oauth = Koala::Facebook::OAuth.new(KoalaTest.app_id, KoalaTest.secret)
+      app_token = oauth.get_app_access_token
+      @app_api = Koala::Facebook::API.new(app_token)
+      @app_api.set_app_properties(:desktop => 0).should be_true
+    end
+  end
 end
 
 
 shared_examples_for "Koala RestAPI without an access token" do
   # FQL_QUERY
   describe "when making a FQL request" do
-    it "should be able to access public information via FQL" do
+    it "can access public information via FQL" do
       result = @api.fql_query("select first_name from user where uid = #{KoalaTest.user2_id}")
       result.size.should == 1
       result.first['first_name'].should == KoalaTest.user2_name
     end
 
-    it "should be able to access public information via FQL.multiquery" do
+    it "can access public information via FQL.multiquery" do
       result = @api.fql_multiquery(
         :query1 => "select first_name from user where uid = #{KoalaTest.user2_id}",
         :query2 => "select first_name from user where uid = #{KoalaTest.user1_id}"
@@ -268,11 +308,11 @@ shared_examples_for "Koala RestAPI without an access token" do
       result["query2"].first['first_name'].should == KoalaTest.user1_name
     end
 
-    it "should not be able to access protected information via FQL" do
+    it "can't access protected information via FQL" do
       lambda { @api.fql_query("select read_stream from permissions where uid = #{KoalaTest.user2_id}") }.should raise_error(Koala::Facebook::APIError)
     end
 
-    it "should not be able to access protected information via FQL.multiquery" do
+    it "can't access protected information via FQL.multiquery" do
       lambda {
         @api.fql_multiquery(
           :query1 => "select post_id from stream where source_id = me()",
@@ -282,4 +322,8 @@ shared_examples_for "Koala RestAPI without an access token" do
       }.should raise_error(Koala::Facebook::APIError)
     end
   end
+  
+  it "can't use set_app_properties" do
+    lambda { @api.set_app_properties(:desktop => 0) }.should raise_error(Koala::Facebook::APIError)
+  end
 end

metadata

@@ -1,84 +1,95 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: koala
-version: !ruby/object:Gem::Version
-  version: 1.2.0beta1
-  prerelease: 5
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 1
+  - 2
+  - 1
+  version: 1.2.1
 platform: ruby
-authors:
+authors: 
 - Alex Koppel, Chris Baclig, Rafi Jacoby, Context Optional
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-08-17 00:00:00.000000000 +02:00
+
+date: 2011-10-04 00:00:00 +02:00
 default_executable: 
-dependencies:
-- !ruby/object:Gem::Dependency
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  type: :runtime
   name: multi_json
-  requirement: &70190931210420 !ruby/object:Gem::Requirement
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 0
+        version: "1.0"
+  requirement: *id001
   prerelease: false
-  version_requirements: *70190931210420
-- !ruby/object:Gem::Dependency
-  name: faraday
-  requirement: &70190931209740 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.7.4
+- !ruby/object:Gem::Dependency 
   type: :runtime
-  prerelease: false
-  version_requirements: *70190931209740
-- !ruby/object:Gem::Dependency
-  name: faraday-stack
-  requirement: &70190931200940 !ruby/object:Gem::Requirement
+  name: faraday
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.1.3
-  type: :runtime
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        - 7
+        - 0
+        version: 0.7.0
+  requirement: *id002
   prerelease: false
-  version_requirements: *70190931200940
-- !ruby/object:Gem::Dependency
+- !ruby/object:Gem::Dependency 
+  type: :development
   name: rspec
-  requirement: &70190931200100 !ruby/object:Gem::Requirement
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
-        version: '2.5'
-  type: :development
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 2
+        - 5
+        version: "2.5"
+  requirement: *id003
   prerelease: false
-  version_requirements: *70190931200100
-- !ruby/object:Gem::Dependency
+- !ruby/object:Gem::Dependency 
+  type: :development
   name: rake
-  requirement: &70190931198560 !ruby/object:Gem::Requirement
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
+      - !ruby/object:Gem::Version 
+        hash: 49
+        segments: 
+        - 0
+        - 8
+        - 7
         version: 0.8.7
-  type: :development
+  requirement: *id004
   prerelease: false
-  version_requirements: *70190931198560
-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.
+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
@@ -95,20 +106,24 @@ files:
 - lib/koala/graph_batch_api.rb
 - lib/koala/graph_collection.rb
 - lib/koala/http_service.rb
+- lib/koala/multipart_request.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/graph_collection_spec.rb
 - spec/cases/http_service_spec.rb
 - spec/cases/koala_spec.rb
+- spec/cases/multipart_request_spec.rb
 - spec/cases/oauth_spec.rb
 - spec/cases/realtime_updates_spec.rb
 - spec/cases/rest_api_spec.rb
@@ -130,44 +145,51 @@ files:
 has_rdoc: true
 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
-      version: '0'
-      segments:
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
       - 0
-      hash: 4017352999765369439
-required_rubygems_version: !ruby/object:Gem::Requirement
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '1.2'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 11
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.5.2
 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/graph_collection_spec.rb
 - spec/cases/http_service_spec.rb
 - spec/cases/koala_spec.rb
+- spec/cases/multipart_request_spec.rb
 - spec/cases/oauth_spec.rb
 - spec/cases/realtime_updates_spec.rb
 - spec/cases/rest_api_spec.rb