fb_graph 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 nov matake
+
+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/README.rdoc

@@ -0,0 +1,17 @@
+= fb_graph
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 nov matake. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = 'fb_graph'
+    gem.summary = %Q{Facebook Graph API library for Ruby}
+    gem.description = %Q{Facebook Graph API library for Ruby}
+    gem.email = 'nov@matake.jp'
+    gem.homepage = 'http://github.com/nov/fb_graph'
+    gem.authors = ['nov matake']
+    gem.add_development_dependency 'json'
+    gem.add_development_dependency 'activesupport'
+    gem.add_development_dependency 'rest-client'
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts 'Jeweler not available. Install it with: gem install jeweler'
+end
+
+begin
+  require 'spec/rake/spectask'
+  Spec::Rake::SpecTask.new(:spec) do |spec|
+    spec.fail_on_error = false
+    spec.libs << 'lib' << 'spec'
+    spec.spec_files = FileList['spec/**/*_spec.rb']
+  end
+  Spec::Rake::SpecTask.new(:rcov) do |spec|
+    spec.libs << 'lib' << 'spec'
+    spec.pattern = 'spec/**/*_spec.rb'
+    spec.rcov = true
+    spec.rcov_opts = ['--exclude spec,gems']
+  end
+  task :spec => :check_dependencies
+  task :default => :spec
+rescue LoadError
+  puts 'RSpec not available. Install it with: gem install rspec'
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.read('VERSION')
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = 'fb_graph #{version}'
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/fb_graph.gemspec

@@ -0,0 +1,107 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{fb_graph}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["nov matake"]
+  s.date = %q{2010-04-26}
+  s.description = %q{Facebook Graph API library for Ruby}
+  s.email = %q{nov@matake.jp}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "fb_graph.gemspec",
+     "lib/fb_graph.rb",
+     "lib/fb_graph/connections.rb",
+     "lib/fb_graph/connections/collection.rb",
+     "lib/fb_graph/connections/feed.rb",
+     "lib/fb_graph/connections/home.rb",
+     "lib/fb_graph/connections/likes.rb",
+     "lib/fb_graph/connections/picture.rb",
+     "lib/fb_graph/connections/posts.rb",
+     "lib/fb_graph/connections/statuses.rb",
+     "lib/fb_graph/connections/tagged.rb",
+     "lib/fb_graph/node.rb",
+     "lib/fb_graph/page.rb",
+     "lib/fb_graph/post.rb",
+     "lib/fb_graph/status.rb",
+     "lib/fb_graph/user.rb",
+     "spec/fake_json/pages/platform_private.json",
+     "spec/fake_json/pages/platform_public.json",
+     "spec/fake_json/pages/statuses/platform_private.json",
+     "spec/fake_json/pages/statuses/platform_public.json",
+     "spec/fake_json/users/arjun_private.json",
+     "spec/fake_json/users/arjun_public.json",
+     "spec/fake_json/users/home/arjun_private.json",
+     "spec/fake_json/users/home/arjun_public.json",
+     "spec/fake_json/users/home/me_private.json",
+     "spec/fake_json/users/home/me_public.json",
+     "spec/fake_json/users/likes/arjun_private.json",
+     "spec/fake_json/users/likes/arjun_public.json",
+     "spec/fake_json/users/statuses/arjun_private.json",
+     "spec/fake_json/users/statuses/arjun_public.json",
+     "spec/fb_graph/connections/collection_spec.rb",
+     "spec/fb_graph/connections/home_spec.rb",
+     "spec/fb_graph/connections/likes_spec.rb",
+     "spec/fb_graph/connections/picture_spec.rb",
+     "spec/fb_graph/connections/statuses_spec.rb",
+     "spec/fb_graph/node_spec.rb",
+     "spec/fb_graph/page_spec.rb",
+     "spec/fb_graph/user_spec.rb",
+     "spec/fb_graph_spec.rb",
+     "spec/helpers/fake_json_helper.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/nov/fb_graph}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Facebook Graph API library for Ruby}
+  s.test_files = [
+    "spec/fb_graph/connections/collection_spec.rb",
+     "spec/fb_graph/connections/home_spec.rb",
+     "spec/fb_graph/connections/likes_spec.rb",
+     "spec/fb_graph/connections/picture_spec.rb",
+     "spec/fb_graph/connections/statuses_spec.rb",
+     "spec/fb_graph/node_spec.rb",
+     "spec/fb_graph/page_spec.rb",
+     "spec/fb_graph/user_spec.rb",
+     "spec/fb_graph_spec.rb",
+     "spec/helpers/fake_json_helper.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<activesupport>, [">= 0"])
+      s.add_development_dependency(%q<rest-client>, [">= 0"])
+    else
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<rest-client>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<rest-client>, [">= 0"])
+  end
+end
+

data/lib/fb_graph/connections/collection.rb

