doesopengraph 0.1.0

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2011 by Awexome Labs, LLC
+
+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,11 @@
+= DoesOpenGraph
+
+The Awexome Labs client library for accessing and manipulating the Facebook
+OpenGraph in ruby
+
+
+== Copyright
+
+Copyright (C) 2011 by Awexome Labs, LLC
+http://awexomelabs.com
+

data/lib/doesopengraph/graph_api.rb

@@ -0,0 +1,115 @@
+# AWEXOME LABS
+# DoesOpenGraph
+#
+# GraphAPI - Class containing get and post mechanism for accessing nodes
+#  within the open graph
+#
+
+module DoesOpenGraph
+  class GraphAPI
+
+    require "typhoeus"
+    require "uri"
+    require "json"
+  
+    HTTP_GRAPH_ENDPOINT = "http://graph.facebook.com/"
+    HTTPS_GRAPH_ENDPOINT = "https://graph.facebook.com/"
+    
+    attr_reader :access_token
+  
+    def initialize(acctok=nil)
+      @access_token = acctok
+    end
+  
+  
+    def node(id, connection=nil, params={})
+      # Inject an access_token if we plan to make an authorized request:
+      params[:access_token] = @access_token if @access_token
+      
+      # Stringify tokens:
+      id = id.to_s
+      connection = connection.to_s unless connection.nil?
+
+      # Smoosh the URL components together:
+      base = @access_token.nil? ? HTTP_GRAPH_ENDPOINT : HTTPS_GRAPH_ENDPOINT
+      path = connection.nil? ? id : File.join(id, connection)
+      href = File.join(base, path)
+      
+      # Make a request and parse JSON result:
+      begin
+        response = Typhoeus::Request.get(href, :params=>params)
+        data = JSON.parse(response.body)
+        return GraphNode.new(data, self)
+      rescue JSON::ParserError => jsone
+        raise "Invalid JSON or poorly formed JSON returned for #{path}" and return nil
+      end
+    end
+    alias_method :get, :node
+    
+  
+    def update(id, connection, params={})
+      # Inject the access token if we have it and err if we don't
+      return nil unless @access_token
+      params[:access_token] = @access_token
+      
+      # Smoosh the URL components together:
+      base = HTTPS_GRAPH_ENDPOINT
+      path = File.join(id, connection)
+      href = File.join(base, path)
+      
+      # Make our POST request and check the results:
+      begin
+        response = Typhoeus::Request.post(href, :params=>params)
+        data = JSON.parse(response.body)
+        return GraphResponse.new(data)
+      rescue JSON::ParserError => jsone
+        raise "Invalid JSON or poorly formed JSON returned for #{path}" and return nil
+      end      
+    end
+    alias_method :post, :update
+    
+    
+    def delete(id, connection=nil)
+      # Inject the access token if we have it and err if we don't
+      return nil unless @access_token
+      params = Hash.new and params[:access_token] = @access_token
+      
+      # Smoosh the URL components together:
+      base = HTTPS_GRAPH_ENDPOINT
+      path = connection.nil? ? id : File.join(id, connection)
+      href = File.join(base, path)
+      
+      # Make our DELETE request and return the results:
+      begin
+        response = Typhoeus::Request.delete(href, :params=>params)
+        data = JSON.parse(response.body)
+        return GraphResponse.new(data)
+      rescue JSON::ParserError => jsone
+        raise "Invalid JSON or poorly formed JSON returned for #{path}" and return nil
+      end
+    end
+    
+    
+    def search(query, type, params={})
+      # Inject the access token if we have it and err if we don't
+      return nil unless @access_token
+      params[:access_token] = @access_token
+      
+      # Build the search query and its target:
+      params[:q] = query
+      params[:type] = type
+      href = File.join(HTTPS_GRAPH_ENDPOINT, "search")
+      
+      # Make the request:
+      response = Typhoeus::Request.get(href, :params=>params)
+      data = JSON.parse(response.body)
+      return GraphResponse.new(data)
+    end
+    
+  
+
+  end # GraphAPI    
+end # DoesOpenGraph
+      
+
+

data/lib/doesopengraph/graph_node.rb

@@ -0,0 +1,42 @@
+# AWEXOME LABS
+# DoesOpenGraph
+#
+# GraphNode - An instance of an item on the open graph
+#
+
+module DoesOpenGraph
+  class GraphNode < GraphResponse
+
+    # Fetch an updated view of this node
+    def reload
+      up = api.node(self.id)
+      @content = up.content
+      self
+    end
+    
+    # Introspect on the connections available to this node
+    def introspect
+      api.node(self.id, nil, :metadata=>1)
+    end
+    
+    # Delete this node from the graph
+    def delete
+      api.delete(self.id)
+    end
+    
+    # Like this node, if supported
+    def like
+      api.post(self.id, "likes")
+    end
+    
+    # Unlike this node, if supported
+    def unlike
+      api.delete(self.id, "likes")
+    end
+    
+
+  end # GraphNode    
+end # DoesOpenGraph
+      
+
+

data/lib/doesopengraph/graph_response.rb

@@ -0,0 +1,27 @@
+# AWEXOME LABS
+# DoesOpenGraph
+#
+# GraphResponse - A very simple wrapper for data returned by the OpenGraph API
+#
+
+module DoesOpenGraph
+  class GraphResponse
+
+    attr_reader :content, :api
+
+    # Build a Response object from request content and store the api
+    def initialize(content, api=nil)
+      @content = content.is_a?(Hash) ? content : Hash.new
+      @api = api
+    end
+      
+    # Use secret patching to provide accessors to connections within node
+    def method_missing(m, *args, &block)
+      content.include?(m.to_s) ? content[m.to_s] : nil
+    end
+
+  end # GraphResponse    
+end # DoesOpenGraph
+      
+
+

data/lib/doesopengraph.rb

@@ -0,0 +1,12 @@
+# AWEXOME
+# DoesOpenGraph
+#
+# DoesOpenGraph - Module definition and loader
+
+require "doesopengraph"
+require "doesopengraph/graph_api"
+require "doesopengraph/graph_response"
+require "doesopengraph/graph_node"
+
+module DoesOpenGraph
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification 
+name: doesopengraph
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- mccolin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-09 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: typhoeus
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 2
+        - 0
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 5
+        - 1
+        version: 1.5.1
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: typhoeus
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 2
+        - 0
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id004
+description: The Awexome Labs library for accessing and manipulating the Facebook OpenGraph
+email: info@awexomelabs.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- lib/doesopengraph.rb
+- lib/doesopengraph/graph_api.rb
+- lib/doesopengraph/graph_node.rb
+- lib/doesopengraph/graph_response.rb
+- LICENSE
+- README.rdoc
+has_rdoc: true
+homepage: http://awexomelabs.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: The Awexome Labs library for accessing and manipulating the Facebook OpenGraph
+test_files: []
+