whatser 0.2.0

data/lib/whatser/net/http.rb

@@ -0,0 +1,26 @@
+module Whatser
+  module Http
+    include HTTParty
+    
+    def self.included(base)
+      base_uri base.api_uri
+    end
+    
+    def request(verb, path, params={}, options={})
+      response = HTTParty.send( verb, compose_url(path), request_options( params ) )
+      Whatser::Response.new( response.body, {:code => response.code}.merge(options) ) 
+    end
+    
+  private
+
+    def compose_url(path)
+      "#{api_uri}#{path}"
+    end
+
+    def request_options(params={})
+      params ||= {}
+      return { :query => {:oauth_token => oauth_token}.merge(params[:query] || {}), 
+               :body => params[:body] }
+    end
+  end
+end

data/lib/whatser/net/oauth.rb

@@ -0,0 +1,41 @@
+require 'oauth2'
+
+module Whatser
+  module OAuth
+    def oauth_client
+      OAuth2::Client.new(api_key, api_secret, :site => api_uri)
+    end
+    
+    def get_oauth_token(code, params={})
+      oauth_client.web_server.get_access_token( code, params)
+    end
+    
+    def oauth_authorize_url(params={})
+      oauth_client.web_server.authorize_url(params)
+    end
+    
+    def login(email, password)
+      request( :get, '/oauth/access_token', {:query => password_grant_params(email, password)}, :auth => :key, :keys => auth_keys )
+    end
+    
+  private
+
+    def auth_keys
+      ['access_token','refresh_token','expires_in']
+    end
+
+    def hash_to_query(hash)
+      hash.collect do |key, value|
+        "#{key}=#{value}"
+      end * '&'
+    end
+    
+    def password_grant_params(email, password)
+      {'grant_type' => 'password', 
+       'client_id' => api_key,
+       'client_secret' => api_secret,
+       'username' => email,
+       'password' => password}
+    end
+  end  
+end

data/lib/whatser/resources/activity_feed.rb

@@ -0,0 +1,20 @@
+module Whatser
+  class ActivityFeed < Whatser::Resource
+    attr_accessor :user_id,:user_name,:user_avatar,:poi_id,:poi_name,:object_id,:object_name,:object_avatar
+    attr_accessor :city,:message,:created_At
+    
+    class << self
+      def mine(params={})
+        user('me', params)
+      end
+      
+      def global(params={})
+        api_request :get, "/api/users/activity_feed", {:query => params}
+      end      
+      
+      def user(user_id, params={})
+        api_request :get, "/api/users/#{user_id}/activity_feed", {:query => params}
+      end        
+    end    
+  end
+end

data/lib/whatser/resources/check_in.rb

@@ -0,0 +1,25 @@
+module Whatser
+  class CheckIn < Whatser::Resource
+    attr_accessor :id,:user_id,:poi_id
+    attr_accessor :name,:lat,:lng,:check_in_at,:check_out_at,:rating,:message
+    attr_accessor :locate_user, :gowalla_share, :foursquare_share
+ 
+    class << self
+      def list(opts={})
+        api_request :get, "/api/check_ins", {:query => opts}
+      end
+      
+      def create(poi_id, params={})
+        api_request :post, "/api/poi/#{poi_id}/check_ins", {:body => {'check_in' => params} }
+      end        
+    end      
+    
+    def save
+      self.class.create( self.poi_id, self.to_params )
+    end
+    
+    def to_params
+      {:lat => lat, :lng => lng, :locate => locate_user, :gowalla => gowalla_share, :foursquare => foursquare_share, :check_in_at => check_in_at, :check_out_at => check_out_at}
+    end      
+  end
+end

data/lib/whatser/resources/city.rb

@@ -0,0 +1,16 @@
+module Whatser
+  class City < Whatser::Resource
+    attr_accessor :name,:count
+    alias :collections_count :count
+    
+    class << self
+      def mine(params={})
+        api_request :get, "/api/users/me/black/book/cities", {:query => params}
+      end
+      
+      def user(user_id, params={})
+        api_request :get, "/api/users/#{user_id}/black/book/cities", {:query => params}
+      end        
+    end      
+  end
+end

data/lib/whatser/resources/collection.rb

