tumbz 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+gemspec
+gem "her", :git => "git://github.com/remiprev/her.git", :branch => "master"

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Rémi Prévost
+
+MIT License
+
+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.md

@@ -0,0 +1,69 @@
+# Tumbz
+
+This gem allows you to easily use the [Tum.bz API](http://tum.bz/api). It’s powered by [Her](https://github.com/remiprev/her).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'tumbz'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install tumbz
+
+## Usage
+
+First, you must define a `configure` block with your API key:
+
+```ruby
+Tumbz.configure do |config|
+  config.api_key = "nzaEhGbo4B9yAOn1GKveoSL003sexY9F"
+end
+```
+
+That’s it! You’ll then be able to use :
+
+```ruby
+Tumbz::User.find("remi")
+# => #<Tumbz::User(users/4f0e32936edcb2000100029d) id="4f0e32936edcb2000100029d" username="remi" profile_url="http://tum.bz/u/remi" firstname="Rémi" lastname="Prévost"…>
+```
+
+Other modules are:
+
+* `Tumbz::Comment`
+* `Tumbz::Like`
+* `Tumbz::Review`
+* `Tumbz::PartnerLookup`
+* `Tumbz::Product`
+* `Tumbz::User`
+
+The API wrapper is powered by [Her](https://github.com/remiprev/her), so most of [its documentation](https://github.com/remiprev/her) will be helpful.
+
+## OAuth
+
+Support for OAuth-authenticated calls is supported, but very premitive (not quite thread-safe). Here’s how it works:
+
+```ruby
+Tumbz::User.sign_in!("<email>", "<password>")
+# => true (next calls will be made as the authenticated user)
+
+Tumbz::Review.create(:product_external_id => "tt0458339", :positive => "1", :cat => "movie")
+# => #<Tumbz::Review(reviews/50b9ebd7a9d29c000200af7c) id="50b9ebd7a9d29c000200af7c" positive=true text=""…>
+
+Tumbz::User.sign_out!
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,22 @@
+require "bundler/gem_tasks"
+require "tumbz"
+
+task :demo do
+  Tumbz.configure do |config|
+    config.api_key = "nzaEhGbo4B9yAOn1GKveoSL003sexY9F"
+  end
+
+  p Tumbz::User.find("remi")
+  #p Tumbz::User.get(:search, :q => "bass")
+  #p Tumbz::Product.get(:search, :q => "office", :cat => "tv")
+end
+
+task :oauth do
+  Tumbz.configure do |config|
+    config.api_key = "nzaEhGbo4B9yAOn1GKveoSL003sexY9F"
+  end
+
+  #p Tumbz::User.sign_in!("", "",)
+  #p Tumbz::User.sign_out!
+  #p Tumbz::Review.create(:product_external_id => "tt0458339", :positive => "1", :cat => "movie")
+end

data/lib/tumbz/comment.rb

@@ -0,0 +1,6 @@
+module Tumbz
+  class Comment
+    include Her::Model
+    uses_api Tumbz.api
+  end
+end

data/lib/tumbz/config.rb

@@ -0,0 +1,4 @@
+module Tumbz
+  class Config
+  end
+end

data/lib/tumbz/like.rb

@@ -0,0 +1,6 @@
+module Tumbz
+  class Like
+    include Her::Model
+    uses_api Tumbz.api
+  end
+end

data/lib/tumbz/middleware/api_key.rb

@@ -0,0 +1,15 @@
+module Tumbz
+  module Middleware
+    class ApiKey < Faraday::Middleware
+      def initialize(app, options={})
+        @app = app
+        @options = options
+      end
+
+      def call(env)
+        env[:url].query = env[:url].query ? "#{env[:url].query}&apikey=#{@options[:api_key]}" : "apikey=#{@options[:api_key]}"
+        @app.call(env)
+      end
+    end
+  end
+end

data/lib/tumbz/middleware/auth.rb

@@ -0,0 +1,15 @@
+module Tumbz
+  module Middleware
+    class Auth < Faraday::Middleware
+      def initialize(app, options={})
+        @app = app
+        @options = options
+      end
+
+      def call(env)
+        env[:request_headers]["Authorization"] = "OAuth #{Tumbz.access_token}" unless Tumbz.access_token.nil?
+        @app.call(env)
+      end
+    end
+  end
+end

data/lib/tumbz/middleware/parse.rb

@@ -0,0 +1,36 @@
+module Tumbz
+  module Middleware
+    class Parse < Faraday::Response::Middleware
+      # Parse the response body
+      #
+      # @param [String] body The response body
+      # @return [Mixed] the parsed response
+      def parse(body)
+        json = MultiJson.load(body, :symbolize_keys => true)
+        errors = []
+        metadata = json.delete(:metadata) || []
+
+        if json[:error].present?
+          json.delete(:error)
+          json.delete(:message)
+          errors = [json.delete(:developerMessage)]
+        end
+
+        {
+          :data => json,
+          :errors => errors,
+          :metadata => metadata
+        }
+      end
+
+      # This method is triggered when the response has been received. It modifies
+      # the value of `env[:body]`.
+      #
+      # @param [Hash] env The response environment
+      def on_complete(env)
+        env[:body] = parse(env[:body])
+      end
+    end
+  end
+end
+

data/lib/tumbz/model.rb

@@ -0,0 +1,7 @@
+module Tumbz
+  module Model
+    def error?
+      self.respond_to?(:error) and !self.error.nil? and self.error != ""
+    end
+  end
+end

data/lib/tumbz/partner_lookup.rb

@@ -0,0 +1,6 @@
+module Tumbz
+  class PartnerLookup
+    include Her::Model
+    uses_api Tumbz.api
+  end
+end

data/lib/tumbz/product.rb

@@ -0,0 +1,6 @@
+module Tumbz
+  class Product
+    include Her::Model
+    uses_api Tumbz.api
+  end
+end

data/lib/tumbz/review.rb

@@ -0,0 +1,6 @@
+module Tumbz
+  class Review
+    include Her::Model
+    uses_api Tumbz.api
+  end
+end

data/lib/tumbz/user.rb

@@ -0,0 +1,19 @@
+module Tumbz
+  class User
+    include Model
+    include Her::Model
+    uses_api Tumbz.api
+
+    def self.sign_in!(email, password)
+      post_raw("auth", :email => email, :password => password) do |parsed_data|
+        Tumbz.access_token = parsed_data[:data][:access_token]
+      end
+
+      Tumbz.access_token.nil? ? false : true
+    end
+
+    def self.sign_out!
+      Tumbz.access_token = nil
+    end
+  end
+end

data/lib/tumbz/version.rb

@@ -0,0 +1,3 @@
+module Tumbz
+  VERSION = "0.0.1"
+end

data/lib/tumbz.rb

@@ -0,0 +1,46 @@
+# Dependencies
+require "bundler"
+Bundler.require
+
+# Modules
+require "tumbz/version"
+require "tumbz/model"
+require "tumbz/config"
+require "tumbz/middleware/parse"
+require "tumbz/middleware/api_key"
+require "tumbz/middleware/auth"
+
+module Tumbz
+  def self.api
+    @api
+  end
+
+  def self.access_token=(token)
+    @access_token = token
+  end
+
+  def self.access_token
+    @access_token
+  end
+
+  def self.configure(&blk)
+    options = OpenStruct.new
+    yield(options)
+
+    @api = Her::API.new
+    @api.setup :url => "http://api.tum.bz/v1/" do |connection|
+      connection.use Tumbz::Middleware::ApiKey, :api_key => options.api_key
+      connection.use Tumbz::Middleware::Auth
+      connection.use Faraday::Request::UrlEncoded
+      connection.use Tumbz::Middleware::Parse
+      connection.use Faraday::Adapter::NetHttp
+    end
+
+    require "tumbz/comment"
+    require "tumbz/like"
+    require "tumbz/review"
+    require "tumbz/partner_lookup"
+    require "tumbz/product"
+    require "tumbz/user"
+  end
+end

data/tumbz.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tumbz/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "tumbz"
+  gem.version       = Tumbz::VERSION
+  gem.authors       = ["Rémi Prévost"]
+  gem.email         = ["remi@exomel.com"]
+  gem.description   = %q{Ruby wrapper for the Tum.bz API}
+  gem.summary       = %q{Ruby wrapper for the Tum.bz API}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_runtime_dependency "her"
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: tumbz
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Rémi Prévost
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: her
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby wrapper for the Tum.bz API
+email:
+- remi@exomel.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/tumbz.rb
+- lib/tumbz/comment.rb
+- lib/tumbz/config.rb
+- lib/tumbz/like.rb
+- lib/tumbz/middleware/api_key.rb
+- lib/tumbz/middleware/auth.rb
+- lib/tumbz/middleware/parse.rb
+- lib/tumbz/model.rb
+- lib/tumbz/partner_lookup.rb
+- lib/tumbz/product.rb
+- lib/tumbz/review.rb
+- lib/tumbz/user.rb
+- lib/tumbz/version.rb
+- tumbz.gemspec
+homepage: ''
+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'
+      segments:
+      - 0
+      hash: -3848226679834362904
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3848226679834362904
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for the Tum.bz API
+test_files: []