facebook-graph 0.1

data/MIT-LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2010 Pedro Fracarolli
+
+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

@@ -0,0 +1,11 @@
+Build the Gem:
+
+# gem build facebook-graph.gemspec
+
+Install:
+
+# gem install facebook-graph-0.0.1.gem
+
+Uninstall:
+
+# gem uninstall facebook-graph

data/lib/facebook-graph.rb

@@ -0,0 +1,31 @@
+module FacebookGraph
+  
+  autoload :HTTPHelper, 'facebook-graph/helpers/http_helper.rb'
+  autoload :Helper, 'facebook-graph/helpers/helper.rb'
+  autoload :Client, 'facebook-graph/base/client.rb'
+  autoload :Authentication, 'facebook-graph/base/authentication.rb'
+  autoload :GraphNode, 'facebook-graph/base/graph_node.rb' 
+  
+
+  @@configuration = {
+      :base_uri => 'https://graph.facebook.com',
+      :search_uri => '/search',
+      :authorize_uri => '/oauth/authorize',
+      :access_token_uri => '/oauth/access_token'  
+  }
+  
+  class << self
+
+     # Enables custom url and parameter configuration
+     def configure(configuration={})
+       @@configuration.merge!(configuration)
+     end
+
+     def configuration
+       @@configuration 
+     end
+     
+  end
+ 
+end
+

data/lib/facebook-graph/base/authentication.rb

@@ -0,0 +1,31 @@
+class FacebookGraph::Authentication
+  include FacebookGraph::Helper
+
+  def initialize(client_id, client_secret, redirect_uri=nil)
+    @client_id, @client_secret = client_id, client_secret
+    @redirect_uri = redirect_uri
+  end
+     
+  def client_id_and_secret
+    [client_id, client_secret]
+  end
+
+  def user_authorization_uri(options={})
+    config = FacebookGraph.configuration 
+    uri = "#{config[:base_uri] + config[:authorize_uri]}?client_id=#{@client_id}"
+    uri += "&redirect_uri=#{CGI.escape(@redirect_uri)}" if @redirect_uri
+    uri += "&hash_to_querystring(options)" unless options.nil? || options.empty?
+    uri         
+  end
+     
+  def access_token code
+    config = FacebookGraph.configuration
+    parse_form_data("#{config[:base_uri] + config[:access_token_uri]}?client_id=#{@client_id}" + 
+                    "&client_secret=#{@client_secret}&code=#{CGI.escape(code)}" + 
+                    "&redirect_uri=#{CGI.escape(@redirect_uri)}")['access_token'][0]
+  end
+
+  attr_reader :client_id, :client_secret
+  attr_accessor :redirect_uri
+end 
+  

data/lib/facebook-graph/base/client.rb

@@ -0,0 +1,29 @@
+class FacebookGraph::Client
+  include FacebookGraph::Helper
+     
+  def initialize(access_token=nil)
+    @access_token = access_token
+  end 
+ 
+  def get_node(element_id, options={})
+    config = FacebookGraph.configuration
+    uri = "#{config[:base_uri]}/#{element_id}"
+    uri += "#{querystring_separator(uri)}access_token=#{CGI.escape(@access_token)}" if @access_token
+    uri += "#{querystring_separator(uri) + hash_to_querystring(options)}" unless options.nil? || options.empty?
+    FacebookGraph::GraphNode.new(parse_json(uri))
+  end   
+ 
+  def current_user(options={})
+    get_node('me', options)
+  end 
+
+  def search(query, options={})
+    config = FacebookGraph.configuration
+    uri = "#{config[:base_uri] + config[:search_uri]}?q=#{CGI.escape(query)}" 
+    uri += "&access_token=#{CGI.escape(@access_token)}" if @access_token
+    uri += "&#{hash_to_querystring(options)}" unless options.nil? || options.empty?
+    FacebookGraph::GraphNode.from_array(parse_json(uri))
+  end
+     
+  attr_accessor :access_token
+end  

data/lib/facebook-graph/base/graph_node.rb

