thinknear 0.0.1

data/.document

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

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rvmrc

@@ -0,0 +1 @@
+rvm ruby-1.9.2-p0@thinknear-ruby

data/Gemfile

@@ -0,0 +1,10 @@
+source 'http://rubygems.org'
+
+gem 'oauth'
+
+group :development do
+  gem 'rspec', '~> 2.3.0'
+  gem 'bundler', '~> 1.0.0'
+  gem 'jeweler', '~> 1.5.2'
+  gem 'rcov', '>= 0'
+end

data/Gemfile.lock

@@ -0,0 +1,30 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    oauth (0.4.4)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.5.2)
+  oauth
+  rcov
+  rspec (~> 2.3.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Denis Barushev
+
+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,19 @@
+= thinknear
+
+Description goes here.
+
+== Contributing to thinknear
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Denis Barushev. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "thinknear"
+  gem.homepage = "http://github.com/denis/thinknear"
+  gem.license = "MIT"
+  gem.summary = %Q{A ThinkNear Ruby Client}
+  gem.email = "barushev@gmail.com"
+  gem.authors = ["Denis Barushev"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "thinknear #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

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

data/lib/think_near/category.rb

@@ -0,0 +1,19 @@
+module ThinkNear
+  class Category < OpenStruct
+    def self.all
+      Client.get_categories.map do |category_name|
+        new :name => category_name
+      end
+    end
+
+    def draws
+      Client.get_draws(name).map do |item|
+        Draw.new item['draw']
+      end
+    end
+
+    def attributes
+      @table
+    end
+  end
+end

data/lib/think_near/client.rb

@@ -0,0 +1,64 @@
+module ThinkNear
+  class Client
+    @@connection = nil
+    @@debug = false
+
+    class << self
+      def set_credentials(token, secret)
+        @@connection = Connection.new(token, secret)
+        @@connection.debug = @@debug
+      end
+
+      def debug=(debug_flag)
+        @@debug = debug_flag
+        @@connection.debug = @@debug  if @@connection
+      end
+
+      def debug
+        @@debug
+      end
+
+      def get_ping
+        get Endpoint.ping
+      end
+
+      def get_health
+        get Endpoint.health
+      end
+
+      def get_authenticated
+        get Endpoint.authenticated
+      end
+
+      def get_categories
+        get Endpoint.categories
+      end
+
+      def get_draws(category)
+        get Endpoint.draws(category)
+      end
+
+      def get_offers(params)
+        get Endpoint.offers(params)
+      end
+
+      def get_offer(id)
+        get Endpoint.offer(id)
+      end
+
+      def claim_offer(offer_id, latitude, longitude)
+        post Endpoint.claim_offer(offer_id, latitude, longitude)
+      end
+
+      def get(endpoint, data=nil)
+        raise NoConnectionEstablished  if @@connection.nil?
+        @@connection.get endpoint, data
+      end
+
+      def post(endpoint, data=nil)
+        raise NoConnectionEstablished  if @@connection.nil?
+        @@connection.post endpoint, data
+      end
+    end
+  end
+end

data/lib/think_near/connection.rb

@@ -0,0 +1,102 @@
+require 'oauth'
+
+module ThinkNear
+  class Connection
+
+    attr_accessor :debug
+
+    def initialize(token, secret)
+      consumer = OAuth::Consumer.new(token, secret, :site => REALM)
+      @access_token = OAuth::AccessToken.new(consumer)
+      debug = false
+    end
+
+    def get(endpoint, data=nil)
+      request :get, endpoint, data
+    end
+
+    def post(endpoint, data=nil)
+      request :post, endpoint, data
+    end
+
+    private
+
+    def request(method, endpoint, data)
+      headers = { 'User-Agent' => 'ThinkNear Ruby Client' }
+
+      if [:get].include?(method) && !data.nil?
+        endpoint = endpoint + '?' + build_query(data)
+      end
+
+      if debug
+        puts "request: #{method.to_s.upcase} #{endpoint}"
+        puts "headers:"
+        headers.each do |key, value|
+          puts "#{key}=#{value}"
+        end
+        if [:post, :put].include?(method) && !data.nil?
+          puts "data:"
+          puts data.to_json
+        end
+      end
+
+      case method
+        when :get
+          response = @access_token.request(method, endpoint, headers)
+        when :post
+          data = data.to_json  unless data.nil?
+          response = @access_token.request(method, endpoint, data, headers)
+      end
+
+      if debug
+        puts "\nresponse: #{response.code}"
+        puts "headers:"
+        response.header.each do |key, value|
+          puts "#{key}=#{value}"
+        end
+        puts "body:"
+        puts response.body
+      end
+
+      raise_errors(response)
+
+      if response.body.empty?
+        content = nil
+      else
+        begin
+          content = JSON.parse(response.body)
+        rescue JSON::ParserError
+          raise DecodeError, "content: <#{response.body}>"
+        end
+      end
+
+      content
+    end
+
+    def build_query(data)
+      data.map do |key, value|
+        [key.to_s, URI.escape(value.to_s)].join('=')
+      end.join('&')
+    end
+
+    def raise_errors(response)
+      response_description = "(#{response.code}): #{response.message}"
+      response_description += " - #{response.body}"  unless response.body.empty?
+
+      case response.code.to_i
+        when 401
+          raise Unauthorized
+        when 404
+          raise NotFound
+        when 500
+          raise ServerError, "ThinkNear had an internal error. Please let them know. #{response_description}"
+        when 502..503
+          raise Unavailable, response_description
+        else
+          unless response.is_a? Net::HTTPSuccess
+            raise ThinkNearError, response_description
+          end
+      end
+    end
+  end
+end

data/lib/think_near/draw.rb

@@ -0,0 +1,7 @@
+module ThinkNear
+  class Draw < OpenStruct
+    def attributes
+      @table
+    end
+  end
+end

data/lib/think_near/endpoint.rb

@@ -0,0 +1,46 @@
+module ThinkNear
+  class Endpoint
+    class << self
+      def ping
+        endpoint_url 'ping'
+      end
+
+      def health
+        endpoint_url 'health'
+      end
+
+      def authenticated
+        endpoint_url 'authenticated'
+      end
+
+      def categories
+        endpoint_url 'categories'
+      end
+
+      def draws(category)
+        endpoint_url "draws/#{category}"
+      end
+
+      def offers(params)
+        latitude = params.delete(:latitude)
+        longitude = params.delete(:longitude)
+
+        params = params.select { |k, v| !v.blank? }
+
+        endpoint_url("offers/#{latitude},#{longitude}") + "?#{params.to_param}"
+      end
+
+      def offer(id)
+        endpoint_url "offers/#{id}"
+      end
+
+      def claim_offer(offer_id, latitude, longitude)
+        endpoint_url "offers/#{offer_id}/claim/#{latitude},#{longitude}"
+      end
+
+      def endpoint_url(path, version = API_VERSION, format = 'json')
+        [REALM, version, [path, format].join('.')].join('/')
+      end
+    end
+  end
+end

data/lib/think_near/offer.rb

@@ -0,0 +1,21 @@
+module ThinkNear
+  class Offer < OpenStruct
+    def self.find(id_or_params)
+      if id_or_params.is_a? String
+        new Client.get_offer(id_or_params)['offer']
+      elsif id_or_params.is_a? Hash
+        Client.get_offers(id_or_params).map do |item|
+          new item['offer']
+        end
+      end
+    end
+
+    def attributes
+      @table
+    end
+
+    def claim(latitude, longitude)
+      self.class.new Client.claim_offer(id, latitude, longitude)['offer']
+    end
+  end
+end

data/lib/think_near.rb

@@ -0,0 +1,21 @@
+require 'ostruct'
+
+require 'think_near/connection'
+require 'think_near/endpoint'
+require 'think_near/client'
+require 'think_near/category'
+require 'think_near/draw'
+require 'think_near/offer'
+
+module ThinkNear
+  API_VERSION = '1.0'.freeze
+  REALM = 'http://api-sandbox.thinknear.com'
+
+  class ThinkNearError < StandardError; end
+  class Unauthorized < ThinkNearError; end
+  class NotFound < ThinkNearError; end
+  class ServerError < ThinkNearError; end
+  class Unavailable < ThinkNearError; end
+  class DecodeError < ThinkNearError; end
+  class NoConnectionEstablished < ThinkNearError; end
+end

data/lib/thinknear.rb

@@ -0,0 +1,2 @@
+# So you can require 'thinknear' instead of 'think_near'
+require 'think_near'

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'thinknear'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

data/spec/thinknear_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Thinknear" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/thinknear.gemspec

@@ -0,0 +1,76 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{thinknear}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Denis Barushev"]
+  s.date = %q{2011-03-16}
+  s.email = %q{barushev@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".rvmrc",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/think_near.rb",
+    "lib/think_near/.client.rb.swn",
+    "lib/think_near/.client.rb.swo",
+    "lib/think_near/category.rb",
+    "lib/think_near/client.rb",
+    "lib/think_near/connection.rb",
+    "lib/think_near/draw.rb",
+    "lib/think_near/endpoint.rb",
+    "lib/think_near/offer.rb",
+    "lib/thinknear.rb",
+    "spec/spec_helper.rb",
+    "spec/thinknear_spec.rb",
+    "thinknear.gemspec"
+  ]
+  s.homepage = %q{http://github.com/denis/thinknear}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{A ThinkNear Ruby Client}
+  s.test_files = [
+    "spec/spec_helper.rb",
+    "spec/thinknear_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<oauth>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<oauth>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<oauth>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification 
+name: thinknear
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Denis Barushev
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-16 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: oauth
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.5.2
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id005
+description: 
+email: barushev@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/think_near.rb
+- lib/think_near/.client.rb.swn
+- lib/think_near/.client.rb.swo
+- lib/think_near/category.rb
+- lib/think_near/client.rb
+- lib/think_near/connection.rb
+- lib/think_near/draw.rb
+- lib/think_near/endpoint.rb
+- lib/think_near/offer.rb
+- lib/thinknear.rb
+- spec/spec_helper.rb
+- spec/thinknear_spec.rb
+- thinknear.gemspec
+has_rdoc: true
+homepage: http://github.com/denis/thinknear
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3128978856162919585
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A ThinkNear Ruby Client
+test_files: 
+- spec/spec_helper.rb
+- spec/thinknear_spec.rb