yury-facebooker 0.9.5

data/COPYING

@@ -0,0 +1,19 @@
+#
+# Copyright (c) 2007 Chad Fowler <chad@infoether.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of
+# this software and associated documentation files (the "Software"), to deal in the
+# Software without restriction, including without limitation the rights to use,
+# copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+# Software, and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+# AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/History.txt

@@ -0,0 +1,16 @@
+=== x.x.x / 2008-xx-xx
+
+* fixed typo in set app properties parser [Andrew Grim, shane]
+* Removed actor_id param from templatized feed [shane]
+* Added admin.get_allocation [shane]
+* Added data.get_cookies and data.set_cookie [shane]
+* Added admin.get_app_properties and admin.set_app_properties [shane]
+
+=== 0.9.9 / 2008-09-08
+
+* Re-package as gem after reworking for new API
+
+
+=== 0.9.5 / 2008-02-13
+
+* Next release of documentation

data/Manifest.txt

@@ -0,0 +1,77 @@
+CHANGELOG.txt
+COPYING
+History.txt
+Manifest.txt
+README
+README.txt
+Rakefile
+TODO.txt
+facebooker.yml.tpl
+generators/publisher/publisher_generator.rb
+generators/publisher/templates/publisher.rb
+init.rb
+install.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/model.rb
+lib/facebooker/models/affiliation.rb
+lib/facebooker/models/album.rb
+lib/facebooker/models/applicationproperties.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/work_info.rb
+lib/facebooker/parser.rb
+lib/facebooker/rails/controller.rb
+lib/facebooker/rails/facebook_asset_path.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_rewriting.rb
+lib/facebooker/rails/helpers.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/facebooker.rb
+lib/net/http_multipart_post.rb
+lib/tasks/facebooker.rake
+lib/tasks/tunnel.rake
+setup.rb
+test/batch_request_test.rb
+test/event_test.rb
+test/facebook_admin_test.rb
+test/facebook_cache_test.rb
+test/facebook_data_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/http_multipart_post_test.rb
+test/model_test.rb
+test/publisher_test.rb
+test/rails_integration_test.rb
+test/session_test.rb
+test/test_helper.rb
+test/user_test.rb

data/README