@@ -0,0 +1,68 @@
+module Whatser
+  class Collection < Whatser::Resource
+    include Enumerable
+    
+    attr_accessor :data,:city,:city_name
+    
+    class << self
+      def mine(opts={})
+        collect_api_request :get, "/api/users/me/black/book", {:query => opts}
+      end
+      
+      def list(user_id, opts={})
+        collect_api_request :get, "/api/users/#{user_id}/black/book", {:query => opts}
+      end   
+      
+      def add(poi_id, opts={})
+        api_request :post, "/api/poi/#{poi_id}/black/book", {:body => ''}, :model => Whatser::Poi
+      end
+      
+      def delete(poi_id)
+        api_request :delete, "/api/poi/#{poi_id}/black/book", {:body => ''}, :model => Whatser::Poi
+      end   
+      
+    private
+
+      def collect_api_request(verb, path, opts={})
+        res = api_request(verb, path, opts, :model => Whatser::Poi)
+        collection = Whatser::Collection.new(res.data)
+ 
+        collection.data = res.data
+        res.data = collection
+        return res
+      end             
+    end
+    
+    def add(poi_id, opts={})
+      Whatser::Collection.add(poi_id, opts)
+    end
+    
+    def delete(poi_id)
+      Whatser::Collection.delete(poi_id, opts)
+    end      
+    
+    def initialize(collection_data=nil)
+      self.data = collection_data || []
+      set_city
+    end      
+    
+    def each(&block)
+      (data || []).each(&block)
+    end      
+    
+    def size
+      (data || []).size
+    end
+    
+  private      
+    
+    def set_city
+      self.city ||= []
+      data.each do |poi|
+        next unless poi.is_a?(Whatser::Poi)
+        self.city << poi.city unless city.include?(poi.city)
+      end
+      self.city_name = city.join(", ")
+    end
+  end
+end

data/lib/whatser/resources/data_source.rb

@@ -0,0 +1,24 @@
+module Whatser
+  class DataSource < Whatser::Resource
+    attr_accessor :id
+    attr_accessor :name,:price,:review_count,:media_count,:collection_count,:poi_count
+    attr_accessor :users
+    
+    class << self
+      def list(opts={})
+        api_request :get, "/api/data_sources", {:query => opts}
+      end
+      
+      def for_users(user_id, opts={})
+        user_id = user_id.is_a?(Array) ? user_id.join(',') : user_id
+        api_request :get, "/api/data_sources", {:query => {:user_id => user_id}.merge(opts || {})}
+      end      
+    end
+    
+    def subscription_url(opts={})
+      url = "#{self.class.client.api_uri}/payments/data_sources/#{id}/orders/new?oauth_token=#{self.class.client.oauth_token}"
+      url = "#{url}&#{opts.to_params}" unless opts.blank?
+      url
+    end
+  end
+end

data/lib/whatser/resources/detail.rb

@@ -0,0 +1,40 @@
+module Whatser
+  class Detail < Whatser::Resource
+    attr_accessor :id,:user_id,:poi_id
+    attr_accessor :data,:created_at
+    
+    class << self
+      def list(poi_id, opts={})
+        api_request :get, "/api/poi/#{poi_id}/details", {:query => opts}
+      end
+              
+      def find(poi_id, id, opts={})
+        api_request :get, "/api/poi/#{poi_id}/details/#{id}", {:query => opts}
+      end
+      
+      def create(poi_id, params={})
+        api_request :post, "/api/poi/#{poi_id}/details", {:body => {'detail' => params} }
+      end  
+      
+      def delete(poi_id, id)
+        api_request :delete, "/api/poi/#{poi_id}/details/#{id}"
+      end              
+    end      
+    
+    def save
+      if id.blank?
+        self.class.create(poi_id, to_params)
+      else
+        api_request :put, "/api/poi/#{poi_id}/details/#{id}", {:body => {'detail' => to_params} }
+      end
+    end           
+    
+    def delete
+      self.class.delete(poi_id, id)
+    end       
+    
+    def to_params
+      {:data => data}
+    end
+  end
+end

data/lib/whatser/resources/follow.rb