@@ -0,0 +1,39 @@
+class FacebookGraph::GraphNode
+  include FacebookGraph::Helper
+     
+  def initialize(properties={})
+    config = FacebookGraph.configuration
+    @properties = symbolize_keys(properties)
+  end   
+       
+  def method_missing(mname, *args)
+    prop = @properties[mname]
+    return prop unless prop.nil?
+    prop = connections_defined? && @properties[:metadata]['connections'][mname.to_s]
+    super and return unless prop
+    options = args[0]
+    prop += "#{querystring_separator(prop) + hash_to_querystring(options)}" if options && options.kind_of?(Hash)     
+    mname == :picture ? prop : FacebookGraph::GraphNode.from_array(parse_json(prop))
+  end
+       
+  def respond_to? mname
+    is_metadata = connections_defined? && @properties[:metadata]['connections'][mname.to_s]
+    !!is_metadata || !!@properties[mname] || super(mname)   
+  end   
+       
+  def node_id
+    @properties[:id]
+  end
+  
+  def connections_defined?
+    !!(@properties[:metadata] && @properties[:metadata]['connections'])
+  end
+  
+  def self.from_array(array)
+    array['data'].map{|el| self.new(el)} if array['data']
+  end      
+  
+  attr_reader :properties
+  private :connections_defined?
+      
+end  

data/lib/facebook-graph/helpers/helper.rb

@@ -0,0 +1,42 @@
+require 'cgi'
+require 'json'
+
+module FacebookGraph::Helper
+    include FacebookGraph::HTTPHelper
+    
+    protected
+    
+    def symbolize_keys h
+      result = {}
+      h.each_pair do |k,v|
+        result[k.to_sym] = v
+      end
+      result   
+    end
+    
+    def parse_json(uri, options={:http_method=>:get})
+      result = JSON.parse(send(options.delete(:http_method),uri)) rescue nil
+      if result && result['error']
+        begin
+          raise FacebookGraph.const_get(result['error']['type']), result['error']['message']
+        rescue NameError
+          FacebookGraph.const_set(result['error']['type'], Class.new(Exception))
+          retry
+        end
+      end
+      result        
+    end
+    
+    def querystring_separator(uri)
+      uri =~ /\=/ ? '&' : '?'
+    end  
+    
+    def hash_to_querystring(hash)
+      hash.map{|k,v| "#{k}=#{v}"}.join('&')
+    end
+    
+    def parse_form_data(uri, options={:http_method=>:get})
+      CGI.parse(send(options.delete(:http_method),uri))
+    end
+  
+end  

data/lib/facebook-graph/helpers/http_helper.rb

@@ -0,0 +1,19 @@
+require 'net/https'
+
+module FacebookGraph::HTTPHelper
+  def initialize_http host, port 
+    http = Net::HTTP.new(host, port)
+    http.use_ssl = true
+    http
+  end      
+  
+  def get uri
+    uri = URI.parse(uri)
+    http = initialize_http(uri.host, uri.port)
+    request = Net::HTTP::Get.new uri.request_uri
+    #request['user-agent'] = "facebook-graph gem"
+    http.request(request).body      
+  end
+  
+  private :initialize_http
+end  

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: facebook-graph
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Pedro A. Vicentini Fracarolli
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-18 00:00:00 -03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json_pure
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 1
+        - 2
+        - 0
+        version: 1.2.0
+  type: :runtime
+  version_requirements: *id001
+description: Simple Ruby wrapper for the FB Graph API. Still in its early stages.
+email: pedro.fracarolli@coffeebeantech.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README
+- MIT-LICENSE
+- lib/facebook-graph.rb
+- lib/facebook-graph/base/client.rb
+- lib/facebook-graph/base/authentication.rb
+- lib/facebook-graph/base/graph_node.rb
+- lib/facebook-graph/helpers/helper.rb
+- lib/facebook-graph/helpers/http_helper.rb
+has_rdoc: true
+homepage: http://github.com/pfracarolli/facebook-graph
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- json_pure v1.2.0 or greater
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for the Facebook Graph API
+test_files: []
+