@@ -0,0 +1,46 @@
+Copyright (c) 2007 Chad Fowler, Patrick Ewing
+
+= Facebooker
+
+Facebooker is a Ruby wrapper over the Facebook[http://facebook.com] {REST API}[http://developer.facebook.com].  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
+
+= Installing (Non Rails)
+
+The best way is:
+
+  gem install facebooker
+
+If, for some reason, you can't/won't use RubyGems, you can do:
+
+  (sudo) ruby setup.rb
+
+= Installing (Rails)
+
+Facebooker can be installed as a Rails plugin by:
+
+  script/plugin install git://github.com/mmangino/facebooker.git
+
+If you don't have git, the plugin can be downloaded from http://github.com/mmangino/facebooker/tarball/master
+
+Once the plugin is installed, you will need to configure your Facebook app in config/facebooker.yml. 
+
+Your application users will need to have added the application in facebook to access all of facebooker's features. You enforce this by adding
+
+  ensure_application_is_installed_by_facebook_user  
+
+to your application controller.
+
+
+== Work in Progress
+
+I'm not saying it meets its goals fully yet.  Please help.  I'm especially interested in feedback and criticism re: Ruby style and design and testing.  RCov has the library (at the time of this writing) at 100% coverage.  I take that with a grain of salt, but it's a good start.
+
+== Contribute
+
+Please visit the {RubyForge project page}[http://rubyforge.org/projects/facebooker] to get the latest source via svn, write some tests, add/fix features, and submit a patch via the tracker.  If you submit a good patch, it's likely that I'll add you to the project for commit access if you want to be added.
+

data/README.txt

@@ -0,0 +1,81 @@
+= facebooker
+
+* http://facebooker.rubyforge.org
+
+== DESCRIPTION:
+
+Facebooker is a Ruby wrapper over the Facebook[http://facebook.com] {REST API}[http://developer.facebook.com].  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
+
+
+== FEATURES/PROBLEMS:
+
+* Idiomatic Ruby
+* No dependencies outside of the Ruby standard library
+* Concrete classes and methods modeling the Facebook data, so it's easy for a Rubyist to understand what's available
+* Well tested
+
+== SYNOPSIS:
+
+View David Clements' {excellent tutorial}[http://apps.facebook.com/facebooker_tutorial] at {http://apps.facebook.com/facebooker_tutorial/}[http://apps.facebook.com/facebooker_tutorial] or check out {Developing Facebook Platform Applications with Rails}[http://www.pragprog.com/titles/mmfacer].
+
+== REQUIREMENTS:
+
+None
+
+== INSTALL:
+
+ * Non Rails
+
+The best way is:
+
+  gem install facebooker
+
+If, for some reason, you can't/won't use RubyGems, you can do:
+
+  (sudo) ruby setup.rb
+
+  * Rails
+
+Facebooker can be installed as a Rails plugin by:
+
+  script/plugin install git://github.com/mmangino/facebooker.git
+
+If you don't have git, the plugin can be downloaded from http://github.com/mmangino/facebooker/tarball/master
+
+Once the plugin is installed, you will need to configure your Facebook app in config/facebooker.yml. 
+
+Your application users will need to have added the application in facebook to access all of facebooker's features. You enforce this by adding
+
+  ensure_application_is_installed_by_facebook_user  
+
+to your application controller.
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIX
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,62 @@
+# -*- ruby -*-
+# 
+require 'rubygems'
+ENV['RUBY_FLAGS']="-I#{%w(lib ext bin test).join(File::PATH_SEPARATOR)}"
+require 'hoe'
+ $: << File.dirname(__FILE__) + '/lib'
+require './lib/facebooker.rb'
+
+Hoe.new('facebooker', Facebooker::VERSION::STRING) do |p|
+  p.rubyforge_name = 'facebooker'
+  p.author = ['Chad Fowler', 'Patrick Ewing','Mike Mangino','Shane Vitarana']
+  p.email = 'mmangino@elevatedrails.com'
+  p.summary = 'Pure, idiomatic Ruby wrapper for the Facebook REST API.'
+  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.remote_rdoc_dir = '' # Release to root
+  p.test_globs = 'test/*.rb'
+  p.extra_deps << ['json', '>= 1.0.0'] 
+end
+
+require 'rcov/rcovtask'
+
+namespace :test do 
+  namespace :coverage do
+    desc "Delete aggregate coverage data."
+    task(:clean) { rm_f "coverage.data" }
+  end
+  desc 'Aggregate code coverage for unit, functional and integration tests'
+  Rcov::RcovTask.new(:coverage) do |t|
+    t.libs << "test"
+    t.test_files = FileList["test/*.rb"]
+    t.output_dir = "coverage/"
+    t.verbose = true
+  end
+end
+# vim: syntax=Ruby
+# 
+# 
+# require File.dirname(__FILE__) + '/vendor/gardener/lib/gardener'
+# 
+# require 'facebooker'
+# 
+# namespace :doc do
+#   task :readme do
+#     puts "Readme"
+#   end
+# end
+# 
+# Gardener.configure do
+#   gem_spec do |spec|
+#     spec.name              = 'facebooker'
+#     spec.version           = Gem::Version.new(Facebooker::VERSION::STRING)
+#     spec.summary           = "Pure, idiomatic Ruby wrapper for the Facebook REST API."
+#     spec.email             = 'chad@infoether.com'
+#     spec.author            = ['Chad Fowler', 'Patrick Ewing','Mike Mangino','Shane Vitarana']
+#     spec.extra_rdoc_files  = %w(COPYING)
+#     spec.rdoc_options      = ['--title', "Gardener",
+#                               '--main',  'README',
+#                               '--line-numbers', '--inline-source']
+#   end
+# end

data/TODO.txt

@@ -0,0 +1,10 @@
+[ ] Remove facebook prefix from resource routes, making them worth with facebook and regular Rails controllers
+[ ] Use fb_sig_request_method to make facebook routes more Rails-like
+[ ] Refactor facebook form builder so erbout won't be deeply nested, causing erubis to break
+[ ] Support missing parameters on methods---most notably authentication-related parameters such as next and canvas
+[ ] Finish FQL Querying
+[ ] Refactor FQL Querying
+[ ] Transform incoming data into appropriate classes (Integers, Dates, etc.)
+
+[x] Specify fields wanted when getting user info (defaults to all now) [shane]
+[x] Create facebooker.yml config file and merge with tunnel.yml [shane]

data/facebooker.yml.tpl

@@ -0,0 +1,41 @@
+# The api key, secret key, and canvas page name are required to get started
+# Tunnel configuration is only needed if you are going to use the facebooker:tunnel Rake tasks
+# Your callback url in Facebook should be set to http://public_host:public_port
+# To develop for the new profile design, add the following key..
+# api: new
+# remove the key or set it to anything else to use the old facebook design.
+# This should only be necessary until the final version of the new profile is released.
+
+development:
+  api_key: 
+  secret_key: 
+  canvas_page_name:
+  callback_url:
+  pretty_errors: true
+  tunnel:
+    public_host_username: 
+    public_host: 
+    public_port: 4007
+    local_port: 3000
+
+test:
+  api_key: 
+  secret_key: 
+  canvas_page_name: 
+  callback_url:
+  tunnel:
+    public_host_username: 
+    public_host: 
+    public_port: 4007
+    local_port: 3000
+
+production:
+  api_key: 
+  secret_key: 
+  canvas_page_name: 
+  callback_url:  
+  tunnel:
+    public_host_username: 
+    public_host: 
+    public_port: 4007
+    local_port: 3000

data/init.rb

@@ -0,0 +1,53 @@
+# Added support to the Facebooker.yml file for switching to the new profile design..
+# Config parsing needs to happen before files are required.
+facebook_config = "#{RAILS_ROOT}/config/facebooker.yml"
+
+require 'facebooker'
+FACEBOOKER = Facebooker.load_configuration(facebook_config)
+
+# enable logger before including everything else, in case we ever want to log initialization 
+Facebooker.logger = RAILS_DEFAULT_LOGGER if Object.const_defined? :RAILS_DEFAULT_LOGGER
+
+require 'net/http_multipart_post'
+require 'facebooker/rails/controller'
+require 'facebooker/rails/facebook_url_rewriting'
+require 'facebooker/rails/facebook_session_handling'
+require 'facebooker/rails/facebook_asset_path'
+require 'facebooker/rails/facebook_request_fix'
+require 'facebooker/rails/routing'
+require 'facebooker/rails/facebook_pretty_errors' rescue nil
+module ::ActionController
+  class Base
+    def self.inherited_with_facebooker(subclass)
+      inherited_without_facebooker(subclass)
+      if subclass.to_s == "ApplicationController"
+        subclass.send(:include,Facebooker::Rails::Controller) 
+        subclass.helper Facebooker::Rails::Helpers
+      end
+    end
+    class << self
+      alias_method_chain :inherited, :facebooker
+    end
+  end
+end
+
+class ActionController::Routing::Route
+  def recognition_conditions_with_facebooker
+    defaults = recognition_conditions_without_facebooker 
+    defaults << " env[:canvas] == conditions[:canvas] " if conditions[:canvas]
+    defaults
+  end
+  alias_method_chain :recognition_conditions, :facebooker
+end
+
+# We turn off route optimization to make named routes use our code for figuring out if they should go to the session
+# If this fails, it means we're on rails 1.2, we can ignore it
+begin
+  ActionController::Base::optimise_named_routes = false 
+rescue NoMethodError=>e
+  nil
+end
+
+# pull :canvas=> into env in routing to allow for conditions
+ActionController::Routing::RouteSet.send :include,  Facebooker::Rails::Routing::RouteSetExtensions
+ActionController::Routing::RouteSet::Mapper.send :include, Facebooker::Rails::Routing::MapperExtensions

data/install.rb

@@ -0,0 +1,7 @@
+require 'fileutils'
+require 'rubygems'
+facebook_config = File.join(RAILS_ROOT,"config","facebooker.yml")
+facebook_js = File.join(RAILS_ROOT,"public","javascripts",'facebooker.js')
+FileUtils.cp File.join(File.dirname(__FILE__) , 'facebooker.yml.tpl'), facebook_config unless File.exist?(facebook_config)
+FileUtils.cp File.join(File.dirname(__FILE__) , 'javascripts','facebooker.js'), facebook_js unless File.exist?(facebook_js)
+puts IO.read(File.join(File.dirname(__FILE__), 'README'))

data/lib/facebooker.rb

@@ -0,0 +1,143 @@
+begin
+  unless Object.const_defined?("ActiveSupport") and ActiveSupport.const_defined?("JSON")
+    require 'json' 
+    module Facebooker
+      def self.json_decode(str)
+        JSON.parse(str)
+      end
+    end
+  else
+    module Facebooker
+      def self.json_decode(str)
+        ActiveSupport::JSON.decode(str)
+      end
+    end
+  end 
+rescue
+  require 'json' 
+end
+require 'zlib'
+require 'digest/md5'
+
+require 'facebooker/batch_request'
+require 'facebooker/feed'
+require 'facebooker/logging'
+require 'facebooker/model'
+require 'facebooker/parser'
+require 'facebooker/service'
+require 'facebooker/server_cache'
+require 'facebooker/data'
+require 'facebooker/admin'
+require 'facebooker/session'
+require 'facebooker/version'
+require 'facebooker/models/location'
+require 'facebooker/models/affiliation'
+require 'facebooker/models/album'
+require 'facebooker/models/education_info'
+require 'facebooker/models/work_info'
+require 'facebooker/models/event'
+require 'facebooker/models/group'
+require 'facebooker/models/notifications'
+require 'facebooker/models/page'
+require 'facebooker/models/photo'
+require 'facebooker/models/cookie'
+require 'facebooker/models/applicationproperties'
+require 'facebooker/models/tag'
+require 'facebooker/models/user'
+require 'facebooker/models/info_item'
+require 'facebooker/models/info_section'
+require 'facebooker/adapters/adapter_base'
+require 'facebooker/adapters/facebook_adapter'
+require 'facebooker/adapters/bebo_adapter'
+require 'facebooker/models/friend_list'
+
+module Facebooker
+      
+    class << self
+    
+    def load_configuration(facebooker_yaml_file)
+      if File.exist?(facebooker_yaml_file)
+        if defined? RAILS_ENV
+          facebooker = YAML.load_file(facebooker_yaml_file)[RAILS_ENV] 
+        else
+          facebooker = YAML.load_file(facebooker_yaml_file)           
+        end
+        ENV['FACEBOOK_API_KEY'] = facebooker['api_key']
+        ENV['FACEBOOK_SECRET_KEY'] = facebooker['secret_key']
+        ENV['FACEBOOKER_RELATIVE_URL_ROOT'] = facebooker['canvas_page_name']
+        ENV['FACEBOOKER_API'] = facebooker['api']
+        if Object.const_defined?("ActionController")
+          ActionController::Base.asset_host = facebooker['callback_url'] if(ActionController::Base.asset_host.blank?)
+        end
+        @facebooker_configuration = facebooker
+      end
+    end
+    
+    def facebooker_config
+      @facebooker_configuration 
+    end
+    
+     def current_adapter=(adapter_class)
+      @current_adapter = adapter_class
+    end
+    
+    def current_adapter
+      @current_adapter || Facebooker::AdapterBase.default_adapter
+    end
+    
+    def load_adapter(params)
+      self.current_adapter = Facebooker::AdapterBase.load_adapter(params)
+    end
+      
+    def facebook_path_prefix=(path)
+      current_adapter.facebook_path_prefix = path
+    end
+  
+    # Default is canvas_page_name in yml file
+    def facebook_path_prefix
+      current_adapter.facebook_path_prefix
+    end
+    
+    def is_for?(application_container)
+      current_adapter.is_for?(application_container)
+    end
+    
+   
+   
+    [:api_key,:secret_key, :www_server_base_url,:login_url_base,:install_url_base,:api_rest_path,:api_server_base,:api_server_base_url,:canvas_server_base].each do |delegated_method|
+      define_method(delegated_method){ return current_adapter.send(delegated_method)}
+    end
+    
+    
+       def path_prefix
+      @path_prefix
+      end
+    
+    
+    # Set the asset path to the canvas path for just this one request
+    # by definition, we will make this a canvas request
+    def with_asset_path_for_canvas
+      original_asset_host = ActionController::Base.asset_host
+      begin
+        ActionController::Base.asset_host = Facebooker.api_server_base_url
+        request_for_canvas(true) do
+          yield
+        end
+      ensure
+        ActionController::Base.asset_host = original_asset_host
+      end
+    end
+  
+    # If this request is_canvas_request
+    # then use the application name as the url root
+    def request_for_canvas(is_canvas_request)
+      original_path_prefix = @path_prefix 
+      begin
+        @path_prefix = facebook_path_prefix if is_canvas_request
+        yield
+      ensure
+        @path_prefix = original_path_prefix
+      end
+    end
+  end
+end