@@ -0,0 +1,31 @@
+module FbGraph
+  module Connections
+    class Collection < Array
+      attr_reader :previous, :next
+
+      def initialize(collection)
+        result = replace(collection[:data])
+        @previous, @next = {}, {}
+        if (paging = collection[:paging])
+          if paging[:previous]
+            @previous = parse_query(URI.parse(paging[:previous]).query)
+          end
+          if paging[:next]
+            @next = parse_query(URI.parse(paging[:next]).query)
+          end
+        end
+      end
+
+      private
+
+      def parse_query(query)
+        params = {}
+        query.split('&').each do |q|
+          key, value = q.split('=')
+          params[key] = value
+        end
+        params.with_indifferent_access
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/feed.rb

@@ -0,0 +1,9 @@
+module FbGraph
+  module Connections
+    module Feed
+      def feed(options = {})
+        Posts.posts(options.merge(:connection => 'feed', :self => self))
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/home.rb

@@ -0,0 +1,9 @@
+module FbGraph
+  module Connections
+    module Home
+      def home(options = {})
+        Posts.posts(options.merge(:connection => 'home', :self => self))
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/likes.rb

@@ -0,0 +1,12 @@
+module FbGraph
+  module Connections
+    module Likes
+      def likes(options = {})
+        likes = Collection.new(get(options.merge(:connection => 'likes')))
+        likes.map! do |like|
+          Page.new(like.delete(:id), like)
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/picture.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  module Connections
+    module Picture
+      def picture(size = nil)
+        _endpoint_ = "#{self.endpoint}/picture"
+        if size
+          "#{_endpoint_}?type=#{size}"
+        else
+          _endpoint_
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/posts.rb

@@ -0,0 +1,15 @@
+module FbGraph
+  module Connections
+    module Posts
+      def posts(options = {})
+        options[:connection] ||= 'posts'
+        __self__ = options.delete(:self) || self
+        posts = Collection.new(__self__.send(:get, options))
+        posts.map! do |post|
+          Post.new(post.delete(:id), post)
+        end
+      end
+      module_function :posts
+    end
+  end
+end

data/lib/fb_graph/connections/statuses.rb

@@ -0,0 +1,12 @@
+module FbGraph
+  module Connections
+    module Statuses
+      def statuses(options = {})
+        statuses = Collection.new(get(options.merge(:connection => 'statuses')))
+        statuses.map! do |status|
+          Status.new(status.delete(:id), status)
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/tagged.rb

@@ -0,0 +1,9 @@
+module FbGraph
+  module Connections
+    module Tagged
+      def tagged(options = {})
+        Posts.posts(options.merge(:connection => 'tagged', :self => self))
+      end
+    end
+  end
+end

data/lib/fb_graph/connections.rb

@@ -0,0 +1,6 @@
+module Connections
+end
+
+Dir[File.dirname(__FILE__) + '/connections/*.rb'].each do |file| 
+  require file
+end

data/lib/fb_graph/node.rb

@@ -0,0 +1,62 @@
+module FbGraph
+  class Node
+    attr_accessor :identifier, :endpoint, :access_token
+
+    def ==(other)
+      instance_variables.all? do |key|
+        instance_variable_get(key) == other.instance_variable_get(key)
+      end
+    end
+
+    def initialize(identifier, options = {})
+      @identifier   = identifier
+      @endpoint     = File.join(FbGraph::ROOT_URL, identifier)
+      @access_token = options[:access_token]
+    end
+
+    def self.fetch(identifier, options = {})
+      _fetched_ = new(identifier).send(:get, options)
+      new(_fetched_.delete(:id), _fetched_)
+    end
+
+    protected
+
+    def get(options = {})
+      _endpoint_ = build_endpoint(options)
+      handle_response RestClient.get(_endpoint_)
+    end
+
+    private
+
+    def build_endpoint(options = {})
+      _endpoint_ = if options[:connection]
+        File.join(self.endpoint, options.delete(:connection))
+      else
+        self.endpoint
+      end
+      options[:access_token] ||= self.access_token
+      _options_ = options.reject do |k, v|
+        v.blank?
+      end
+      _endpoint_ << "?#{_options_.to_query}" unless _options_.blank?
+      _endpoint_
+    end
+
+    def handle_response(response)
+      _response_ = JSON.parse(response.to_s).with_indifferent_access
+      if _response_[:error]
+        case _response_[:error][:type]
+        when 'OAuthAccessTokenException'
+          raise FbGraph::Unauthorized.new(_response_[:error][:message])
+        when 'QueryParseException'
+          raise FbGraph::NotFound.new(_response_[:error][:message])
+        else
+          raise FbGraph::Exception.new("#{_response_[:error][:type]} :: #{_response_[:error][:message]}")
+        end
+      else
+        _response_
+      end
+    end
+
+  end
+end

data/lib/fb_graph/page.rb

@@ -0,0 +1,14 @@
+module FbGraph
+  class Page < Node
+    include Connections::Picture
+    include Connections::Statuses
+
+    attr_accessor :name, :category
+
+    def initialize(identifier, options = {})
+      super
+      @name     = options[:name]
+      @category = options[:category]
+    end
+  end
+end

data/lib/fb_graph/post.rb

