sayso-api-client 0.1.0

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+source 'http://gemcutter.org'
+source 'http://gems.github.com'
+
+gem 'oauth'
+gem 'crack'
+gem 'activesupport'

data/README.rdoc

@@ -0,0 +1,36 @@
+= SaySo API Client
+
+Ruby gem to use the full SaySo API.
+Currently the SaySo API is closed and for partner use only. To request an API
+key please contact us at team@truvolabs.com.
+
+For more info see:
+
+* <b>The origin of this code:</b> https://github.com/truvolabs/sayso-api-client
+* <b>SaySo:</b> https://www.sayso.com
+
+Please read the full API documentation before using!
+
+== Install
+
+Use the gem.
+
+  gem install sayso-api-client
+
+== Usage
+
+  require 'sayso'
+  sayso = Sayso.new(:consumer_key => 'your_key', :consumer_secret => 'your_secret')
+  sayso.get("/places/search?what=restaurant&where=antwerpen")
+  sayso.get("/places/search", :what => 'restaurant', :where => 'antwerpen')
+  sayso.authorize_url # go here (=> "http://api.sayso.com/api1/oauth/authorize?oauth_token=some_token_hash")
+  sayso.authorize_access_token('verifier')
+  sayso.get("/users/current")
+
+== TODO
+
+* Tests
+
+Please feel free to contribute and send me a pull request via Github!
+
+Copyright (c) 2011 Joost Hietbrink, released under the MIT license

data/lib/sayso.rb

@@ -0,0 +1,68 @@
+require 'oauth'
+require 'crack'
+require 'active_support/all'
+#
+# Example usage:
+#  sayso = Sayso.new(:consumer_key => 'your_key', :consumer_secret => 'your_secret')
+#  sayso.get("/places/search?what=restaurant&where=antwerpen")
+#  sayso.get("/places/search", :what => 'restaurant', :where => 'antwerpen')
+#  sayso.authorize_url # go here (=> "http://api.sayso.com/api1/oauth/authorize?oauth_token=some_token_hash")
+#  sayso.authorize_access_token('verifier')
+#  sayso.get("/users/current")
+#
+class Sayso
+
+  attr_accessor :version, :consumer_key, :consumer_secret, :base_url, :callback
+  attr_reader :access_token, :request_token, :response
+
+  def initialize(options = {})
+    options = {:version => 1, :base_url => 'http://api.sayso.com', :callback => nil}.merge(options)
+    options.each do |attr, value|
+      instance_variable_set(:"@#{attr}", value)
+    end
+    self.initialize_access_token
+  end
+
+  def initialize_access_token
+    return @access_token unless @access_token.nil?
+    @consumer = OAuth::Consumer.new(self.consumer_key, self.consumer_secret, {
+      :site => self.base_url,
+      :request_token_path => "/api#{self.version}/oauth/request_token",
+      :authorize_path => "/api#{self.version}/oauth/authorize",
+      :access_token_path => "/api#{self.version}/oauth/access_token" })
+    @request_token = @consumer.get_request_token(:oauth_callback => "http://localhost:3000")
+    # Just make it using the request token (and a user that has given access ?!)
+    @access_token = OAuth::AccessToken.new(@consumer, @request_token.token, @request_token.secret)
+  end
+
+  # Returns the url where to send the user to authenticate himself.
+  # After this call the authorize_access_token method to authenticate
+  # the session and be able to use write access and current_user methods.
+  def authorize_url
+    @request_token.authorize_url
+  end
+
+  # Go to the given url (see authorize_url) and you get redirected to, eg:
+  #  http://localhost:3000/?oauth_token=DGJb7aPa1XrY82a8hmJVp6IbF0qLZ9Je0pO4B7qF&oauth_verifier=iWhKZfIjPDjozBRhSDoA
+  # Call this method with the correct oauth_verifier as argument.
+  def authorize_access_token(oauth_verifier)
+    @access_token = @request_token.get_access_token(:oauth_verifier => oauth_verifier)
+  end
+
+  # Gets from the Sayso API and returns the parsed XML.
+  # Access the unparsed response using the response method.
+  # Examples:
+  #  get("/places/search?what=restaurant&where=antwerpen")
+  def get(path, params = {})
+    path = "/api#{self.version}#{path}"
+    path += "?#{params.to_query}" unless params.blank?
+    @response = @access_token.get(path)
+    result = Crack::XML.parse(@response.body)
+    HashWithIndifferentAccess.new(result)
+  end
+
+  # TODO
+  # def post/put
+  # end
+
+end

data/sayso-api-client.gemspec

@@ -0,0 +1,18 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |spec|
+  spec.name = %q{sayso-api-client}
+  spec.version = '0.1.0'
+  spec.platform = Gem::Platform::RUBY
+  spec.description = spec.summary = 'Ruby gem to use the SaySo API (v1).'
+  spec.authors = ['Joost Hietbrink']
+  spec.email = 'joost@truvolabs.com'
+  spec.homepage = %q{http://www.sayso.com}
+
+  spec.add_dependency('oauth')
+  spec.add_dependency('crack')
+  spec.add_dependency('activesupport')
+
+  spec.files = `git ls-files`.split("\n")
+  spec.require_paths = ['lib']
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: sayso-api-client
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Joost Hietbrink
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-21 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: oauth
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: crack
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: Ruby gem to use the SaySo API (v1).
+email: joost@truvolabs.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- README.rdoc
+- lib/sayso.rb
+- sayso-api-client.gemspec
+has_rdoc: true
+homepage: http://www.sayso.com
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Ruby gem to use the SaySo API (v1).
+test_files: []
+