@@ -0,0 +1,42 @@
+module Whatser
+  class Follow < Whatser::Resource
+    attr_accessor :id
+    attr_accessor :name,:avatar_pic,:location
+    attr_accessor :promoted,:premium,:collections_count
+    attr_accessor :following,:followed,:foaf_count,:foaf
+    
+    class << self
+      def list(opts={})
+        api_request :get, "/api/follows", {:query => opts}
+      end
+      
+      def suggested(opts={})
+        api_request :get, "/api/users/suggested", {:query => opts}
+      end        
+      
+      def create(user_id, opts={})
+        api_request :post, "/api/follows/#{user_id}", {:query => opts, :body => ''}
+      end
+
+      def delete(user_id)
+        api_request :delete, "/api/follows/#{user_id}"
+      end
+      
+      def ignore(user_id)
+        delete(user_id)
+      end
+      
+      def connection(user_id)
+        api_request :get, "/api/users/#{user_id}/connection"
+      end        
+    end
+    
+    def save
+      self.class.create( id )
+    end      
+    
+    def delete
+      self.class.ignore( id )
+    end
+  end
+end

data/lib/whatser/resources/media.rb

@@ -0,0 +1,41 @@
+module Whatser
+  class Media < Whatser::Resource
+    attr_accessor :id,:user_id,:poi_id
+    attr_accessor :name,:thumb_pic,:small_pic,:mid_pic,:url,:mime,:created_at
+    attr_writer   :resource,:remote_resource
+    
+    class << self
+      def list(poi_id, opts={})
+        api_request :get, "/api/poi/#{poi_id}/media", {:query => opts}
+      end
+              
+      def find(poi_id, id, opts={})
+        api_request :get, "/api/poi/#{poi_id}/media/#{id}", {:query => opts}
+      end
+      
+      def create(poi_id, params={})
+        api_request :post, "/api/poi/#{poi_id}/media", {:body => {'media' => params} }
+      end  
+      
+      def delete(poi_id, id)
+        api_request :delete, "/api/poi/#{poi_id}/media/#{id}"
+      end              
+    end
+    
+    def save
+      if id.blank?
+        Whatser::Media.create(poi_id, to_params)
+      else
+        api_request :put, "/api/poi/#{poi_id}/media/#{id}", {:body => {'media' => to_params} }
+      end
+    end           
+    
+    def delete
+      Whatser::Media.delete(poi_id, id)
+    end       
+    
+    def to_params
+      {:name=>name,:resource=>@resource,:remote_resource=>@remote_resource}
+    end      
+  end
+end

data/lib/whatser/resources/poi.rb

@@ -0,0 +1,74 @@
+module Whatser
+  class Poi < Whatser::Resource
+    attr_accessor :id,:user_id,:gowalla_id,:foursquare_id
+    attr_accessor :name,:lat,:lng,:street,:district,:region,:city,:postal_code,:country
+    attr_accessor :tag_list,:created_at
+    
+    class << self
+      def suggested(opts={})
+        api_request :get, "/api/poi/suggested", {:query => opts}
+      end
+
+      def search(opts={})
+        api_request :get, "/api/poi", {:query => opts}
+      end
+      
+      def find(id, opts={})
+        api_request :get, "/api/poi/#{id}", {:query => opts}
+      end
+      
+      def create(params={})
+        api_request :post, "/api/poi", {:body => {'poi' => params} }
+      end
+      
+      def delete(poi_id)
+        api_request :delete, "/api/poi/#{poi_id}"
+      end        
+    end
+    
+    def save
+      if id.blank?
+        self.class.create(to_params)
+      else
+        api_request :put, "/api/poi/#{id}", {:body => {'poi' => to_params} }
+      end
+    end
+    
+    def delete
+      Whatser::Poi.delete(id)
+    end
+    
+    def tag(tag_name)
+      Whatser::Tag.create(id, tag_name)
+    end
+    
+    def tags(opts={})
+      Whatser::Tag.list(id, opts)
+    end
+
+    def media(opts={})
+      Whatser::Media.list(id, opts)
+    end
+    
+    def reviews(opts={})
+      Whatser::Review.list(id, opts)
+    end
+    
+    def details(opts={})
+      Whatser::Detail.list(id, opts)
+    end            
+    
+    def foursquare_connected?
+      !foursquare_id.blank?
+    end
+    
+    def gowalla_connected?
+      !gowalla_id.blank?
+    end      
+    
+    def to_params
+      {:name=>name,:lat=>lat,:lng=>lat,:street=>street,:district=>district,
+       :region=>region,:city=>city,:postal_code=>postal_code,:country=>country}
+    end
+  end
+end

