fb_graph 0.7.2 → 0.7.3

data/README.rdoc

@@ -8,7 +8,7 @@ A full-stack Facebook Graph API wrapper in Ruby.
 
 == Resources
 
-* View RDoc on RDoc.info (http://rdoc.info/projects/nov/fb_graph)
+* View RDoc on RDoc.info (http://rdoc.info/github/nov/fb_graph/master/frames)
 * View Source on GitHub (http://github.com/nov/fb_graph)
 * Report Issues on GitHub (http://github.com/nov/fb_graph/issues)
 * Facebook fan page (http://www.facebook.com/pages/FbGraph/117513961602338)

data/VERSION

@@ -1 +1 @@
-0.7.2
+0.7.3

data/fb_graph.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{fb_graph}
-  s.version = "0.7.2"
+  s.version = "0.7.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["nov matake"]
-  s.date = %q{2010-09-04}
+  s.date = %q{2010-09-07}
   s.description = %q{A Ruby wrapper for Facebook Graph API}
   s.email = %q{nov@matake.jp}
   s.extra_rdoc_files = [
@@ -37,6 +37,7 @@ Gem::Specification.new do |s|
      "lib/fb_graph/comparison.rb",
      "lib/fb_graph/connection.rb",
      "lib/fb_graph/connections.rb",
+     "lib/fb_graph/connections/accounts.rb",
      "lib/fb_graph/connections/activities.rb",
      "lib/fb_graph/connections/albums.rb",
      "lib/fb_graph/connections/attending.rb",
@@ -109,6 +110,9 @@ Gem::Specification.new do |s|
      "spec/fake_json/posts/likes/post_without_access_token.json",
      "spec/fake_json/posts/platform_private.json",
      "spec/fake_json/posts/platform_public.json",
+     "spec/fake_json/users/accounts/matake_private.json",
+     "spec/fake_json/users/accounts/matake_private_with_manage_pages_permission.json",
+     "spec/fake_json/users/accounts/matake_public.json",
      "spec/fake_json/users/activities/arjun_private.json",
      "spec/fake_json/users/activities/arjun_public.json",
      "spec/fake_json/users/albums/matake_private.json",
@@ -162,6 +166,7 @@ Gem::Specification.new do |s|
      "spec/fb_graph/collection_spec.rb",
      "spec/fb_graph/comment_spec.rb",
      "spec/fb_graph/connection_spec.rb",
+     "spec/fb_graph/connections/accounts_spec.rb",
      "spec/fb_graph/connections/activities_spec.rb",
      "spec/fb_graph/connections/albums_spec.rb",
      "spec/fb_graph/connections/attending_spec.rb",
@@ -222,6 +227,7 @@ Gem::Specification.new do |s|
      "spec/fb_graph/collection_spec.rb",
      "spec/fb_graph/comment_spec.rb",
      "spec/fb_graph/connection_spec.rb",
+     "spec/fb_graph/connections/accounts_spec.rb",
      "spec/fb_graph/connections/activities_spec.rb",
      "spec/fb_graph/connections/albums_spec.rb",
      "spec/fb_graph/connections/attending_spec.rb",

data/lib/fb_graph/connections/accounts.rb

@@ -0,0 +1,22 @@
+module FbGraph
+  module Connections
+    module Accounts
+      # == Fetching Pages owned by the current user.
+      # 
+      # If the manage_pages permission has been granted,
+      # this connection also yields access_tokens that can be used to query the Graph API on behalf of the page.
+      # 
+      # ref) http://developers.facebook.com/docs/reference/api/user
+      # 
+      #   FbGraph::User.me(ACCESS_TOKEN).accounts
+      #   => array of FbGraph::Page
+      def accounts(options = {})
+        accounts = self.connection(:accounts, options)
+        accounts.map! do |account|
+          account[:access_token] ||= options[:access_token] || self.access_token
+          FbGraph::Page.new(account.delete(:id), account)
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/feed.rb

@@ -1,6 +1,32 @@
 module FbGraph
   module Connections
     module Feed
+      # == Fetching Wall posts
+      # 
+      # === User Wall
+      # 
+      #   FbGraph::User.new(username).feed
+      #   # => Array of FbGraph::Post
+      # 
+      # === Page Wall
+      # 
+      #   FbGraph::Page.new(page_id).feed
+      #   # => Array of FbGraph::Post
+      # 
+      # === Application Wall
+      # 
+      #   FbGraph::Application.new(page_id).feed
+      #   # => Array of FbGraph::Post
+      # 
+      # === Event Wall
+      # 
+      #   FbGraph::Event.new(page_id).feed
+      #   # => Array of FbGraph::Post
+      # 
+      # === Group Wall
+      # 
+      #   FbGraph::Group.new(page_id).feed
+      #   # => Array of FbGraph::Post
       def feed(options = {})
         posts = self.connection(:feed, options)
         posts.map! do |post|
@@ -10,6 +36,49 @@ module FbGraph
         end
       end
 
+      # == Updating Wall
+      # 
+      # * See supported arguments here http://developers.facebook.com/docs/reference/api/post
+      # * You need admin user's access_token to update Page/Application/Event/Group wall as itself
+      # 
+      # === User Wall
+      # 
+      #   me = FbGraph::User.me(ACCESS_TOKEN)
+      #   me.feed!(
+      #     :message => 'Updating via FbGraph'
+      #   )
+      # 
+      # === Page Wall
+      # 
+      #   page = FbGraph::Page.new(page_id)
+      #   page.feed!(
+      #     :access_token => ACCESS_TOKEN,
+      #     :message => 'Updating via FbGraph'
+      #   )
+      # 
+      # === Application Wall
+      # 
+      #   application = FbGraph::Page.new(application_id)
+      #   application.feed!(
+      #     :access_token => ACCESS_TOKEN,
+      #     :message => 'Updating via FbGraph'
+      #   )
+      # 
+      # === Event Wall
+      # 
+      #   event = FbGraph::Event.new(event_id)
+      #   event.feed!(
+      #     :access_token => ACCESS_TOKEN,
+      #     :message => 'Updating via FbGraph'
+      #   )
+      # 
+      # === Group Wall
+      # 
+      #   group = FbGraph::Group.new(group_id)
+      #   group.feed!(
+      #     :access_token => ACCESS_TOKEN,
+      #     :message => 'Updating via FbGraph'
+      #   )
       def feed!(options = {})
         post = post(options.merge(:connection => 'feed'))
         Post.new(post.delete(:id), options.merge(post).merge(

data/lib/fb_graph/node.rb

@@ -103,7 +103,7 @@ module FbGraph
         _response_ = JSON.parse(response.body).with_indifferent_access
         if _response_[:error]
           case _response_[:error][:type]
-          when 'OAuthAccessTokenException', 'QueryParseException'
+          when 'OAuthAccessTokenException', 'QueryParseException', 'OAuthInvalidRequestException'
             raise FbGraph::Unauthorized.new(_response_[:error][:message])
           else
             raise FbGraph::BadRequest.new("#{_response_[:error][:type]} :: #{_response_[:error][:message]}")

data/lib/fb_graph/user.rb

@@ -21,18 +21,15 @@ module FbGraph
     include Connections::Links
     include Connections::Notes
     include Connections::Events
+    # --
     # TODO
     # include Connections::Inbox
     # include Connections::Outbox
     # include Connections::Updates
-    # include Connections::Accounts
+    include Connections::Accounts
+    # ++
     extend Searchable
 
-    # TODO:
-    # include Connections::Inbox
-    # include Connections::Outbox
-    # include Connections::Updates
-
     attr_accessor :first_name, :last_name, :name, :link, :about, :birthday, :work, :education, :email, :website, :hometown, :location, :bio, :quotes, :gender, :interested_in, :meeting_for, :relationship_status, :religion, :political, :verified, :significant_other, :timezone, :updated_time
 
     def initialize(identifier, options = {})

data/spec/fake_json/users/accounts/matake_private.json

@@ -0,0 +1,14 @@
+{
+   "data": [
+      {
+         "name": "OAuth.jp",
+         "category": "Technology",
+         "id": "140478125968442"
+      },
+      {
+         "name": "FbGraph",
+         "category": "Technology",
+         "id": "117513961602338"
+      }
+   ]
+}

data/spec/fake_json/users/accounts/matake_private_with_manage_pages_permission.json

@@ -0,0 +1,16 @@
+{
+   "data": [
+      {
+         "name": "OAuth.jp",
+         "category": "Technology",
+         "id": "140478125968442",
+         "access_token": "access_token_for_oauth_jp"
+      },
+      {
+         "name": "FbGraph",
+         "category": "Technology",
+         "id": "117513961602338",
+         "access_token": "access_token_for_fb_graph"
+      }
+   ]
+}

data/spec/fake_json/users/accounts/matake_public.json

@@ -0,0 +1,6 @@
+{
+   "error": {
+      "type": "OAuthInvalidRequestException",
+      "message": "An active access token must be used to query information about the current user."
+   }
+}

data/spec/fb_graph/connections/accounts_spec.rb

@@ -0,0 +1,47 @@
+require File.join(File.dirname(__FILE__), '../../spec_helper')
+
+context 'when included by FbGraph::User' do
+  describe FbGraph::Connections::Accounts, '#accounts' do
+    before(:all) do
+      fake_json(:get, 'matake/accounts', 'users/accounts/matake_public')
+      fake_json(:get, 'matake/accounts?access_token=access_token', 'users/accounts/matake_private')
+      fake_json(:get, 'matake/accounts?access_token=access_token_with_manage_pages_permission', 'users/accounts/matake_private_with_manage_pages_permission')
+    end
+
+    context 'when no access_token given' do
+      it 'should raise FbGraph::Unauthorized' do
+        lambda do
+          FbGraph::User.new('matake').accounts
+        end.should raise_exception(FbGraph::Unauthorized)
+      end
+    end
+
+    context 'when access_token is given' do
+      it 'should return accounts as FbGraph::Page' do
+        accounts = FbGraph::User.new('matake', :access_token => 'access_token').accounts
+        accounts.class.should == FbGraph::Connection
+        accounts.first.should == FbGraph::Page.new(
+          '140478125968442',
+          :access_token => 'access_token',
+          :name => 'OAuth.jp',
+          :category => 'Technology'
+        )
+        accounts.each do |account|
+          account.should be_instance_of(FbGraph::Page)
+        end
+      end
+
+      context 'when manage_pages permission given' do
+        it 'should has special access_token behalf of the page' do
+          accounts = FbGraph::User.new('matake', :access_token => 'access_token_with_manage_pages_permission').accounts
+          accounts.first.should == FbGraph::Page.new(
+            '140478125968442',
+            :access_token => 'access_token_for_oauth_jp',
+            :name => 'OAuth.jp',
+            :category => 'Technology'
+          )
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: fb_graph
 version: !ruby/object:Gem::Version 
-  hash: 7
+  hash: 5
   prerelease: false
   segments: 
   - 0
   - 7
-  - 2
-  version: 0.7.2
+  - 3
+  version: 0.7.3
 platform: ruby
 authors: 
 - nov matake
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-04 00:00:00 +09:00
+date: 2010-09-07 00:00:00 +09:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -149,6 +149,7 @@ files:
 - lib/fb_graph/comparison.rb
 - lib/fb_graph/connection.rb
 - lib/fb_graph/connections.rb
+- lib/fb_graph/connections/accounts.rb
 - lib/fb_graph/connections/activities.rb
 - lib/fb_graph/connections/albums.rb
 - lib/fb_graph/connections/attending.rb
@@ -221,6 +222,9 @@ files:
 - spec/fake_json/posts/likes/post_without_access_token.json
 - spec/fake_json/posts/platform_private.json
 - spec/fake_json/posts/platform_public.json
+- spec/fake_json/users/accounts/matake_private.json
+- spec/fake_json/users/accounts/matake_private_with_manage_pages_permission.json
+- spec/fake_json/users/accounts/matake_public.json
 - spec/fake_json/users/activities/arjun_private.json
 - spec/fake_json/users/activities/arjun_public.json
 - spec/fake_json/users/albums/matake_private.json
@@ -274,6 +278,7 @@ files:
 - spec/fb_graph/collection_spec.rb
 - spec/fb_graph/comment_spec.rb
 - spec/fb_graph/connection_spec.rb
+- spec/fb_graph/connections/accounts_spec.rb
 - spec/fb_graph/connections/activities_spec.rb
 - spec/fb_graph/connections/albums_spec.rb
 - spec/fb_graph/connections/attending_spec.rb
@@ -362,6 +367,7 @@ test_files:
 - spec/fb_graph/collection_spec.rb
 - spec/fb_graph/comment_spec.rb
 - spec/fb_graph/connection_spec.rb
+- spec/fb_graph/connections/accounts_spec.rb
 - spec/fb_graph/connections/activities_spec.rb
 - spec/fb_graph/connections/albums_spec.rb
 - spec/fb_graph/connections/attending_spec.rb