palidanx-fb_graph 1.0.4

data/fb_graph.gemspec

@@ -0,0 +1,327 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{fb_graph}
+  s.version = "1.0.4"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["nov matake"]
+  s.date = %q{2010-09-15}
+  s.description = %q{A full-stack Facebook Graph API wrapper in Ruby.}
+  s.email = %q{nov@matake.jp}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "assets/fb_graph.ai",
+     "assets/fb_graph.png",
+     "fb_graph.gemspec",
+     "lib/fb_graph.rb",
+     "lib/fb_graph/album.rb",
+     "lib/fb_graph/application.rb",
+     "lib/fb_graph/auth.rb",
+     "lib/fb_graph/auth/cookie.rb",
+     "lib/fb_graph/checkin.rb",
+     "lib/fb_graph/collection.rb",
+     "lib/fb_graph/comment.rb",
+     "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",
+     "lib/fb_graph/connections/books.rb",
+     "lib/fb_graph/connections/checkins.rb",
+     "lib/fb_graph/connections/comments.rb",
+     "lib/fb_graph/connections/declined.rb",
+     "lib/fb_graph/connections/events.rb",
+     "lib/fb_graph/connections/feed.rb",
+     "lib/fb_graph/connections/friends.rb",
+     "lib/fb_graph/connections/groups.rb",
+     "lib/fb_graph/connections/home.rb",
+     "lib/fb_graph/connections/insights.rb",
+     "lib/fb_graph/connections/interests.rb",
+     "lib/fb_graph/connections/invited.rb",
+     "lib/fb_graph/connections/likes.rb",
+     "lib/fb_graph/connections/links.rb",
+     "lib/fb_graph/connections/maybe.rb",
+     "lib/fb_graph/connections/members.rb",
+     "lib/fb_graph/connections/movies.rb",
+     "lib/fb_graph/connections/music.rb",
+     "lib/fb_graph/connections/noreply.rb",
+     "lib/fb_graph/connections/notes.rb",
+     "lib/fb_graph/connections/photos.rb",
+     "lib/fb_graph/connections/picture.rb",
+     "lib/fb_graph/connections/posts.rb",
+     "lib/fb_graph/connections/statuses.rb",
+     "lib/fb_graph/connections/subscriptions.rb",
+     "lib/fb_graph/connections/tagged.rb",
+     "lib/fb_graph/connections/television.rb",
+     "lib/fb_graph/connections/videos.rb",
+     "lib/fb_graph/education.rb",
+     "lib/fb_graph/event.rb",
+     "lib/fb_graph/group.rb",
+     "lib/fb_graph/insight.rb",
+     "lib/fb_graph/link.rb",
+     "lib/fb_graph/node.rb",
+     "lib/fb_graph/note.rb",
+     "lib/fb_graph/page.rb",
+     "lib/fb_graph/photo.rb",
+     "lib/fb_graph/post.rb",
+     "lib/fb_graph/searchable.rb",
+     "lib/fb_graph/searchable/result.rb",
+     "lib/fb_graph/status.rb",
+     "lib/fb_graph/subscription.rb",
+     "lib/fb_graph/tag.rb",
+     "lib/fb_graph/user.rb",
+     "lib/fb_graph/venue.rb",
+     "lib/fb_graph/video.rb",
+     "lib/fb_graph/work.rb",
+     "spec/fake_json/albums/photos/matake_private.json",
+     "spec/fake_json/albums/photos/post_with_valid_access_token.json",
+     "spec/fake_json/applications/subscriptions/fb_graph_private.json",
+     "spec/fake_json/checkins/search_private.json",
+     "spec/fake_json/checkins/search_public.json",
+     "spec/fake_json/events/attending/post_with_valid_access_token.json",
+     "spec/fake_json/events/attending/smartday_private.json",
+     "spec/fake_json/events/declined/post_with_valid_access_token.json",
+     "spec/fake_json/events/declined/smartday_private.json",
+     "spec/fake_json/events/invited/smartday_private.json",
+     "spec/fake_json/events/maybe/post_with_valid_access_token.json",
+     "spec/fake_json/events/maybe/smartday_private.json",
+     "spec/fake_json/events/noreply/smartday_private.json",
+     "spec/fake_json/groups/members/emacs_private.json",
+     "spec/fake_json/pages/checkins/gowalla_private.json",
+     "spec/fake_json/pages/checkins/gowalla_public.json",
+     "spec/fake_json/pages/notes/post_with_valid_access_token.json",
+     "spec/fake_json/pages/platform_private.json",
+     "spec/fake_json/pages/platform_public.json",
+     "spec/fake_json/pages/statuses/platform_private.json",
+     "spec/fake_json/pages/statuses/platform_public.json",
+     "spec/fake_json/posts/comments/post_with_invalid_access_token.json",
+     "spec/fake_json/posts/comments/post_with_valid_access_token.json",
+     "spec/fake_json/posts/comments/post_without_access_token.json",
+     "spec/fake_json/posts/likes/post_with_invalid_access_token.json",
+     "spec/fake_json/posts/likes/post_with_valid_access_token.json",
+     "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",
+     "spec/fake_json/users/albums/matake_public.json",
+     "spec/fake_json/users/albums/post_with_valid_access_token.json",
+     "spec/fake_json/users/arjun_private.json",
+     "spec/fake_json/users/arjun_public.json",
+     "spec/fake_json/users/books/matake_private.json",
+     "spec/fake_json/users/books/matake_public.json",
+     "spec/fake_json/users/checkins/mattt_private.json",
+     "spec/fake_json/users/checkins/mattt_public.json",
+     "spec/fake_json/users/events/matake_private.json",
+     "spec/fake_json/users/events/matake_public.json",
+     "spec/fake_json/users/events/post_with_valid_access_token.json",
+     "spec/fake_json/users/feed/arjun_private.json",
+     "spec/fake_json/users/feed/arjun_public.json",
+     "spec/fake_json/users/feed/post_with_invalid_access_token.json",
+     "spec/fake_json/users/feed/post_with_valid_access_token.json",
+     "spec/fake_json/users/feed/post_without_access_token.json",
+     "spec/fake_json/users/friends/arjun_private.json",
+     "spec/fake_json/users/friends/arjun_public.json",
+     "spec/fake_json/users/friends/me_private.json",
+     "spec/fake_json/users/friends/me_public.json",
+     "spec/fake_json/users/groups/matake_private.json",
+     "spec/fake_json/users/groups/matake_public.json",
+     "spec/fake_json/users/home/arjun_private.json",
+     "spec/fake_json/users/home/arjun_public.json",
+     "spec/fake_json/users/home/me_private.json",
+     "spec/fake_json/users/home/me_private_next.json",
+     "spec/fake_json/users/home/me_private_previous.json",
+     "spec/fake_json/users/home/me_public.json",
+     "spec/fake_json/users/interests/matake_private.json",
+     "spec/fake_json/users/likes/arjun_private.json",
+     "spec/fake_json/users/likes/arjun_public.json",
+     "spec/fake_json/users/links/matake_private.json",
+     "spec/fake_json/users/links/post_with_valid_access_token.json",
+     "spec/fake_json/users/me_private.json",
+     "spec/fake_json/users/me_public.json",
+     "spec/fake_json/users/movies/matake_private.json",
+     "spec/fake_json/users/music/matake_private.json",
+     "spec/fake_json/users/notes/matake_private.json",
+     "spec/fake_json/users/posts/arjun_private.json",
+     "spec/fake_json/users/posts/arjun_public.json",
+     "spec/fake_json/users/statuses/arjun_private.json",
+     "spec/fake_json/users/statuses/arjun_public.json",
+     "spec/fake_json/users/tagged/arjun_private.json",
+     "spec/fake_json/users/tagged/arjun_public.json",
+     "spec/fake_json/users/television/matake_private.json",
+     "spec/fake_json/users/videos/kirk_private.json",
+     "spec/fb_graph/album_spec.rb",
+     "spec/fb_graph/application_spec.rb",
+     "spec/fb_graph/auth_spec.rb",
+     "spec/fb_graph/checkin_spec.rb",
+     "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",
+     "spec/fb_graph/connections/books_spec.rb",
+     "spec/fb_graph/connections/checkins_spec.rb",
+     "spec/fb_graph/connections/comments_spec.rb",
+     "spec/fb_graph/connections/declined_spec.rb",
+     "spec/fb_graph/connections/events_spec.rb",
+     "spec/fb_graph/connections/feed_spec.rb",
+     "spec/fb_graph/connections/friends_spec.rb",
+     "spec/fb_graph/connections/groups_spec.rb",
+     "spec/fb_graph/connections/home_spec.rb",
+     "spec/fb_graph/connections/interests_spec.rb",
+     "spec/fb_graph/connections/invited_spec.rb",
+     "spec/fb_graph/connections/likes_spec.rb",
+     "spec/fb_graph/connections/links_spec.rb",
+     "spec/fb_graph/connections/maybe_spec.rb",
+     "spec/fb_graph/connections/members_spec.rb",
+     "spec/fb_graph/connections/movies_spec.rb",
+     "spec/fb_graph/connections/music_spec.rb",
+     "spec/fb_graph/connections/noreply_spec.rb",
+     "spec/fb_graph/connections/notes_spec.rb",
+     "spec/fb_graph/connections/photos_spec.rb",
+     "spec/fb_graph/connections/picture_spec.rb",
+     "spec/fb_graph/connections/posts_spec.rb",
+     "spec/fb_graph/connections/statuses_spec.rb",
+     "spec/fb_graph/connections/subscriptions_spec.rb",
+     "spec/fb_graph/connections/tagged_spec.rb",
+     "spec/fb_graph/connections/television_spec.rb",
+     "spec/fb_graph/connections/videos_spec.rb",
+     "spec/fb_graph/education_spec.rb",
+     "spec/fb_graph/event_spec.rb",
+     "spec/fb_graph/group_spec.rb",
+     "spec/fb_graph/insight_spec.rb",
+     "spec/fb_graph/link_spec.rb",
+     "spec/fb_graph/node_spec.rb",
+     "spec/fb_graph/note_spec.rb",
+     "spec/fb_graph/page_spec.rb",
+     "spec/fb_graph/photo_spec.rb",
+     "spec/fb_graph/post_spec.rb",
+     "spec/fb_graph/status_spec.rb",
+     "spec/fb_graph/subscription_spec.rb",
+     "spec/fb_graph/tag_spec.rb",
+     "spec/fb_graph/user_spec.rb",
+     "spec/fb_graph/venue_spec.rb",
+     "spec/fb_graph/video_spec.rb",
+     "spec/fb_graph/work_spec.rb",
+     "spec/helpers/fake_json_helper.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/nov/fb_graph}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{A full-stack Facebook Graph API wrapper in Ruby.}
+  s.test_files = [
+    "spec/fb_graph/album_spec.rb",
+     "spec/fb_graph/application_spec.rb",
+     "spec/fb_graph/auth_spec.rb",
+     "spec/fb_graph/checkin_spec.rb",
+     "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",
+     "spec/fb_graph/connections/books_spec.rb",
+     "spec/fb_graph/connections/checkins_spec.rb",
+     "spec/fb_graph/connections/comments_spec.rb",
+     "spec/fb_graph/connections/declined_spec.rb",
+     "spec/fb_graph/connections/events_spec.rb",
+     "spec/fb_graph/connections/feed_spec.rb",
+     "spec/fb_graph/connections/friends_spec.rb",
+     "spec/fb_graph/connections/groups_spec.rb",
+     "spec/fb_graph/connections/home_spec.rb",
+     "spec/fb_graph/connections/interests_spec.rb",
+     "spec/fb_graph/connections/invited_spec.rb",
+     "spec/fb_graph/connections/likes_spec.rb",
+     "spec/fb_graph/connections/links_spec.rb",
+     "spec/fb_graph/connections/maybe_spec.rb",
+     "spec/fb_graph/connections/members_spec.rb",
+     "spec/fb_graph/connections/movies_spec.rb",
+     "spec/fb_graph/connections/music_spec.rb",
+     "spec/fb_graph/connections/noreply_spec.rb",
+     "spec/fb_graph/connections/notes_spec.rb",
+     "spec/fb_graph/connections/photos_spec.rb",
+     "spec/fb_graph/connections/picture_spec.rb",
+     "spec/fb_graph/connections/posts_spec.rb",
+     "spec/fb_graph/connections/statuses_spec.rb",
+     "spec/fb_graph/connections/subscriptions_spec.rb",
+     "spec/fb_graph/connections/tagged_spec.rb",
+     "spec/fb_graph/connections/television_spec.rb",
+     "spec/fb_graph/connections/videos_spec.rb",
+     "spec/fb_graph/education_spec.rb",
+     "spec/fb_graph/event_spec.rb",
+     "spec/fb_graph/group_spec.rb",
+     "spec/fb_graph/insight_spec.rb",
+     "spec/fb_graph/link_spec.rb",
+     "spec/fb_graph/node_spec.rb",
+     "spec/fb_graph/note_spec.rb",
+     "spec/fb_graph/page_spec.rb",
+     "spec/fb_graph/photo_spec.rb",
+     "spec/fb_graph/post_spec.rb",
+     "spec/fb_graph/status_spec.rb",
+     "spec/fb_graph/subscription_spec.rb",
+     "spec/fb_graph/tag_spec.rb",
+     "spec/fb_graph/user_spec.rb",
+     "spec/fb_graph/venue_spec.rb",
+     "spec/fb_graph/video_spec.rb",
+     "spec/fb_graph/work_spec.rb",
+     "spec/helpers/fake_json_helper.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_runtime_dependency(%q<rest-client>, [">= 1.4"])
+      s.add_runtime_dependency(%q<oauth2>, [">= 0.0.10"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<fakeweb>, [">= 0"])
+    else
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<rest-client>, [">= 1.4"])
+      s.add_dependency(%q<oauth2>, [">= 0.0.10"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<fakeweb>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<rest-client>, [">= 1.4"])
+    s.add_dependency(%q<oauth2>, [">= 0.0.10"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<fakeweb>, [">= 0"])
+  end
+end
+

data/lib/fb_graph.rb

@@ -0,0 +1,75 @@
+require 'rubygems'
+require 'json'
+require 'restclient'
+require 'oauth2'
+
+# NOTE:
+# For some reason, ActiveSupport 3.0.0 doesn'tj load whole code.
+# Load needed extention directly for now.
+require 'active_support/core_ext'
+
+module FbGraph
+  ROOT_URL = "https://graph.facebook.com"
+
+  class Exception < StandardError
+    attr_accessor :code, :type, :message
+    def initialize(code, message, body = '')
+      @code = code
+      if body.blank?
+        @message = message
+      else
+        response = JSON.parse(body).with_indifferent_access
+        @message = response[:error][:message]
+        @type = response[:error][:type]
+      end
+    end
+  end
+
+  class BadRequest < FbGraph::Exception
+    def initialize(message, body = '')
+      super 400, message, body
+    end
+  end
+
+  class Unauthorized < FbGraph::Exception
+    def initialize(message, body = '')
+      super 401, message, body
+    end
+  end
+
+  class NotFound < FbGraph::Exception
+    def initialize(message, body = '')
+      super 404, message, body
+    end
+  end
+
+end
+
+require 'fb_graph/auth'
+require 'fb_graph/comparison'
+require 'fb_graph/collection'
+require 'fb_graph/connection'
+require 'fb_graph/connections'
+require 'fb_graph/searchable'
+
+require 'fb_graph/node'
+require 'fb_graph/album'
+require 'fb_graph/application'
+require 'fb_graph/checkin'
+require 'fb_graph/comment'
+require 'fb_graph/education'
+require 'fb_graph/event'
+require 'fb_graph/group'
+require 'fb_graph/insight'
+require 'fb_graph/link'
+require 'fb_graph/note'
+require 'fb_graph/page'
+require 'fb_graph/photo'
+require 'fb_graph/post'
+require 'fb_graph/status'
+require 'fb_graph/subscription'
+require 'fb_graph/tag'
+require 'fb_graph/user'
+require 'fb_graph/venue'
+require 'fb_graph/video'
+require 'fb_graph/work'

data/lib/fb_graph/album.rb

@@ -0,0 +1,133 @@
+module FbGraph
+  # = Authentication
+  #
+  # * Access token is required to fetch album info.
+  #
+  # = Attributes
+  #
+  # +from+::         FbGraph::User or FbGraph::Page
+  # +name+::         String
+  # +description+::  String
+  # +location+::     String <em>ex.) "NYC"</em>
+  # +link+::         String
+  # +privacy+::      String <em>ex.) "everyone"</em>
+  # +count+::        Integer
+  # +created_time+:: Time (UTC)
+  # +updated_time+:: Time (UTC)
+  #
+  # = Connections
+  #
+  # +photos+::   Array of FbGraph::Photo
+  # +comments+:: Array of FbGraph::Comment
+  # +likes+::    Array of FbGraph::Page
+  #
+  # = Examples
+  #
+  # == Fetch album info
+  #
+  #   album = FbGraph::Album.new(ALBUM_ID)
+  #   album.fetch(:access_token => ACCESS_TOKEN)
+  #
+  # or
+  #
+  #   FbGraph::album.fetch(ALBUM_ID, :access_token => ACCESS_TOKEN)
+  #
+  # == Fetch connection
+  #
+  #   photos = album.photos
+  #   likes = album.likes
+  #   comments = album.comments
+  #
+  # === Pagination
+  #
+  #   photos = album.photos
+  #   photos_next = photos.next
+  #   photos_previous = photos.previous
+  #   photos = album.photos(:since => '2010-09-01', :until => '2010-10-01')
+  #   photos = album.photos(:offset => 20, :limit => 20)
+  #
+  # == Creat new album
+  #
+  # See RDoc for FbGraph::Connections::Albums
+  #
+  # == Upload a photo
+  #
+  #   album.photo!(
+  #     :image => File.new(File.join(File.dirname(__FILE__), 'nov.gif')),
+  #     :name => "name",
+  #     :message => 'message'
+  #   )
+  #
+  # == Post a comment
+  #
+  #   album.comment!(
+  #     :access_token => ACCESS_TOKEN,
+  #     :message => 'Hey, I\'m testing you!'
+  #   )
+  #
+  # == Delete a comment
+  #
+  #   comment = album.comments.last
+  #   comment.destroy
+  #
+  # == Like and unlike
+  #
+  #   album.like!
+  #   album.unlike!
+  #
+  # = Notes
+  #
+  # == Attribute +from+
+  #
+  # Both facebook user and page can have albums, so +from+ can be either FbGraph::User or FbGraph::Page.
+  # * When you called +ablums+ connection of FbGraph::User, all +from+ should be FbGraph::User.
+  # * When you called +ablums+ connection of FbGraph::Page, all +from+ should be FbGraph::Page.
+  # * When you fetched an album by objedt id, +from+ can be either FbGraph::User or FbGraph::Page.
+  #
+  # == Cached +comments+
+  #
+  # When album object fetched, several comments are included in the response.
+  # So first time you called +album.comments+, those cached comments will be returned.
+  # If you put any option parameter like +album.comments(:access_token => ACCESS_TOKEN)+,
+  # fb_graph ignores those cached comments and fetch comments via Graph API.
+  #
+  # <em>If cached "album.comments" are blank, probably the album has no comments yet.</em>
+  class Album < Node
+    include Connections::Photos
+    include Connections::Comments
+    include Connections::Likes
+
+    attr_accessor :from, :name, :description, :location, :link, :privacy, :count, :created_time, :updated_time
+
+    def initialize(identifier, attributes = {})
+      super
+      @from = if (from = attributes[:from])
+        if from[:category]
+          FbGraph::Page.new(from.delete(:id), from)
+        else
+          FbGraph::User.new(from.delete(:id), from)
+        end
+      end
+      @name = attributes[:name]
+      # NOTE:
+      # for some reason, facebook uses different parameter names.
+      # "description" in GET & "message" in POST
+      # TODO:
+      # check whether this issue is solved or not
+      @description = attributes[:description] || attributes[:message]
+      @location    = attributes[:location]
+      @link        = attributes[:link]
+      @privacy     = attributes[:privacy]
+      @count       = attributes[:count]
+      @created_time = if attributes[:created_time]
+        Time.parse(attributes[:created_time]).utc
+      end
+      @updated_time = if attributes[:updated_time]
+        Time.parse(attributes[:updated_time]).utc
+      end
+
+      # cached connection
+      @_comments_ = FbGraph::Collection.new(attributes[:comments])
+    end
+  end
+end