Facebooker

Facebooker is a Ruby wrapper over the Facebook REST 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

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 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 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.