@@ -0,0 +1,39 @@
+module FbGraph
+  class Post < Node
+    attr_accessor :from, :to, :message, :picture, :link, :name, :caption, :description, :source, :icon, :attribution, :actions, :likes, :created_time, :updated_time
+
+    def initialize(identifier, options = {})
+      super
+      if (from = options[:from])
+        @from = if from[:category]
+          FbGraph::Page.new(from[:id], :name => from[:name], :category => from[:category]) 
+        else
+          FbGraph::User.new(from[:id], :name => from[:name])
+        end
+      end
+      @to = []
+      if options[:to]
+        options[:to].each do |to|
+          @to << if to[:category]
+            FbGraph::Page.new(to[:id], :name => to[:name], :category => to[:category]) 
+          else
+            FbGraph::User.new(to[:id], :name => to[:name])
+          end
+        end
+      end
+      @message      = options[:message]
+      @picture      = options[:picture]
+      @link         = options[:link]
+      @name         = options[:name]
+      @caption      = options[:caption]
+      @description  = options[:description]
+      @source       = options[:source]
+      @icon         = options[:icon]
+      @attribution  = options[:attribution]
+      @actions      = options[:actions]
+      @likes        = options[:likes]
+      @created_time = options[:created_time]
+      @updated_time = options[:updated_time]
+    end
+  end
+end

data/lib/fb_graph/status.rb

@@ -0,0 +1,18 @@
+module FbGraph
+  class Status < Node
+    attr_accessor :from, :message, :updated_time
+
+    def initialize(identifier, options = {})
+      super
+      if (from = options[:from])
+        @from = if from[:category]
+          FbGraph::Page.new(from[:id], :name => from[:name], :category => from[:category]) 
+        else
+          FbGraph::User.new(from[:id], :name => from[:name])
+        end
+      end
+      @message = options[:message]
+      @updated_time = options[:updated_time]
+    end
+  end
+end

data/lib/fb_graph/user.rb

@@ -0,0 +1,31 @@
+module FbGraph
+  class User < Node
+    include Connections::Home
+    include Connections::Feed
+    include Connections::Posts
+    include Connections::Likes
+    include Connections::Picture
+    include Connections::Statuses
+
+    attr_accessor :name, :last_name, :first_name, :link, :about, :birthday, :work, :education, :email, :website
+
+    def initialize(identifier, options = {})
+      super
+      @name       = options[:name]
+      @last_name  = options[:last_name]
+      @first_name = options[:first_name]
+      @link       = options[:link]
+      @about      = options[:about]
+      @birthday   = options[:birthday]
+      @work       = options[:work]
+      @education  = options[:education]
+      @email      = options[:email]
+      @website    = options[:website]
+    end
+
+    def self.me(access_token)
+      new('me', :access_token => access_token)
+    end
+
+  end
+end

data/lib/fb_graph.rb

@@ -0,0 +1,26 @@
+require 'rubygems'
+require 'json'
+require 'active_support'
+require 'rest_client'
+
+module FbGraph
+  ROOT_URL = "https://graph.facebook.com"
+
+  class FbGraph::Exception < StandardError; end
+  class FbGraph::Unauthorized < FbGraph::Exception; end
+  class FbGraph::NotFound < FbGraph::Exception; end
+
+  class << self
+    def node(identifier, options = {})
+      Node.new(identifier, options)
+    end
+    def user(identifier, options = {})
+      User.new(identifier, options)
+    end
+  end
+
+end
+
+Dir[File.dirname(__FILE__) + '/fb_graph/*.rb'].each do |file| 
+  require file
+end

data/spec/fake_json/pages/platform_private.json

@@ -0,0 +1,13 @@
+{
+   "id": "19292868552",
+   "name": "Facebook Platform",
+   "picture": "http://profile.ak.fbcdn.net/object3/1566/8/s19292868552_1660.jpg",
+   "link": "http://www.facebook.com/platform",
+   "category": "Technology",
+   "username": "platform",
+   "founded": "May 2007",
+   "company_overview": "Facebook Platform enables anyone to build social applications on Facebook and the web.",
+   "mission": "To make the web more open and social.",
+   "products": "Facebook Application Programming Interface (API)\nFacebook Query Language (FQL)\nFacebook Markup Language (FBML)\nFacebook JavaScript (FBJS)\nFacebook Connect\n",
+   "fan_count": 453163
+}

data/spec/fake_json/pages/platform_public.json

@@ -0,0 +1,13 @@
+{
+   "id": "19292868552",
+   "name": "Facebook Platform",
+   "picture": "http://profile.ak.fbcdn.net/object3/1566/8/s19292868552_1660.jpg",
+   "link": "http://www.facebook.com/platform",
+   "category": "Technology",
+   "username": "platform",
+   "founded": "May 2007",
+   "company_overview": "Facebook Platform enables anyone to build social applications on Facebook and the web.",
+   "mission": "To make the web more open and social.",
+   "products": "Facebook Application Programming Interface (API)\nFacebook Query Language (FQL)\nFacebook Markup Language (FBML)\nFacebook JavaScript (FBJS)\nFacebook Connect\n",
+   "fan_count": 453163
+}