mogli 0.0.16 → 0.0.17

data/lib/mogli/authenticator.rb

@@ -30,6 +30,18 @@ module Mogli
                    :client_secret => secret,
                    :sessions => keystr})
     end
+    
+    def get_access_token_for_application
+      client = Mogli::Client.new
+      request = client.class.post(client.api_path('oauth/access_token'),
+        :body=> {
+          :grant_type => 'client_credentials',
+          :client_id => client_id,
+          :client_secret => secret
+        }
+      )
+      request.parsed_response.split('=').last
+  end
 
   end
 end

data/lib/mogli/client.rb

@@ -17,6 +17,8 @@ module Mogli
     class OAuthAccessTokenException < ClientException; end
     class OAuthUnauthorizedClientException < ClientException; end
     class OAuthException < ClientException; end
+    # represents case that the facebook limit on posts to a feed has been exceeded
+    class FeedActionRequestLimitExceeded < ClientException; end
 
     def api_path(path)
       "https://graph.facebook.com/#{path}"
@@ -52,12 +54,16 @@ module Mogli
     end
     
     def self.raise_client_exception(post_data)
-      type=post_data["error"]["type"]
-      message=post_data["error"]["message"]
-      if Mogli::Client.const_defined?(type)
-        raise Mogli::Client.const_get(type).new(message) 
+      raise_error_by_type_and_message(post_data["error"]["type"], post_data["error"]["message"])
+    end
+
+    def self.raise_error_by_type_and_message(type, message)
+      if type == 'OAuthException' && message =~ /Feed action request limit reached/
+        raise FeedActionRequestLimitExceeded.new(message)
+      elsif Mogli::Client.const_defined?(type)
+        raise Mogli::Client.const_get(type).new(message)
       else
-        raise ClientException.new("#{type}: #{message}")      
+        raise ClientException.new("#{type}: #{message}")
       end
     end
     
@@ -73,6 +79,12 @@ module Mogli
       new(access_data['access_token'],
           Time.now.to_i + access_data['expires'].to_i)
     end
+    
+    def self.create_and_authenticate_as_application(client_id, secret)
+      authenticator = Mogli::Authenticator.new(client_id, secret, nil)
+      access_data = authenticator.get_access_token_for_application
+      new(access_data)
+    end
 
     def post(path,klass,body_args)
       data = self.class.post(api_path(path),:body=>default_params.merge(body_args))
@@ -158,10 +170,7 @@ module Mogli
     def raise_error_if_necessary(data)
       if data.kind_of?(Hash)
         if data.keys.size == 1 and data["error"]
-          type = data["error"]["type"]
-          message = data["error"]["message"]
-          raise Mogli::Client.const_get(type).new(message) if Mogli::Client.const_defined?(type)
-          raise ClientException.new("#{type}: #{message}")
+          self.class.raise_error_by_type_and_message(data["error"]["type"], data["error"]["message"])
         end
       end
     end

data/lib/mogli/page.rb

@@ -5,7 +5,7 @@ module Mogli
     define_properties :id, :name, :category, :username, :access_token
 
     # General
-    define_properties :fan_count, :link, :picture, :has_added_app
+    define_properties :likes, :link, :picture, :has_added_app, :website, :description, :can_post
 
     # Retail
     define_properties :founded, :products, :mission, :company_overview

data/lib/mogli/user.rb

@@ -26,5 +26,91 @@ module Mogli
     has_association :likes, "Page"
     has_association :home, "Post"
     has_association :accounts, "Page"
+
+    attr_reader :extended_permissions
+
+    # raised when asked to check for a permission that mogli doesn't know about
+    class UnrecognizedExtendedPermissionException < Exception; end
+
+    # the entire list of extended permissions the user is able to grant the
+    # application. the list should be kept in sync with
+    # http://developers.facebook.com/docs/authentication/permissions
+    ALL_EXTENDED_PERMISSIONS = [
+      # publishing permissions
+      :publish_stream,
+      :create_event,
+      :rsvp_event,
+      :sms,
+      :offline_access,
+      :publish_checkins,
+
+      # data permissions
+      :user_about_me,
+      :user_activities,
+      :user_birthday,
+      :user_education_history,
+      :user_events,
+      :user_groups,
+      :user_hometown,
+      :user_interests,
+      :user_likes,
+      :user_location,
+      :user_notes,
+      :user_online_presence,
+      :user_photo_video_tags,
+      :user_photos,
+      :user_relationships,
+      :user_relationship_details,
+      :user_religion_politics,
+      :user_status,
+      :user_videos,
+      :user_website,
+      :user_work_history,
+      :email,
+      :read_friendlists,
+      :read_insights,
+      :read_mailbox,
+      :read_requests,
+      :read_stream,
+      :xmpp_login,
+      :ads_management,
+      :user_checkins,
+
+      # page permissions
+      :manage_pages
+    ]
+
+    # check if the facebook user has a specific permission. the permission arg
+    # is a symbol matching the facebook extended permission names exactly:
+    # http://developers.facebook.com/docs/authentication/permissions
+    def has_permission?(permission)
+      if !ALL_EXTENDED_PERMISSIONS.include? permission
+        raise UnrecognizedExtendedPermissionException,
+              "The requested permission is not recognized as a facebook extended permission: '#{permission}'"
+      end
+
+      if !defined?(@extended_permissions)
+        fetch_permissions
+      end
+
+      extended_permissions[permission]
+    end
+
+    private
+
+    # queries all extended permissions for this user for the current application
+    # caches a hash of permission names => boolean indicating if the user has
+    # granted the specified permission to this app
+    def fetch_permissions
+      fql = "SELECT #{ALL_EXTENDED_PERMISSIONS.map(&:to_s).join(',')} " +
+            "FROM permissions " +
+            "WHERE uid = #{self.id}"
+      @extended_permissions = {}
+      perms_query_result = client.fql_query(fql).parsed_response.first
+      ALL_EXTENDED_PERMISSIONS.each do |perm|
+        @extended_permissions[perm] = (perms_query_result[perm.to_s] == 1)
+      end
+    end
+
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: mogli
 version: !ruby/object:Gem::Version 
-  hash: 63
+  hash: 61
   prerelease: false
   segments: 
   - 0
   - 0
-  - 16
-  version: 0.0.16
+  - 17
+  version: 0.0.17
 platform: ruby
 authors: 
 - Mike Mangino
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-08 00:00:00 -05:00
+date: 2011-01-11 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency