facebooker 1.0.62 → 1.0.63

data/Manifest.txt

@@ -78,6 +78,7 @@ lib/facebooker/models/tag.rb
 lib/facebooker/models/user.rb
 lib/facebooker/models/video.rb
 lib/facebooker/models/work_info.rb
+lib/facebooker/models/message_thread.rb
 lib/facebooker/parser.rb
 lib/facebooker/rails/backwards_compatible_param_checks.rb
 lib/facebooker/rails/controller.rb

data/facebooker.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |s|
 * Well tested}
   s.email = ["chad@chadfowlwer.com", "", "", "", "", "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_ssl.html", "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/attachment.rb", "lib/facebooker/admin.rb", "lib/facebooker/application.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/family_relative_info.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/backwards_compatible_param_checks.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_request_fix_2-3.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/helpers/stream_publish.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/service/base_service.rb", "lib/facebooker/service/curl_service.rb", "lib/facebooker/service/net_http_service.rb", "lib/facebooker/service/typhoeus_service.rb", "lib/facebooker/service/typhoeus_multi_service.rb", "lib/facebooker/session.rb", "lib/facebooker/stream_post.rb", "lib/facebooker/version.rb", "lib/net/http_multipart_post.rb", "lib/rack/facebook.rb", "lib/rack/facebook_session.rb", "lib/tasks/facebooker.rake", "lib/tasks/facebooker.rb", "lib/tasks/tunnel.rake", "rails/init.rb", "setup.rb", "templates/layout.erb", "test/facebooker/adapters_test.rb", "test/facebooker/admin_test.rb", "test/facebooker/application_test.rb", "test/facebooker/attachment_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/page_test.rb", "test/facebooker/models/photo_test.rb", "test/facebooker/models/user_test.rb", "test/facebooker/rails/publisher_test.rb", "test/facebooker/rails_integration_test.rb", "test/facebooker/rails/facebook_request_fix_2-3_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/rack/facebook_session_test.rb", "test/rails_test_helper.rb", "test/test_helper.rb", "test/facebooker/rails/facebook_url_rewriting_test.rb", "test/facebooker/rails/integration_session_test.rb", "test/facebooker/service_test.rb"]
+  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_ssl.html", "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/attachment.rb", "lib/facebooker/admin.rb", "lib/facebooker/application.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/family_relative_info.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/models/message_thread.rb", "lib/facebooker/parser.rb", "lib/facebooker/rails/backwards_compatible_param_checks.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_request_fix_2-3.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/helpers/stream_publish.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/service/base_service.rb", "lib/facebooker/service/curl_service.rb", "lib/facebooker/service/net_http_service.rb", "lib/facebooker/service/typhoeus_service.rb", "lib/facebooker/service/typhoeus_multi_service.rb", "lib/facebooker/session.rb", "lib/facebooker/stream_post.rb", "lib/facebooker/version.rb", "lib/net/http_multipart_post.rb", "lib/rack/facebook.rb", "lib/rack/facebook_session.rb", "lib/tasks/facebooker.rake", "lib/tasks/facebooker.rb", "lib/tasks/tunnel.rake", "rails/init.rb", "setup.rb", "templates/layout.erb", "test/facebooker/adapters_test.rb", "test/facebooker/admin_test.rb", "test/facebooker/application_test.rb", "test/facebooker/attachment_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/page_test.rb", "test/facebooker/models/photo_test.rb", "test/facebooker/models/user_test.rb", "test/facebooker/rails/publisher_test.rb", "test/facebooker/rails_integration_test.rb", "test/facebooker/rails/facebook_request_fix_2-3_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/rack/facebook_session_test.rb", "test/rails_test_helper.rb", "test/test_helper.rb", "test/facebooker/rails/facebook_url_rewriting_test.rb", "test/facebooker/rails/integration_session_test.rb", "test/facebooker/service_test.rb"]
   s.homepage = %q{http://facebooker.rubyforge.org}
   s.rdoc_options = ["--main", "README.rdoc"]
   s.require_paths = ["lib"]

data/lib/facebooker.rb

@@ -254,6 +254,7 @@ require 'facebooker/models/info_item'
 require 'facebooker/models/info_section'
 require 'facebooker/models/friend_list'
 require 'facebooker/models/video'
+require 'facebooker/models/message_thread'
 require 'facebooker/adapters/adapter_base'
 require 'facebooker/adapters/facebook_adapter'
 require 'facebooker/adapters/bebo_adapter'

data/lib/facebooker/models/message_thread.rb

@@ -0,0 +1,89 @@
+require 'facebooker/model'
+module Facebooker
+  class MessageThread
+    include Model
+    
+    id_is :thread_id
+    attr_accessor :subject, :updated_time, :recipients
+    attr_accessor :parent_message_id, :parent_thread_id, :message_count
+    attr_accessor :snippet, :snippet_author, :object_id, :unread
+    
+    class Message
+      include Model
+      
+      attr_accessor :message_id, :author_id, :body, :created_time, :attachment, :thread_id
+      
+      # An attachment can be a photo, a video, or a link
+      class Attachment
+        include Model
+        
+        attr_accessor :name, :href, :icon, :caption, :description
+        
+        # The Facebook messages API is in beta, this helper method is supposed to fail anytime soon
+        def video?
+          self.href =~ /\Ahttp:\/\/www\.facebook\.com\/video\/video\.php.*/
+        end
+        
+        # The Facebook messages API is in beta, this helper method is supposed to fail anytime soon
+        def photo?
+          self.href =~ /\Ahttp:\/\/www\.facebook\.com\/photo\.php.*/
+        end
+        
+        # The Facebook messages API is in beta, this helper method is supposed to fail anytime soon
+        def link?
+          !video? && !photo?
+        end
+      end
+      hash_settable_accessor :attachment, Facebooker::MessageThread::Message::Attachment
+    end
+    hash_settable_list_accessor :messages, Facebooker::MessageThread::Message
+    
+  end
+end
+
+# Example of attachments
+
+# -- Photo --
+
+# <attachment>
+#   <media list="true"/>
+#   <href>http://www.facebook.com/photo.php?pid=12345&amp;id=54321</href>
+#   <properties list="true"/>
+#   <icon>http://b.static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+#   <fb_object_type/>
+#   <fb_object_id/>
+#   <tagged_ids list="true"/>
+# </attachment>
+
+# -- Webcam video --
+
+# <attachment>
+#   <media list="true"/>
+#   <name>Feb 10, 2010 1:26pm</name>
+#   <href>http://www.facebook.com/video/video.php?v=12345</href>
+#   <properties list="true"/>
+#   <icon>http://static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+#   <fb_object_type/>
+#   <fb_object_id/>
+#   <tagged_ids list="true"/>
+# </attachment>
+
+# -- Link --
+
+# <attachment>
+#   <media list="true">
+#     <stream_media>
+#       <href>http://www.facebook.com/l.php?u=http%253A%252F%252Fwww.google.fr%252F&amp;h=e46dd63cdbfadb74958fbe44e98f339c</href>
+#       <type>link</type>
+#       <src>http://external.ak.fbcdn.net/safe_image.php?d=dd54bba6b6e6479a89bb8084573c02c8&amp;w=90&amp;h=90&amp;url=http%3A%2F%2Fwww.google.fr%2Fintl%2Ffr_fr%2Fimages%2Flogo.gif</src>
+#     </stream_media>
+#   </media>
+#   <name>Google</name>
+#   <href>http://www.facebook.com/l.php?u=http%253A%252F%252Fwww.google.fr%252F&amp;h=e46dd63cdbfadb74958fbe44e98f339c</href>
+#   <caption>www.google.fr</caption>
+#   <properties list="true"/>
+#   <icon>http://b.static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+#   <fb_object_type/>
+#   <fb_object_id/>
+#   <tagged_ids list="true"/>
+# </attachment>

data/lib/facebooker/models/page.rb

@@ -26,7 +26,7 @@ module Facebooker
     end
 
     include Model
-    attr_accessor :page_id,:name,:pic_small,:pic_big,:pic_square,:pic,:pic_large,:type,:website,:has_added_app,:founded,:company_overview,:mission,:products,:location,:parking,:public_transit,:hours,:attire,:payment_options,:culinary_team,:general_manager,:price_range,:restaurant_services,:restaurant_specialties,:release_date,:genre,:starring,:screenplay_by,:directed_by,:produced_by,:studio,:awards,:plot_outline,:network,:season,:schedule,:written_by,:band_members,:hometown,:current_location,:record_label,:booking_agent,:artists_we_like,:influences,:band_interests,:bio,:affiliation,:birthday,:personal_info,:personal_interests,:members,:built,:features,:mpg,:general_info,:fan_count
+    attr_accessor :page_id,:name,:pic_small,:pic_big,:pic_square,:pic,:pic_large,:type,:website,:has_added_app,:founded,:company_overview,:mission,:products,:location,:parking,:public_transit,:hours,:attire,:payment_options,:culinary_team,:general_manager,:price_range,:restaurant_services,:restaurant_specialties,:release_date,:genre,:starring,:screenplay_by,:directed_by,:produced_by,:studio,:awards,:plot_outline,:network,:season,:schedule,:written_by,:band_members,:hometown,:current_location,:record_label,:booking_agent,:artists_we_like,:influences,:band_interests,:bio,:affiliation,:birthday,:personal_info,:personal_interests,:members,:built,:features,:mpg,:general_info,:fan_count,:page_url
     attr_reader :genre
     
     alias_method :id, :page_id

data/lib/facebooker/models/user.rb

@@ -246,6 +246,21 @@ module Facebooker
       end
     end
 
+    ###
+    # Get threads in a folder
+    #
+    # See: http://wiki.developers.facebook.com/index.php/Message.getThreadsInFolder
+    #
+    # +options+ possible options are :folder_id, :limit and :offset
+    def threads(options = {})
+      options ||= {}
+      @threads = session.post('facebook.message.getThreadsInFolder', options) do |response|
+        response.map do |hash|
+          MessageThread.from_hash(hash)
+        end
+      end
+    end
+
     def notifications
       @notifications ||= Notifications.from_hash(session.post('facebook.notifications.get'))
     end

data/lib/facebooker/parser.rb

@@ -330,6 +330,12 @@ module Facebooker
     end
   end
 
+  class MessageGetThreadsInFolder < Parser#:nodoc:
+    def self.process(data)
+      array_of_hashes(element('message_getThreadsInFolder_response', data), 'thread')
+    end
+  end
+
   class NotificationsGet < Parser#:nodoc:
     def self.process(data)
       hashinate(element('notifications_get_response', data))
@@ -636,6 +642,7 @@ module Facebooker
       604 => Facebooker::Session::FQLStatementNotIndexable,
       605 => Facebooker::Session::FQLFunctionDoesNotExist,
       606 => Facebooker::Session::FQLWrongNumberArgumentsPassedToFunction,
+      612 => Facebooker::Session::ReadMailboxExtendedPermissionRequired,
       807 => Facebooker::Session::TemplateBundleInvalid
     }
     def self.process(data)
@@ -676,6 +683,7 @@ module Facebooker
       'facebook.feed.deactivateTemplateBundleByID' => DeactivateTemplateBundleByID,
       'facebook.feed.getRegisteredTemplateBundles' => GetRegisteredTemplateBundles,
       'facebook.feed.publishUserAction' => PublishUserAction,
+      'facebook.message.getThreadsInFolder' => MessageGetThreadsInFolder,
       'facebook.notifications.get' => NotificationsGet,
       'facebook.notifications.send' => NotificationsSend,
       'facebook.notifications.sendRequest' => SendRequest,

data/lib/facebooker/rails/controller.rb

@@ -246,7 +246,7 @@ module Facebooker
         )
       end
       
-      def fbml_redirect_tag(url)
+      def fbml_redirect_tag(url,*args)
         "<fb:redirect url=\"#{url_for(url)}\" />"
       end
       

data/lib/facebooker/rails/helpers.rb

@@ -341,7 +341,7 @@ module Facebooker
       VALID_FB_PHOTO_SIZES = VALID_FB_SHARED_PHOTO_SIZES      
       VALID_FB_PROFILE_PIC_SIZES = VALID_FB_SHARED_PHOTO_SIZES
       VALID_PERMISSIONS=[:email, :offline_access, :status_update, :photo_upload, :create_listing, :create_event, :rsvp_event, :sms, :video_upload, 
-                         :publish_stream, :read_stream]
+                         :publish_stream, :read_stream, :read_mailbox]
       
       # Render an fb:tabs tag containing some number of fb:tab_item tags.
       # Example:
@@ -624,6 +624,7 @@ module Facebooker
       #   * video_upload
       #   * create_note
       #   * share_item
+      #   * read_mailbox
       # Example:
       # <%= fb_prompt_permission('email', "Would you like to receive email from our application?" ) %>
       #

data/lib/facebooker/session.rb

@@ -56,6 +56,7 @@ module Facebooker
     class MissingOrInvalidImageFile < StandardError; end
     class TooManyUnapprovedPhotosPending < StandardError; end
     class ExtendedPermissionRequired < StandardError; end
+    class ReadMailboxExtendedPermissionRequired < StandardError; end
     class InvalidFriendList < StandardError; end
     class UserUnRegistrationFailed < StandardError
       attr_accessor :failed_users
@@ -120,6 +121,7 @@ module Facebooker
     # * create_event
     # * rsvp_event
     # * sms
+    # * read_mailbox
     def permission_url(permission,options={})
       options = default_login_url_options.merge(options)
       options = add_next_parameters(options)

data/lib/facebooker/version.rb

@@ -2,7 +2,7 @@ module Facebooker #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 1
     MINOR = 0
-    TINY  = 62
+    TINY  = 63
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/lib/tasks/facebooker.rake

@@ -6,13 +6,14 @@ namespace :facebooker do
   task :setup => :environment do   
     facebook_config = File.join(RAILS_ROOT,"config","facebooker.yml")
     unless File.exist?(facebook_config)
-      FileUtils.cp File.join(RAILS_ROOT,"vendor", "plugins", "facebooker", "facebooker.yml.tpl"), facebook_config 
+      plugin_root = File.join(RAILS_ROOT,"vendor","plugins")
+      facebook_config_tpl = File.join(plugin_root,"facebooker","generators","facebook","templates","config","facebooker.yml")
+      FileUtils.cp facebook_config_tpl, facebook_config 
       puts "Ensure 'GatewayPorts yes' is enabled in the remote development server's sshd config when using any of the facebooker:tunnel:*' rake tasks"
       puts "Configuration created in #{RAILS_ROOT}/config/facebooker.yml"
     else
       puts "#{RAILS_ROOT}/config/facebooker.yml already exists"
     end
-  end 
-        
-end
-
+  end
+  
+end

data/test/facebooker/models/user_test.rb

@@ -321,7 +321,47 @@ class Facebooker::UserTest < Test::Unit::TestCase
     assert result
   end
 
-  private
+  def test_threads_should_return_an_array_of_thread_instances_containing_messages_and_attachments
+    expect_http_posts_with_responses(example_threads)
+    threads = @user.threads
+    assert_not_nil threads
+    assert_instance_of Array, threads
+    assert_operator threads.size, :>, 0
+    for thread in threads
+      assert_instance_of Facebooker::MessageThread, thread
+      assert_instance_of Array, thread.messages
+      assert_operator thread.messages.size, :>, 0
+      assert_instance_of Facebooker::MessageThread::Message, thread.messages.first
+      
+      for message in thread.messages
+        next if message.attachment.blank?
+        assert_instance_of Facebooker::MessageThread::Message::Attachment, message.attachment
+        
+        case message.message_id
+        when '1344434538976_0'
+          assert message.attachment.photo?, 'Attachment of message "1344434538976_0" should be a photo'
+        when '1344434538976_2'
+          assert message.attachment.link?, 'Attachment of message "1344434538976_2" should be a link'
+        when '1012985167472_0'
+          assert message.attachment.video?, 'Attachment of message "1012985167472_0" should be a video'
+        end
+      end
+    end
+  end
+
+  def test_threads_should_return_populated_fields
+    expect_http_posts_with_responses(example_threads)
+    threads = @user.threads
+    
+    thread = threads.first
+    [:thread_id, :subject, :updated_time, :recipients, :parent_message_id, :parent_thread_id,
+      :message_count, :snippet, :snippet_author, :object_id, :unread].each do |field|
+      assert_not_nil thread.__send__(field), "Field #{field} should not be nil"
+    end
+  end
+
+private
+
   def example_profile_photos_get_xml
     "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
     <photos_get_response xmlns=\"http://api.facebook.com/1.0/\"
@@ -446,4 +486,145 @@ class Facebooker::UserTest < Test::Unit::TestCase
       </events_rsvp_response>
     E
   end
+
+  def example_threads
+    <<-XML
+<message_getThreadsInFolder_response xmlns="http://api.facebook.com/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.facebook.com/1.0/ http://api.facebook.com/1.0/facebook.xsd" list="true">
+  <thread>
+    <thread_id>1344434538976</thread_id>
+    <subject>Test attachments</subject>
+    <recipients list="true">
+      <uid>1410850842</uid>
+      <uid>662074872</uid>
+    </recipients>
+    <updated_time>1265723631</updated_time>
+    <parent_message_id>0</parent_message_id>
+    <parent_thread_id>0</parent_thread_id>
+    <message_count>3</message_count>
+    <snippet>one link attachment to a youtube video</snippet>
+    <snippet_author>1410850842</snippet_author>
+    <object_id>0</object_id>
+    <unread>0</unread>
+    <messages list="true">
+      <message>
+        <message_id>1344434538976_0</message_id>
+        <author_id>662074872</author_id>
+        <body>one photo attachment ,  4KB jpeg image</body>
+        <created_time>1265723631</created_time>
+        <attachment>
+          <media list="true"/>
+          <href>http://www.facebook.com/photo.php?pid=3358326&amp;id=662074872</href>
+          <properties list="true"/>
+          <icon>http://static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+          <fb_object_type/>
+          <fb_object_id/>
+          <tagged_ids list="true"/>
+        </attachment>
+        <thread_id>1344434538976</thread_id>
+      </message>
+      <message>
+        <message_id>1344434538976_1</message_id>
+        <author_id>1410850842</author_id>
+        <body>one link attachment (http://www.facebook.com/l/e46dd;google.fr)</body>
+        <created_time>1265723941</created_time>
+        <attachment>
+          <media list="true">
+            <stream_media>
+              <href>http://www.facebook.com/l.php?u=http%253A%252F%252Fwww.google.fr%252F&amp;h=e46dd63cdbfadb74958fbe44e98f339c</href>
+              <type>link</type>
+              <src>http://external.ak.fbcdn.net/safe_image.php?d=dd54bba6b6e6479a89bb8084573c02c8&amp;w=90&amp;h=90&amp;url=http%3A%2F%2Fwww.google.fr%2Fintl%2Ffr_fr%2Fimages%2Flogo.gif</src>
+            </stream_media>
+          </media>
+          <name>Google</name>
+          <href>http://www.facebook.com/l.php?u=http%253A%252F%252Fwww.google.fr%252F&amp;h=e46dd63cdbfadb74958fbe44e98f339c</href>
+          <caption>www.google.fr</caption>
+          <properties list="true"/>
+          <icon>http://static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+          <fb_object_type/>
+          <fb_object_id/>
+          <tagged_ids list="true"/>
+        </attachment>
+        <thread_id>1344434538976</thread_id>
+      </message>
+      <message>
+        <message_id>1344434538976_2</message_id>
+        <author_id>1410850842</author_id>
+        <body>one link attachment to a youtube video</body>
+        <created_time>1265726503</created_time>
+        <attachment>
+          <media list="true">
+            <stream_media>
+              <href>http://www.facebook.com/l.php?u=http%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253DAW-sNQUmUIM%2526feature%253Dpopular&amp;h=e46dd63cdbfadb74958fbe44e98f339c</href>
+              <alt>super bowl 44 highlights saints vs colts</alt>
+              <type>video</type>
+              <src>http://external.ak.fbcdn.net/safe_image.php?d=66f4aa965e2ae4a20a11c6a8ae3e4b1b&amp;w=90&amp;h=90&amp;url=http%3A%2F%2Fi.ytimg.com%2Fvi%2FAW-sNQUmUIM%2F2.jpg</src>
+              <video>
+                <display_url>http://www.youtube.com/watch?v=AW-sNQUmUIM&amp;feature=popular</display_url>
+                <source_url>http://www.youtube.com/v/AW-sNQUmUIM&amp;autoplay=1</source_url>
+                <owner>1410850842</owner>
+                <source_type>html</source_type>
+              </video>
+            </stream_media>
+          </media>
+          <name>super bowl 44 highlights saints vs colts</name>
+          <href>http://www.facebook.com/l.php?u=http%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253DAW-sNQUmUIM%2526feature%253Dpopular&amp;h=e46dd63cdbfadb74958fbe44e98f339c</href>
+          <caption>www.youtube.com</caption>
+          <description>NFL super bowl 44 highlights saints vs colts from south florida.</description>
+          <properties list="true"/>
+          <icon>http://static.ak.fbcdn.net/rsrc.php/z9XZ8/hash/976ulj6z.gif</icon>
+          <fb_object_type/>
+          <fb_object_id/>
+          <tagged_ids list="true"/>
+        </attachment>
+        <thread_id>1344434538976</thread_id>
+      </message>
+    </messages>
+  </thread>
+  <thread>
+    <thread_id>1012985167472</thread_id>
+    <subject>Happy Holidays from the Facebook Platform Team</subject>
+    <recipients list="true">
+      <uid>220400</uid>
+    </recipients>
+    <updated_time>1230000685</updated_time>
+    <parent_message_id>0</parent_message_id>
+    <parent_thread_id>0</parent_thread_id>
+    <message_count>1</message_count>
+    <snippet>We wanted to take a moment and thank you for all of your great work and amazi...</snippet>
+    <snippet_author>220400</snippet_author>
+    <object_id>2205007948</object_id>
+    <unread>0</unread>
+    <messages list="true">
+      <message>
+        <message_id>1012985167472_0</message_id>
+        <author_id>220400</author_id>
+        <body>We wanted to take a moment and thank you for all of your great work and amazing applications that have helped make Facebook Platform the largest and fastest-growing social platform over the past year and a half. As we end 2008 there are over 660,000 of you worldwide building applications that give users more powerful ways to share and connect, and collectively your applications have reached nearly 140 million people.
+
+Just recently, we've been excited to bring you Facebook Connect - allowing you to integrate the tools and features of Facebook Platform on your Websites, devices and desktop applications. In the next several months, we're looking forward to introducing additional improvements to help users more easily find your applications as well as launching the first sets of Verified Applications to users. If you haven't applied for verification yet, apply here:
+http://developers.facebook.com/verification.php
+
+Over the next year, we look forward to continued developments to improve Facebook Platform and help you reach and engage more users, and grow and sustain your business.  We would love your feedback and input on what you think is most important - please take a few minutes and answer our survey here: 
+
+http://www.facebook.com/l/e46dd;https://www.questionpro.com/akira/TakeSurvey?id=1121648
+
+From all of us at Facebook, we wish you and your families &quot;Happy Holidays,&quot; and we look forward to making the web even more social with you in 2009!</body>
+        <created_time>1230000042</created_time>
+        <attachment>
+          <media list="true"/>
+          <name>Feb 10, 2010 1:26pm</name>
+          <href>http://www.facebook.com/video/video.php?v=12345</href>
+          <properties list="true"/>
+          <icon>http://static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+          <fb_object_type/>
+          <fb_object_id/>
+          <tagged_ids list="true"/>
+        </attachment>
+        <thread_id>1012985167472</thread_id>
+      </message>
+    </messages>
+  </thread>
+</message_getThreadsInFolder_response>
+    XML
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: facebooker
 version: !ruby/object:Gem::Version 
-  version: 1.0.62
+  version: 1.0.63
 platform: ruby
 authors: 
 - Chad Fowler
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-05 00:00:00 -05:00
+date: 2010-02-22 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -142,6 +142,7 @@ files:
 - lib/facebooker/models/user.rb
 - lib/facebooker/models/video.rb
 - lib/facebooker/models/work_info.rb
+- lib/facebooker/models/message_thread.rb
 - lib/facebooker/parser.rb
 - lib/facebooker/rails/backwards_compatible_param_checks.rb
 - lib/facebooker/rails/controller.rb