mmangino-facebooker 1.0.31 → 1.0.32

data/CHANGELOG.rdoc

@@ -1,3 +1,10 @@
+=== HEAD
+
+* New Features
+
+  * Facebooker::User#publish_to for publishing to a Wall or News Stream
+  * Optionally parses with Nokogiri.  Just require 'nokogiri' in your app.
+
 === 1.0.13 / 2009-02-26
 
 * Modified fql_query to return results as Hashes as a last resort [Alan Larkin]

data/facebooker.gemspec

@@ -2,17 +2,12 @@
 
 Gem::Specification.new do |s|
   s.name = %q{facebooker}
-  s.version = "1.0.31"
+  s.version = "1.0.32"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Chad Fowler", "Patrick Ewing", "Mike Mangino", "Shane Vitarana", "Corey Innis"]
-  s.date = %q{2009-04-30}
-  s.description = %q{Facebooker is a Ruby wrapper over the Facebook[http://facebook.com] {REST API}[http://wiki.developers.facebook.com/index.php/API].  Its goals are:
-
-* Idiomatic Ruby
-* No dependencies outside of the Ruby standard library (This is true with Rails 2.1. Previous Rails versions require the JSON gem)
-* Concrete classes and methods modeling the Facebook data, so it's easy for a Rubyist to understand what's available
-* Well tested}
+  s.date = %q{2009-05-12}
+  s.description = %q{Facebooker is a Ruby wrapper over the Facebook[http://facebook.com] {REST API}[http://wiki.developers.facebook.com/index.php/API].  Its goals are:  * Idiomatic Ruby * No dependencies outside of the Ruby standard library (This is true with Rails 2.1. Previous Rails versions require the JSON gem) * Concrete classes and methods modeling the Facebook data, so it's easy for a Rubyist to understand what's available * Well tested}
   s.email = %q{mmangino@elevatedrails.com}
   s.extra_rdoc_files = ["Manifest.txt", "CHANGELOG.rdoc", "COPYING.rdoc", "README.rdoc", "TODO.rdoc"]
   s.files = [".autotest", "CHANGELOG.rdoc", "COPYING.rdoc", "Manifest.txt", "README.rdoc", "Rakefile", "TODO.rdoc", "examples/desktop_login.rb", "facebooker.gemspec", "generators/facebook/facebook_generator.rb", "generators/facebook/templates/config/facebooker.yml", "generators/facebook/templates/public/javascripts/facebooker.js", "generators/facebook_controller/USAGE", "generators/facebook_controller/facebook_controller_generator.rb", "generators/facebook_controller/templates/controller.rb", "generators/facebook_controller/templates/functional_test.rb", "generators/facebook_controller/templates/helper.rb", "generators/facebook_controller/templates/view.fbml.erb", "generators/facebook_controller/templates/view.html.erb", "generators/facebook_publisher/facebook_publisher_generator.rb", "generators/facebook_publisher/templates/create_facebook_templates.rb", "generators/facebook_publisher/templates/publisher.rb", "generators/facebook_scaffold/USAGE", "generators/facebook_scaffold/facebook_scaffold_generator.rb", "generators/facebook_scaffold/templates/controller.rb", "generators/facebook_scaffold/templates/facebook_style.css", "generators/facebook_scaffold/templates/functional_test.rb", "generators/facebook_scaffold/templates/helper.rb", "generators/facebook_scaffold/templates/layout.fbml.erb", "generators/facebook_scaffold/templates/layout.html.erb", "generators/facebook_scaffold/templates/style.css", "generators/facebook_scaffold/templates/view_edit.fbml.erb", "generators/facebook_scaffold/templates/view_edit.html.erb", "generators/facebook_scaffold/templates/view_index.fbml.erb", "generators/facebook_scaffold/templates/view_index.html.erb", "generators/facebook_scaffold/templates/view_new.fbml.erb", "generators/facebook_scaffold/templates/view_new.html.erb", "generators/facebook_scaffold/templates/view_show.fbml.erb", "generators/facebook_scaffold/templates/view_show.html.erb", "generators/publisher/publisher_generator.rb", "generators/xd_receiver/templates/xd_receiver.html", "generators/xd_receiver/xd_receiver_generator.rb", "init.rb", "install.rb", "lib/facebooker.rb", "lib/facebooker/adapters/adapter_base.rb", "lib/facebooker/adapters/bebo_adapter.rb", "lib/facebooker/adapters/facebook_adapter.rb", "lib/facebooker/admin.rb", "lib/facebooker/batch_request.rb", "lib/facebooker/data.rb", "lib/facebooker/feed.rb", "lib/facebooker/logging.rb", "lib/facebooker/mobile.rb", "lib/facebooker/mock/service.rb", "lib/facebooker/mock/session.rb", "lib/facebooker/model.rb", "lib/facebooker/models/affiliation.rb", "lib/facebooker/models/album.rb", "lib/facebooker/models/applicationproperties.rb", "lib/facebooker/models/applicationrestrictions.rb", "lib/facebooker/models/cookie.rb", "lib/facebooker/models/education_info.rb", "lib/facebooker/models/event.rb", "lib/facebooker/models/friend_list.rb", "lib/facebooker/models/group.rb", "lib/facebooker/models/info_item.rb", "lib/facebooker/models/info_section.rb", "lib/facebooker/models/location.rb", "lib/facebooker/models/notifications.rb", "lib/facebooker/models/page.rb", "lib/facebooker/models/photo.rb", "lib/facebooker/models/tag.rb", "lib/facebooker/models/user.rb", "lib/facebooker/models/video.rb", "lib/facebooker/models/work_info.rb", "lib/facebooker/parser.rb", "lib/facebooker/rails/controller.rb", "lib/facebooker/rails/cucumber.rb", "lib/facebooker/rails/cucumber/world.rb", "lib/facebooker/rails/extensions/action_controller.rb", "lib/facebooker/rails/extensions/rack_setup.rb", "lib/facebooker/rails/extensions/routing.rb", "lib/facebooker/rails/facebook_form_builder.rb", "lib/facebooker/rails/facebook_pretty_errors.rb", "lib/facebooker/rails/facebook_request_fix.rb", "lib/facebooker/rails/facebook_session_handling.rb", "lib/facebooker/rails/facebook_url_helper.rb", "lib/facebooker/rails/facebook_url_rewriting.rb", "lib/facebooker/rails/helpers.rb", "lib/facebooker/rails/helpers/fb_connect.rb", "lib/facebooker/rails/integration_session.rb", "lib/facebooker/rails/profile_publisher_extensions.rb", "lib/facebooker/rails/publisher.rb", "lib/facebooker/rails/routing.rb", "lib/facebooker/rails/test_helpers.rb", "lib/facebooker/rails/utilities.rb", "lib/facebooker/server_cache.rb", "lib/facebooker/service.rb", "lib/facebooker/session.rb", "lib/facebooker/version.rb", "lib/net/http_multipart_post.rb", "lib/rack/facebook.rb", "lib/tasks/facebooker.rake", "lib/tasks/tunnel.rake", "rails/init.rb", "setup.rb", "templates/layout.erb", "test/facebooker/adapters_test.rb", "test/facebooker/admin_test.rb", "test/facebooker/batch_request_test.rb", "test/facebooker/data_test.rb", "test/facebooker/logging_test.rb", "test/facebooker/mobile_test.rb", "test/facebooker/model_test.rb", "test/facebooker/models/event_test.rb", "test/facebooker/models/user_test.rb", "test/facebooker/rails/publisher_test.rb", "test/facebooker/rails_integration_test.rb", "test/facebooker/server_cache_test.rb", "test/facebooker/session_test.rb", "test/facebooker_test.rb", "test/fixtures/multipart_post_body_with_only_parameters.txt", "test/fixtures/multipart_post_body_with_single_file.txt", "test/fixtures/multipart_post_body_with_single_file_that_has_nil_key.txt", "test/net/http_multipart_post_test.rb", "test/rack/facebook_test.rb", "test/rails_test_helper.rb", "test/test_helper.rb"]
@@ -21,23 +16,23 @@ Gem::Specification.new do |s|
   s.rdoc_options = ["--main", "README.rdoc"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{facebooker}
-  s.rubygems_version = %q{1.3.2}
+  s.rubygems_version = %q{1.3.1}
   s.summary = %q{Facebooker is a Ruby wrapper over the Facebook[http://facebook.com] {REST API}[http://wiki.developers.facebook.com/index.php/API]}
-  s.test_files = ["test/facebooker/adapters_test.rb", "test/facebooker/admin_test.rb", "test/facebooker/batch_request_test.rb", "test/facebooker/data_test.rb", "test/facebooker/logging_test.rb", "test/facebooker/mobile_test.rb", "test/facebooker/model_test.rb", "test/facebooker/models/event_test.rb", "test/facebooker/models/user_test.rb", "test/facebooker/rails/publisher_test.rb", "test/facebooker/rails_integration_test.rb", "test/facebooker/server_cache_test.rb", "test/facebooker/session_test.rb", "test/facebooker_test.rb", "test/net/http_multipart_post_test.rb", "test/rack/facebook_test.rb"]
+  s.test_files = ["test/facebooker_test.rb", "test/facebooker/adapters_test.rb", "test/facebooker/admin_test.rb", "test/facebooker/batch_request_test.rb", "test/facebooker/data_test.rb", "test/facebooker/logging_test.rb", "test/facebooker/mobile_test.rb", "test/facebooker/model_test.rb", "test/facebooker/rails_integration_test.rb", "test/facebooker/server_cache_test.rb", "test/facebooker/session_test.rb", "test/facebooker/models/event_test.rb", "test/facebooker/models/user_test.rb", "test/facebooker/rails/publisher_test.rb", "test/net/http_multipart_post_test.rb", "test/rack/facebook_test.rb"]
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
+    s.specification_version = 2
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<json>, [">= 1.0.0"])
-      s.add_development_dependency(%q<hoe>, [">= 1.12.1"])
+      s.add_development_dependency(%q<hoe>, [">= 1.11.0"])
     else
       s.add_dependency(%q<json>, [">= 1.0.0"])
-      s.add_dependency(%q<hoe>, [">= 1.12.1"])
+      s.add_dependency(%q<hoe>, [">= 1.11.0"])
     end
   else
     s.add_dependency(%q<json>, [">= 1.0.0"])
-    s.add_dependency(%q<hoe>, [">= 1.12.1"])
+    s.add_dependency(%q<hoe>, [">= 1.11.0"])
   end
 end

data/generators/facebook/templates/public/javascripts/facebooker.js

@@ -46,9 +46,8 @@ function encodeURIComponent(str) {
   }
 };
 
-var Form = {};
 Form.serialize = function(form_element) {
-  return $(form_element).serialize();
+  return  $(form_element).serialize();  
 };
 
 Ajax.Updater = function (container,url,options) {
@@ -69,22 +68,7 @@ Ajax.Updater = function (container,url,options) {
     this.ajax.onerror = options["onFailure"];
   }
 
-  // Yes, this is an excercise in undoing what we just did
-  // FB doesn't provide encodeURI, but they will encode things passed as a hash
-  // so we turn it into a string, esaping & and =
-  // then we split it all back out here
-  // this could be killed if encodeURIComponent was available
-  parameters={};
-  if (options['parameters']) {
-    pairs=options['parameters'].split('&'); 
-    for (var i=0; i<pairs.length; i++) {
-      kv=pairs[i].split('=');
-      key=kv[0].replace(/%3D/g,'=').replace(/%26/g,'&');
-      val=kv[1].replace(/%3D/g,'=').replace(/%26/g,'&');
-      parameters[key]=val;
-    }
-  }
-  this.ajax.post(url,parameters); 
+  this.ajax.post(url,options['parameters']); 
   if (options["onLoading"]) {
      options["onLoading"].call() 
   }

data/install.rb

@@ -9,4 +9,4 @@ script = File.join('public', 'javascripts', 'facebooker.js')
 [config, script].each do |path| 
   FileUtils.cp File.join(templates, path), File.join(RAILS_ROOT, path) unless File.exist?(File.join(RAILS_ROOT, path))
 end
-puts IO.read(File.join(dir, 'README'))
+puts IO.read(File.join(dir, 'README.rdoc'))

data/lib/facebooker/adapters/bebo_adapter.rb

@@ -1,14 +1,14 @@
 module Facebooker
   class BeboAdapter < AdapterBase
-      
+
     def canvas_server_base
       "apps.bebo.com"
     end
-      
+
     def api_server_base
       'apps.bebo.com'
     end
-    
+
     def api_rest_path
       "/restserver.php"
     end
@@ -44,9 +44,9 @@ module Facebooker
     end
     alias_method :set_profile_fbml_without_bebo_adapter, :set_profile_fbml
     alias_method :set_profile_fbml, :set_profile_fbml_with_bebo_adapter
-    
+
     private
-    
+
     BEBO_FIELDS = FIELDS - [:meeting_sex, :wall_count, :meeting_for]
 
     remove_method :collect
@@ -57,15 +57,15 @@ module Facebooker
       else
          FIELDS.reject{|field_name| !fields.empty? && !fields.include?(field_name)}.join(',')
       end
-    end   
+    end
   end
-  
-  
+
+
    class PublishTemplatizedAction < Parser#:nodoc:
     class <<self
      def process_with_bebo_adapter(data)
        if(Facebooker.is_for?(:bebo))
-       element('feed_publishTemplatizedAction_response', data).text_value
+       element('feed_publishTemplatizedAction_response', data).content
        else
          process_without_bebo_adapter(data)
        end

data/lib/facebooker/data.rb

@@ -3,7 +3,7 @@ module Facebooker
     def initialize(session)
       @session = session
     end
-    
+
     ##
     # ** BETA ***
     # Sets a cookie on Facebook
@@ -11,32 +11,32 @@ module Facebooker
     # +name+ Name of the cookie
     # +value+ Value of the cookie
     # Optional:
-    # +expires+ Time when the cookie should expire. If not specified, the cookie never expires. 
+    # +expires+ Time when the cookie should expire. If not specified, the cookie never expires.
     # +path+ Path relative to the application's callback URL, with which the cookie should be associated. (default value is /?
     def set_cookie(user, name, value, expires=nil, path=nil)
-      @session.post('facebook.data.setCookie', 
-        :uid => User.cast_to_facebook_id(user), 
-        :name => name, 
-        :value => value, 
-        :expires => expires, 
+      @session.post('facebook.data.setCookie',
+        :uid => User.cast_to_facebook_id(user),
+        :name => name,
+        :value => value,
+        :expires => expires,
         :path => path) {|response| response == '1'}
     end
-    
+
     ##
     # ** BETA ***
     # Gets a cookie stored on Facebook
-    # +user+	The user from whom to get the cookies.	
-    # Optional:   
+    # +user+	The user from whom to get the cookies.
+    # Optional:
     # +name+ The name of the cookie. If not specified, all the cookies for the given user get returned.
     def get_cookies(user, name=nil)
-      @cookies = @session.post( 
+      @cookies = @session.post(
         'facebook.data.getCookies', :uid => User.cast_to_facebook_id(user), :name => name) do |response|
           response.map do |hash|
             Cookie.from_hash(hash)
           end
       end
-    end   
-    
+    end
+
     ##
     # ** BETA ***
     # Gets a preference stored on Facebook
@@ -54,4 +54,4 @@ module Facebooker
       @session.post('facebook.data.setUserPreference', :pref_id=>pref_id, :value=>value)
     end
   end
-end
+end

data/lib/facebooker/models/user.rb

@@ -69,47 +69,75 @@ module Facebooker
     # Set the list of friends, given an array of User objects.  If the list has been retrieved previously, will not set
     def friends=(list_of_friends,flid=nil)
       @friends_hash ||= {}
-     	flid=cast_to_friend_list_id(flid)
-     	#use __blank instead of nil so that this is cached
-     	cache_key = flid||"__blank"
-     	
+       flid=cast_to_friend_list_id(flid)
+       #use __blank instead of nil so that this is cached
+       cache_key = flid||"__blank"
+
       @friends_hash[cache_key] ||= list_of_friends
     end
     
     def cast_to_friend_list_id(flid)
       case flid
- 	    when String
- 	      list=friend_lists.detect {|f| f.name==flid}
- 	      raise Facebooker::Session::InvalidFriendList unless list
- 	      list.flid
- 	    when FriendList
- 	      flid.flid
- 	    else
- 	      flid
- 	    end
- 	  end
+       when String
+         list=friend_lists.detect {|f| f.name==flid}
+         raise Facebooker::Session::InvalidFriendList unless list
+         list.flid
+       when FriendList
+         flid.flid
+       else
+         flid
+       end
+     end
     ##
     # Retrieve friends
     def friends(flid = nil)
-     	@friends_hash ||= {}
-     	flid=cast_to_friend_list_id(flid)
-      
-     	#use __blank instead of nil so that this is cached
-     	cache_key = flid||"__blank"
-     	options = {:uid=>self.id}
-     	options[:flid] = flid unless flid.nil?
-     	@friends_hash[cache_key] ||= @session.post('facebook.friends.get', options,false).map do |uid|
+       @friends_hash ||= {}
+       flid=cast_to_friend_list_id(flid)
+
+       #use __blank instead of nil so that this is cached
+       cache_key = flid||"__blank"
+       options = {:uid=>self.id}
+       options[:flid] = flid unless flid.nil?
+       @friends_hash[cache_key] ||= @session.post('facebook.friends.get', options,false).map do |uid|
           User.new(uid, @session)
       end
       @friends_hash[cache_key]
     end
-    
-     def friend_lists    
+
+    ###
+    # Publish a post into the stream on the user's Wall and News Feed.  This
+    # post also appears in the user's friend's streams.  The +publish_stream+
+    # extended permission must be granted in order to use this method.
+    #
+    # See: http://wiki.developers.facebook.com/index.php/Stream.publish
+    #
+    # +target+ can be the current user or some other user.
+    #
+    # Example:
+    #   # Publish a message to my own wall:
+    #   me.publish_to(me, :message => 'hello world')
+    #
+    #   # Publish to a friend's wall with an action link:
+    #   me.publish_to(my_friend,  :message => 'how are you?', :action_links => [
+    #     :text => 'my website',
+    #     :href => 'http://tenderlovemaking.com/'
+    #   ])
+    def publish_to target, options = {}
+      @session.post('facebook.stream.publish',
+                    :uid        => self.id,
+                    :target_id  => target.id,
+                    :message    => options[:message],
+                    :attachment => options[:attachment],
+                    :action_links => options[:action_links]
+                   )
+    end
+
+     def friend_lists
        @friend_lists ||= @session.post('facebook.friends.getLists').map do |hash|
-         friend_list = FriendList.from_hash(hash)                               
-         friend_list.session = session                                          
-         friend_list                                                            
-       end                                                                      
+         friend_list = FriendList.from_hash(hash)
+         friend_list.session = session
+         friend_list
+       end
      end
     ###
     # Retrieve friends with user info populated