palidanx-fb_graph 1.0.4

data/lib/fb_graph/connections/notes.rb

@@ -0,0 +1,21 @@
+module FbGraph
+  module Connections
+    module Notes
+      def notes(options = {})
+        notes = self.connection(:notes, options)
+        notes.map! do |note|
+          Note.new(note.delete(:id), note.merge(
+            :access_token => options[:access_token] || self.access_token
+          ))
+        end
+      end
+
+      def note!(options = {})
+        note = post(options.merge(:connection => 'notes'))
+        Note.new(note.delete(:id), options.merge(note).merge(
+          :access_token => options[:access_token] || self.access_token
+        ))
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/photos.rb

@@ -0,0 +1,21 @@
+module FbGraph
+  module Connections
+    module Photos
+      def photos(options = {})
+        photos = self.connection(:photos, options)
+        photos.map! do |photo|
+          Photo.new(photo.delete(:id), photo.merge(
+            :access_token => options[:access_token] || self.access_token
+          ))
+        end
+      end
+
+      def photo!(options = {})
+        photo = post(options.merge(:connection => 'photos'))
+        Photo.new(photo.delete(:id), options.merge(photo).merge(
+          :access_token => options[:access_token] || self.access_token
+        ))
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/picture.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  module Connections
+    module Picture
+      def picture(size = nil)
+        _endpoint_ = "#{self.endpoint}/picture"
+        if size
+          "#{_endpoint_}?type=#{size}"
+        else
+          _endpoint_
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/posts.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  module Connections
+    module Posts
+      def posts(options = {})
+        posts = self.connection(:posts, options)
+        posts.map! do |post|
+          Post.new(post.delete(:id), post.merge(
+            :access_token => options[:access_token] || self.access_token
+          ))
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/statuses.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  module Connections
+    module Statuses
+      def statuses(options = {})
+        statuses = self.connection(:statuses, options)
+        statuses.map! do |status|
+          Status.new(status.delete(:id), status.merge(
+            :access_token => options[:access_token] || self.access_token
+          ))
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/subscriptions.rb

@@ -0,0 +1,53 @@
+module FbGraph
+  module Connections
+    module Subscriptions
+      # == Fetch current subscriptions
+      # 
+      #   app = FbGraph::Application.new(APP_ID, :secret => APP_SECRET)
+      #   app.subscriptions
+      #   => Array of FbGraph::Subscriptions
+      def subscriptions(options = {})
+        options[:access_token] ||= self.access_token || get_access_token(options[:secret])
+        subscriptions = self.connection(:subscriptions, options)
+        subscriptions.map! do |subscription|
+          Subscription.new(subscription.merge(:access_token => options[:access_token]))
+        end
+      end
+
+      # == Subscribe
+      # 
+      # Subscriber have to setup PubSubHubbub subscriber endpoint.
+      # See details at "Subscription Verification" in the Facebook API document.
+      # ref) http://developers.facebook.com/docs/api/realtime
+      # 
+      #   app = FbGraph::Application.new(APP_ID, :secret => APP_SECRET)
+      #   app.subscribe!(
+      #     :object => "user",
+      #     :fields => "name,email",
+      #     :callback_url => "http://fbgraphsample.heroku.com/subscription",
+      #     :verify_token => "Define by yourself"
+      #   )
+      #   => Array of FbGraph::Subscriptions
+      def subscribe!(options = {})
+        options[:access_token] ||= self.access_token || get_access_token(options[:secret])
+        post(options.merge(:connection => 'subscriptions'))
+      end
+
+      # == Subscribe
+      # 
+      # Delete all of your subscriptions.
+      # If you specify an object parameter, it will only delete the corresponding subscription.
+      # ref) http://developers.facebook.com/docs/api/realtime
+      # 
+      #   app = FbGraph::Application.new(APP_ID, :secret => APP_SECRET)
+      #   app.unsubscribe!(
+      #     :object => "user"
+      #   )
+      #   => Array of FbGraph::Subscriptions
+      def unsubscribe!(options = {})
+        options[:access_token] ||= self.access_token || get_access_token(options[:secret])
+        destroy(options.merge(:connection => 'subscriptions'))
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/tagged.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  module Connections
+    module Tagged
+      def tagged(options = {})
+        posts = self.connection(:tagged, options)
+        posts.map! do |post|
+          Post.new(post.delete(:id), post.merge(
+            :access_token => options[:access_token] || self.access_token
+          ))
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/television.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  module Connections
+    module Television
+      def television(options = {})
+        television = self.connection(:television, options)
+        television.map! do |_television_|
+          Page.new(_television_.delete(:id), _television_.merge(
+            :access_token => options[:access_token] || self.access_token
+          ))
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/videos.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  module Connections
+    module Videos
+      def videos(options = {})
+        videos = self.connection(:videos, options)
+        videos.map! do |video|
+          Video.new(video.delete(:id), video.merge(
+            :access_token => options[:access_token] || self.access_token
+          ))
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/education.rb

@@ -0,0 +1,25 @@
+module FbGraph
+  class Education
+    include Comparison
+
+    attr_accessor :school, :degree, :year, :concentration
+
+    def initialize(attributes = {})
+      if (school = attributes[:school])
+        @school = FbGraph::Page.new(school.delete(:id), school)
+      end
+      if (degree = attributes[:degree])
+        @degree = FbGraph::Page.new(degree.delete(:id), degree)
+      end
+      if (year = attributes[:year])
+        @year = FbGraph::Page.new(year.delete(:id), year)
+      end
+      @concentration = []
+      if attributes[:concentration]
+        attributes[:concentration].each do |concentration|
+          @concentration << FbGraph::Page.new(concentration.delete(:id), concentration)
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/event.rb

@@ -0,0 +1,47 @@
+module FbGraph
+  class Event < Node
+    include Connections::Feed
+    include Connections::Noreply
+    include Connections::Maybe
+    include Connections::Invited
+    include Connections::Attending
+    include Connections::Declined
+    include Connections::Picture
+    extend Searchable
+
+    attr_accessor :owner, :name, :description, :start_time, :end_time, :location, :venue, :privacy, :updated_time
+
+    def initialize(identifier, attributes = {})
+      super
+      if (owner = attributes[:owner])
+        @owner = FbGraph::User.new(owner.delete(:id), owner)
+      end
+      @name        = attributes[:name]
+      @description = attributes[:description]
+      @location    = attributes[:location]
+      @privacy     = attributes[:privacy]
+      if (start_time = attributes[:start_time])
+        @start_time = case start_time
+        when String
+          Time.parse(start_time).utc
+        when Fixnum
+          Time.at(start_time).utc
+        end
+      end
+      if (end_time = attributes[:end_time])
+        @end_time = case end_time
+        when String
+          Time.parse(end_time).utc
+        when Fixnum
+          Time.at(end_time).utc
+        end
+      end
+      if attributes[:venue]
+        @venue = FbGraph::Venue.new(attributes[:venue])
+      end
+      if attributes[:updated_time]
+        @updated_time = Time.parse(attributes[:updated_time]).utc
+      end
+    end
+  end
+end

data/lib/fb_graph/group.rb

@@ -0,0 +1,27 @@
+module FbGraph
+  class Group < Node
+    include Connections::Feed
+    include Connections::Members
+    include Connections::Picture
+    include Searchable
+
+    attr_accessor :owner, :name, :description, :link, :venue, :privacy, :updated_time
+
+    def initialize(identifier, attributes = {})
+      super
+      if (owner = attributes[:owner])
+        @owner = FbGraph::User.new(owner.delete(:id), owner)
+      end
+      @name         = attributes[:name]
+      @description  = attributes[:description]
+      @link         = attributes[:link]
+      @privacy      = attributes[:privacy]
+      if attributes[:venue]
+        @venue = FbGraph::Venue.new(attributes[:venue])
+      end
+      if attributes[:updated_time]
+        @updated_time = Time.parse(attributes[:updated_time]).utc
+      end
+    end
+  end
+end

data/lib/fb_graph/insight.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  class Insight
+    include FbGraph::Comparison
+
+    attr_accessor :name, :period, :values, :description
+
+    def initialize(attributes = {})
+      @name   = attributes[:name]
+      @period = attributes[:period]
+      @values = attributes[:values].collect(&:with_indifferent_access)
+      @description = attributes[:description]
+    end
+  end
+end

data/lib/fb_graph/link.rb

@@ -0,0 +1,28 @@
+module FbGraph
+  class Link < Node
+    include Connections::Comments
+
+    attr_accessor :from, :link, :name, :caption, :description, :icon, :picture, :message, :created_time
+
+    def initialize(identifier, attributes = {})
+      super
+      if (from = attributes[:from])
+        @from = if from[:category]
+          FbGraph::Page.new(from.delete(:id), from)
+        else
+          FbGraph::User.new(from.delete(:id), from)
+        end
+      end
+      @name        = attributes[:name]
+      @link        = attributes[:link]
+      @caption     = attributes[:caption]
+      @description = attributes[:description]
+      @icon        = attributes[:icon]
+      @picture     = attributes[:picture] # NOTE: this is external image, so isn't connection.
+      @message     = attributes[:message]
+      if attributes[:created_time]
+        @created_time = Time.parse(attributes[:created_time]).utc
+      end
+    end
+  end
+end

data/lib/fb_graph/node.rb

@@ -0,0 +1,121 @@
+module FbGraph
+  class Node
+    include Comparison
+
+    attr_accessor :identifier, :endpoint, :access_token
+
+    def initialize(identifier, options = {})
+      @identifier   = identifier
+      @endpoint     = File.join(FbGraph::ROOT_URL, identifier.to_s)
+      @access_token = options[:access_token]
+    end
+
+    def fetch(options = {})
+      options[:access_token] ||= self.access_token if self.access_token
+      _fetched_ = get(options)
+      self.class.new(_fetched_.delete(:id), _fetched_.merge(:access_token => options[:access_token]))
+    end
+
+    def self.fetch(identifier, options = {})
+      new(identifier).fetch(options)
+    end
+
+    def connection(connection, options = {})
+      collection = FbGraph::Collection.new(get(options.merge(:connection => connection)))
+      Connection.new(self, connection, options.merge(:collection => collection))
+    end
+
+    def destroy(options = {})
+      options[:access_token] ||= self.access_token if self.access_token
+      delete(options)
+    end
+
+    protected
+
+    def get(params = {})
+      _params_ = stringfy_access_token(params)
+      _endpoint_ = build_endpoint(_params_.merge!(:method => :get))
+      handle_response do
+        RestClient.get(_endpoint_)
+      end
+    end
+
+    def post(params = {})
+      _params_ = stringfy_access_token(params)
+      _endpoint_ = build_endpoint(_params_.merge!(:method => :post))
+      handle_response do
+        RestClient.post(_endpoint_, _params_)
+      end
+    end
+
+    def delete(params = {})
+      _params_ = stringfy_access_token(params)
+      _endpoint_ = build_endpoint(_params_.merge!(:method => :delete))
+      handle_response do
+        # NOTE:
+        # DELETE method didn't work for some reason.
+        # Use POST with "method=delete" for now.
+        RestClient.post(_endpoint_, _params_.merge!(:method => :delete))
+      end
+    end
+
+    private
+
+    def build_endpoint(params = {})
+      _endpoint_ = if params[:connection]
+        File.join(self.endpoint, params.delete(:connection).to_s)
+      else
+        params[:endpoint] || self.endpoint
+      end
+
+      params.delete_if do |k, v|
+        v.blank?
+      end
+      if params.delete(:method) == :get && params.present?
+        _endpoint_ << "?#{params.to_query}"
+      end
+      _endpoint_
+    end
+
+    def stringfy_access_token(params)
+      _params_ = params.dup
+      _params_[:access_token] ||= self.access_token
+      if access_token.is_a?(OAuth2::AccessToken)
+        _params_[:access_token] = _params_[:access_token].token
+      end
+      _params_
+    end
+
+    def handle_response
+      response = yield
+      case response.body
+      when 'true'
+        true
+      when 'false'
+        # NOTE: When the object is not found, Graph API returns
+        #  - error response (JSON) when the identifier contains alphabet (ex. graph.facebook.com/iamnotfound)
+        #  - false when the identifier is only integer + underbar (ex. graph.facebook.com/1234567890, graph.facebook.com/12345_67890)
+        # This is an undocumented behaviour, so facebook might chaange it without any announcement.
+        # I've posted this issue on their forum, so hopefully I'll get a document about Graph API error responses.
+        # ref) http://forum.developers.facebook.com/viewtopic.php?pid=228256#p228256
+        raise FbGraph::NotFound.new('Graph API returned false, so probably it means your requested object is not found.')
+      when 'null'
+        nil
+      else
+        _response_ = JSON.parse(response.body).with_indifferent_access
+        if _response_[:error]
+          case _response_[:error][:type]
+          when 'OAuthAccessTokenException', 'QueryParseException', 'OAuthInvalidRequestException', 'OAuthInvalidTokenException'
+            raise FbGraph::Unauthorized.new(_response_[:error][:message])
+          else
+            raise FbGraph::BadRequest.new("#{_response_[:error][:type]} :: #{_response_[:error][:message]}")
+          end
+        else
+          _response_
+        end
+      end
+    rescue RestClient::Exception => e
+      raise FbGraph::Exception.new(e.http_code, e.message, e.http_body)
+    end
+  end
+end