djanowski-mmangino-facebooker 1.0.4

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,110 @@
+CHANGELOG.txt
+COPYING
+History.txt
+Manifest.txt
+README
+README.txt
+Rakefile
+TODO.txt
+generators/publisher/publisher_generator.rb
+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
+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/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/net/http_multipart_post.rb
+lib/tasks/facebooker.rake
+lib/tasks/tunnel.rake
+rails/init.rb
+setup.rb
+templates/layout.erb
+test/adapters_test.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/logging_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,76 @@
+# -*- 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', 'Corey Innis']
+  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
+
+gem_spec_file = 'facebooker.gemspec'
+
+gem_spec = eval(File.read(gem_spec_file)) rescue nil
+
+desc "Generate the gemspec file."
+task :gemspec do
+  require 'erb'
+
+  File.open(gem_spec_file, 'w') do |f|
+    f.write ERB.new(File.read("#{gem_spec_file}.erb")).result(binding)
+  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 @@
+[ ] 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]
+[X] Remove facebook prefix from resource routes, making them worth with facebook and regular Rails controllers [mike]
+[X] Use fb_sig_request_method to make facebook routes more Rails-like [mike]

data/generators/facebook/facebook_generator.rb

@@ -0,0 +1,14 @@
+class FacebookGenerator < Rails::Generator::Base
+  def manifest
+    record do |m|
+      m.file 'config/facebooker.yml',            'config/facebooker.yml'
+      m.file 'public/javascripts/facebooker.js', 'public/javascripts/facebooker.js'
+    end
+  end
+
+  protected
+
+  def banner
+    "Usage: #{$0} facebooker"
+  end
+end

data/generators/facebook/templates/config/facebooker.yml

@@ -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/generators/facebook/templates/public/javascripts/facebooker.js

@@ -0,0 +1,106 @@
+
+function $(element) {
+  if (typeof element == "string") {
+    element=document.getElementById(element);
+  }
+  if (element)
+    extend_instance(element,Element);
+  return element;
+}
+
+function extend_instance(instance,hash) {
+  for (var name in hash) {
+    instance[name] = hash[name];
+  }
+}
+
+var Element = {
+  "hide": function () {
+    this.setStyle("display","none")
+  },
+  "show": function () {
+    this.setStyle("display","block")
+  },
+  "visible": function () {
+    return (this.getStyle("display") != "none");
+  },
+  "toggle": function () {
+    if (this.visible) {
+      this.hide();
+    } else {
+      this.show();
+    }
+  }
+};
+
+function encodeURIComponent(str) {
+  if (typeof(str) == "string") {
+    return str.replace(/=/g,'%3D').replace(/&/g,'%26');
+  }
+  //checkboxes and radio buttons return objects instead of a string
+  else if(typeof(str) == "object"){
+    for (prop in str)
+    {
+      return str[prop].replace(/=/g,'%3D').replace(/&/g,'%26');
+    }
+  }
+};
+
+var Form = {};
+Form.serialize = function(form_element) {
+  elements=$(form_element).serialize();
+  param_string="";
+  for (var name in elements) {
+    if (param_string) 
+      param_string += "&";
+    param_string += encodeURIComponent(name)+"="+encodeURIComponent(elements[name]);
+  }
+  return param_string;
+};
+
+Ajax.Updater = function (container,url,options) {
+  this.container = container;
+  this.url=url;
+  this.ajax = new Ajax();
+  this.ajax.requireLogin = 1;
+  if (options["onSuccess"]) {
+    this.ajax.responseType = Ajax.JSON;
+    this.ajax.ondone = options["onSuccess"];
+  } else {
+    this.ajax.responseType = Ajax.FBML;
+    this.ajax.ondone = function(data) {
+      $(container).setInnerFBML(data);
+    }
+  }
+  if (options["onFailure"]) {
+    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); 
+  if (options["onLoading"]) {
+     options["onLoading"].call() 
+  }
+};
+Ajax.Request = function(url,options) {
+  Ajax.Updater('unused',url,options);
+};
+
+PeriodicalExecuter = function (callback, frequency) {
+        setTimeout(callback, frequency *1000);
+        setTimeout(function() { new PeriodicalExecuter(callback,frequency); }, frequency*1000);
+};