hoccer-api 1.0.4

data/.document

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

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 hukl
+
+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.textile

@@ -0,0 +1,33 @@
+h2. Usage
+
+bc.. # Create new LinccerClient instance
+client = LinccerClient.new
+
+# Update client environment
+client.update_environment(
+  :gps => {:longitude => 12.2, :latitude => 14.2, :accuracy => 23.0}
+)
+
+# Share data
+# The share method expects a mode and an arbitrary ruby hash which will
+# be transformed to JSON and used as the payload.
+c.share( "one-to-one", :foo => "bar" )
+
+# Receive data
+# The receive method expects a mode parameter and returns a ruby hash
+# containing the payload
+c.receive( "one-to-one" )
+
+p. The share and receive method have threaded counterparts allowing to perform
+both actions non blocking on the same ruby process.
+
+h2. Install
+
+Install the gem via rubygems (once the api is public)
+
+bc. gem install hoccer-api
+
+or clone and build it manually via:
+
+bc.. git clone git@github.com:hoccer/ruby-api.git
+cd ruby-api && gem build hoccer-api.gemspec && gem install hoccer-api-1.0.0.gem

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "geo_store_client"
+    gem.summary = %Q{ one-line summary of your gem}
+    gem.description = %Q{ longer description of your gem}
+    gem.email = "contact@smyck.org"
+    gem.homepage = "http://github.com/hukl/geo_store_client"
+    gem.authors = ["hukl"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "geo_store_client #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.10.0

data/lib/geo_store_client.rb

@@ -0,0 +1,91 @@
+require 'net/http'
+require 'json'
+
+module Hoccer
+
+  class GeoStoreClient
+
+    def initialize
+      @server = "geostore.beta.hoccer.com"
+      @port   = 80
+    end
+
+    def validate options, key, class_name
+      unless options[key] && options[key].is_a?( class_name )
+        raise(
+          ArgumentError,
+          "#{key.capitalize} is missing or not a #{class_name.to_s}"
+        )
+      end
+    end
+
+    def prepare options
+      validate options, :longitude, Float
+      validate options, :latitude,  Float
+      validate options, :params,    Hash
+
+      {
+        :environment => {
+          :gps => {
+            :longitude  => options[:longitude],
+            :latitude   => options[:latitude],
+            :accuracy   => options[:accuracy] || 5
+          }
+        },
+        :params   => options[:params],
+        :lifetime => options[:liftime]
+      }
+    end
+
+    def store options
+      data = prepare( options )
+      post "/store", data
+    end
+
+    def remove uuid
+      delete "/store/#{uuid}"
+    end
+
+    def search_within_radius options
+      validate options, :longitude, Float
+      validate options, :latitude,  Float
+      validate options, :radius,    Float
+
+      options[:accuracy] = options.delete(:radius)
+
+      post "/query", { :gps => options }
+    end
+
+    def search_within_region options
+      validate options, :region,    Array
+
+      unless options[:region].all? {|x| x.is_a? Array}
+        raise ArgumentError, "Region must be of format [[lon1,lat1], [lon2,lat2]]"
+      end
+
+      post "/query", { :box => options[:region] }
+    end
+
+    def request method, path, data = {}
+      if method == :delete
+        Net::HTTP.start(@server, @port) do |http|
+          req = Net::HTTP::Delete.new(path)
+          response = http.request(req)
+        end
+      else
+        Net::HTTP.start(@server, @port) do |http|
+          http.send( "request_#{method}".to_sym, path, data.to_json)
+        end
+      end
+    end
+
+    def method_missing name, *args
+      if %w(get post put delete).include? name.to_s
+        request name, *args
+      else
+        super
+      end
+    end
+  end
+
+end

data/lib/linccer_client.rb

@@ -0,0 +1,148 @@
+require 'uuid'
+require 'json'
+require 'net/http'
+
+class Hash
+  def to_url_params
+    elements = []
+    keys.size.times do |i|
+      elements << "#{keys[i]}=#{values[i]}"
+    end
+    elements.join('&')
+  end
+end
+
+module Hoccer
+  class LinccerClient
+
+    attr_accessor :uuid
+
+    def self.create
+      client = self.new
+      client
+    end
+
+    def initialize options = {}
+      @uuid = UUID.generate
+      @host = options[:host] || "linccer.beta.hoccer.com"
+      @port = options[:port] || 80
+    end
+
+    def client_path
+      "/v3/clients/#{@uuid}"
+    end
+
+    def environment_path
+      "/v3/clients/#{@uuid}/environment"
+    end
+
+    def action_path mode, options = {}
+      path = "/v3/clients/#{@uuid}/action/#{mode}"
+      path << '?' + options.to_url_params unless options.empty?
+
+      path
+    end
+    
+    def peek_path id = nil
+      path = "/v3/clients/#{uuid}/peek"
+      if id
+        path << '?' + 'group_id=' + id
+      end
+      
+      path
+    end
+
+    def update_environment data
+      handle_response put(environment_path, data.to_json)
+    end
+
+    def share mode, data
+      handle_response put(action_path(mode), data.to_json)
+    end
+
+    def receive mode, options = {}
+      handle_response get(action_path(mode, options))
+    end
+
+    def peek id = nil
+      handle_response get(peek_path(id))
+    end
+
+    def handle_response response = nil
+      if response.nil?
+        raise Hoccer::NoServerResponse
+      end
+
+      case response.header.code
+
+      when "200"
+        return parse_json( response.body )
+      when "201"
+        return true
+      when "204"
+        return nil
+      when "409"
+        return nil
+      when "412"
+        raise Hoccer::InvalidEnvironment
+      else
+        raise(
+          Hoccer::InvalidServerResponse,
+          "#{response.header.code} + #{response.header.message} +\n\n #{ response.header.inspect}"
+        )
+      end
+    end
+
+    def parse_json response_body
+      begin
+        payload = JSON.parse( response_body )
+      rescue JSON::ParserError => e
+        raise Hoccer::InvalidJsonResponse, "Could not parse JSON"
+      end
+    end
+
+    def follow_redirect
+      if @redirect_location
+        url = URI.parse @redirect_location
+        Net::HTTP.start(url.host, url.port) do |http|
+          http.get( url.path )
+        end
+      end
+    end
+
+    def follow_redirect_threaded
+      t = Thread.new do
+        follow_redirect
+      end
+      t.value
+    end
+
+    def delete_environment
+      req = Net::HTTP::Delete.new(environment_path)
+      Net::HTTP.start(@host, @port) do |http|
+        response = http.request(req)
+      end
+    end
+
+    def request method, path, data = nil
+      Net::HTTP.start(@host, @port) do |http|
+        http.send( "request_#{method}".to_sym, path, data )
+      end
+    end
+
+    def method_missing name, *args
+      if %w(get post put delete).include? name.to_s
+        request name, *args
+      else
+        super
+      end
+    end
+
+  end
+
+  class NoServerResponse      < ArgumentError; end
+  class InvalidServerResponse < ArgumentError; end
+  class InvalidJsonResponse   < ArgumentError; end
+  class InvalidEnvironment    < ArgumentError; end
+
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'geo_store_client'
+require 'linccer_client'
+
+class Test::Unit::TestCase
+end

data/test/test_geo_store_client.rb

@@ -0,0 +1,4 @@
+require 'helper'
+
+class TestGeoStoreClient < Test::Unit::TestCase
+end

data/test/test_linccer_client.rb

@@ -0,0 +1,30 @@
+require 'helper'
+
+class TestLinccerClient < Test::Unit::TestCase
+  include Hoccer
+
+  def test_linccer_client
+    assert c = LinccerClient.new( :host => "linccer.beta.hoccer.com", :port => 80)
+    assert d = LinccerClient.new( :host => "linccer.beta.hoccer.com", :port => 80)
+    puts c.inspect
+    puts
+
+    response = c.update_environment(
+      :gps => {:longitude => 12.2, :latitude => 14.2, :accuracy => 23.0}
+    )
+    puts response.inspect
+    puts
+
+    response = d.update_environment(
+      :gps => {:longitude => 12.2, :latitude => 14.2, :accuracy => 23.0}
+    )
+    puts response.inspect
+    puts
+
+    t1 = c.share_threaded( "one-to-one", :foo => "bar" )
+    t2 = d.receive( "one-to-one" )
+
+    puts t2.inspect
+    puts t1.value.inspect
+  end
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: hoccer-api
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 4
+  version: 1.0.4
+platform: ruby
+authors: 
+- hoccer GmbH
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-27 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: " Simple hoccer api clients "
+email: info@hoccer.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.textile
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.textile
+- Rakefile
+- VERSION
+- lib/geo_store_client.rb
+- lib/linccer_client.rb
+- test/helper.rb
+- test/test_geo_store_client.rb
+- test/test_linccer_client.rb
+has_rdoc: true
+homepage: http://github.com/hoccer/ruby-api
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: Simple hoccer api clients
+test_files: 
+- test/helper.rb
+- test/test_geo_store_client.rb
+- test/test_linccer_client.rb