data/lib/whatser/resources/resource.rb

@@ -0,0 +1,53 @@
+module Whatser
+  class Resource
+    attr_accessor :json
+    
+    class << self   
+      def client
+        @client
+      end
+      
+      def set(client)
+        @client = client
+        self
+      end
+      
+      def api_request(verb, path, params={}, opts={})
+        res = client.request(verb, path, params)
+        res.data = convert_data_to_model( res.data, opts)
+        return res
+      end
+
+      def convert_data_to_model(data, opts={})
+        return data if data.blank?
+        opts ||= {}
+
+        data = if data.is_a?(Array)
+          data.inject([]) {|result,d| result << from_hash_to_model(d, opts[:model]) }
+        else
+          from_hash_to_model(data, opts[:model])
+        end
+        data
+      end
+      
+      def from_hash_to_model(hash, model=nil)
+        hash ||= {}
+        hash = hash.size == 1 ? hash.first.last : hash
+        mod = model.blank? ? new : model.new
+        hash.each do |k,v|
+          mod.send("#{k}=", v) if mod.respond_to?(k)
+        end
+        mod.json = hash.to_json
+        return mod
+      end
+    end
+    
+    def initialize(params={})
+      params.each_pair { |k,v| send("#{k}=", v) if respond_to?(k) }
+    end
+    
+    def api_request(verb, path, params={}, opts={})
+      self.class.api_request(verb, path, params, opts)
+    end
+  end
+end

data/lib/whatser/resources/review.rb

@@ -0,0 +1,40 @@
+module Whatser
+  class Review < Whatser::Resource
+    attr_accessor :id,:user_id,:poi_id
+    attr_accessor :body,:created_at
+    
+    class << self
+      def list(poi_id, opts={})
+        api_request :get, "/api/poi/#{poi_id}/reviews", {:query => opts}
+      end
+              
+      def find(poi_id, id, opts={})
+        api_request :get, "/api/poi/#{poi_id}/reviews/#{id}", {:query => opts}
+      end
+      
+      def create(poi_id, params={})
+        api_request :post, "/api/poi/#{poi_id}/reviews", {:body => {'review' => params} }
+      end
+      
+      def delete(poi_id, id)
+        api_request :delete, "/api/poi/#{poi_id}/reviews/#{id}"
+      end               
+    end      
+    
+    def save
+      if id.blank?
+        self.class.create(poi_id, to_params)
+      else
+        api_request :put, "/api/poi/#{poi_id}/reviews/#{id}", {:body => {'review' => to_params} }
+      end
+    end           
+    
+    def delete
+      self.class.delete(poi_id, id)
+    end       
+    
+    def to_params
+      {:body => body}
+    end      
+  end
+end

data/lib/whatser/resources/subscription.rb

@@ -0,0 +1,12 @@
+module Whatser
+  class Subscription < Whatser::Resource
+    attr_accessor :id,:data_source_id
+    attr_accessor :data_source_name,:created_at
+    
+    class << self
+      def list(params={})
+        api_request :get, "/api/subscriptions", {:query => params}
+      end
+    end      
+  end
+end

data/lib/whatser/resources/tag.rb

@@ -0,0 +1,32 @@
+module Whatser
+  class Tag < Whatser::Resource
+    attr_accessor :id,:poi_id
+    attr_accessor :name
+    
+    class << self
+      def list(poi_id, opts={})
+        api_request :get, "/api/poi/#{poi_id}/tags", {:query => opts}
+      end
+      
+      def create(poi_id, tag_name)
+        api_request :post, "/api/poi/#{poi_id}/tags", {:body => {'tagging' => {'name' => tag_name}} }
+      end
+      
+      def delete(poi_id, tag_name)
+        api_request :delete, "/api/poi/#{poi_id}/tags/#{tag_name}"
+      end        
+    end
+    
+    def save
+      self.class.create(poi_id, name)
+    end
+    
+    def delete
+      self.class.delete(poi_id, name)
+    end
+    
+    def to_params
+      {:name => name}
+    end      
+  end
+end

data/lib/whatser/resources/user.rb

@@ -0,0 +1,81 @@
+module Whatser
+  class User < Whatser::Resource
+    attr_accessor :id,:facebook_id,:gowalla_id,:foursquare_id,:twitter_id
+    attr_accessor :name,:twitter_name,:avatar_pic,:location,:bio,:email
+    attr_accessor :last_login_at,:promoted,:premium,:collections_count
+    attr_writer   :avatar,:remote_avatar,:password,:lat,:lng
+    attr_writer   :access_tokens
+    
+    class << self
+      def me
+        api_request :get, "/api/users/me"
+      end
+      
+      def anonymous
+        api_request :get, "/api/users/anonymous"
+      end
+      
+      def search(params={})
+        api_request :get, "/api/users/lookup", {:query => params}
+      end        
+      
+      def suggested(params={})
+        api_request :get, "/api/users/suggested", {:query => params}
+      end        
+      
+      def find(id, params={})
+        api_request :get, "/api/users/#{id}/profile", {:query => params}
+      end
+              
+      def create(params={})
+        api_request :post, "/api/users", {:body => {'user' => params} }, :auth => :key
+      end
+
+      def invite(emails)
+        api_request :post, "/api/invites", {:query => emails}
+      end
+    end      
+
+    def save
+      if id.blank?
+        api_request :post, "/api/users", {:body => {'user' => to_params} }, :auth => :key
+      else
+        api_request :put, "/api/users/me", {:body => {'user' => to_params} }
+      end
+    end
+          
+    def connection
+      Whatser::Follow.connection(id)
+    end 
+    
+    def oauth_token
+      if access_tokens.blank? 
+        nil
+      elsif access_tokens.is_a?(Array)
+        access_tokens.first
+      else
+        access_token
+      end
+    end
+    
+    def facebook_connected?
+      !facebook_id.blank?
+    end
+    
+    def foursquare_connected?
+      !foursquare_id.blank?
+    end
+    
+    def gowalla_connected?
+      !gowalla_id.blank?
+    end
+    
+    def twitter_connected?
+      !twitter_id.blank?
+    end                             
+          
+    def to_params
+      {:name=>name,:avatar_pic=>@remote_avatar,:location=>location,:bio=>bio,:email=>email}
+    end      
+  end
+end

data/lib/whatser.rb

@@ -0,0 +1,38 @@
+require 'rubygems'
+require 'httparty'
+
+require File.expand_path('../whatser/net/http', __FILE__)
+require File.expand_path('../whatser/net/oauth', __FILE__)
+require File.expand_path('../whatser/configuration', __FILE__)
+require File.expand_path('../whatser/client', __FILE__)
+require File.expand_path('../whatser/errors', __FILE__)
+require File.expand_path('../whatser/api/response', __FILE__)
+
+require File.expand_path('../whatser/resources/resource', __FILE__)
+require File.expand_path('../whatser/resources/city', __FILE__)
+require File.expand_path('../whatser/resources/check_in', __FILE__)
+require File.expand_path('../whatser/resources/collection', __FILE__)
+require File.expand_path('../whatser/resources/data_source', __FILE__)
+require File.expand_path('../whatser/resources/detail', __FILE__)
+require File.expand_path('../whatser/resources/media', __FILE__)
+require File.expand_path('../whatser/resources/poi', __FILE__)
+require File.expand_path('../whatser/resources/review', __FILE__)
+require File.expand_path('../whatser/resources/subscription', __FILE__)
+require File.expand_path('../whatser/resources/tag', __FILE__)
+require File.expand_path('../whatser/resources/user', __FILE__)
+require File.expand_path('../whatser/resources/follow', __FILE__)
+require File.expand_path('../whatser/resources/activity_feed', __FILE__)
+
+require File.expand_path('../whatser/api/service', __FILE__)
+require File.expand_path('../whatser/api/facebook', __FILE__)
+require File.expand_path('../whatser/api/foursquare', __FILE__)
+require File.expand_path('../whatser/api/twitter', __FILE__)
+require File.expand_path('../whatser/api/gowalla', __FILE__)
+
+module Whatser
+  class << self  
+    def client(options={})
+      @client ||= Whatser::Client.new(options)
+    end
+  end   
+end