whatser 0.5.0 → 0.6.0

data/README.rdoc

@@ -27,7 +27,7 @@ Declare Whatser in your Gemfile:
 
     gem 'whatser', :git => "git@github.com:sogeo/whatser"
 
-And instantiate a Whatser client as need:
+And instantiate a Whatser client as needed:
 
     client = Whatser::Client.new(:api_key => 'key', :api_secret => 'secret', :oauth_token => '123abc', :logger => Rails.logger)
 
@@ -66,7 +66,7 @@ Once you have an oauth token for a user, you can access the Whatser API by insta
 
     client = Whatser::Client.new( :oauth_token => '123abc' )
     client.authorized?
-    authenticated_user = client.user.me
+    authenticated_user = client.users.me
     spots = client.spots.search(:geo => "52.3665312,4.8931739", :text => "pizza", :per_page => 30).data
     spots.each { |spot| spot.tag('my tag') }
     a_spot = client.spots.find(12345).data
@@ -140,6 +140,13 @@ A spot is a named geographical location and the most fundamental kind of content
 
     <Whatser::Poi @lng=4.0, @region="Noord Holland", @gowalla_id="123456", @lat=52.0, @tag_list=nil, @city="Amsterdam", @name="Example Spot", @country="Netherlands", @street="example street", @id=101, @postal_code="1012", @foursquare_id="123456", @created_at="2010-12-24T16:46:23Z">
 
+You can also lists of users who have interacted with a spot in some way, either by checking-in or by adding it to their collection. These methods can be called directly from a spot, or by the User class.
+
+    users = my_spot.visitors( :page => 1, :per_page => 10 )
+    users = my_spot.collectors( :page => 1, :per_page => 10 )
+
+    users = Whatser.client.users.visitors(spot_id, :page => 1, :per_page => 10 )
+    users = Whatser.client.users.collectors(spot_id, :page => 1, :per_page => 10 )
 
 === Collections
 

data/VERSION

@@ -1 +1 @@
-0.5.0
+0.6.0

data/lib/whatser/resources/poi.rb

@@ -71,6 +71,14 @@ module Whatser
     def comments(opts={})
       Whatser::Comment.set(self.class.client).poi(id, opts)
     end
+    
+    def visitors(opts={})
+      Whatser::User.set(self.class.client).visitors(id, opts)
+    end
+    
+    def collectors(opts={})
+      Whatser::User.set(self.class.client).collectors(id, opts)
+    end    
         
     def foursquare_connected?
       !foursquare_id.blank?

data/lib/whatser/resources/user.rb

@@ -35,6 +35,14 @@ module Whatser
       def invite(emails)
         api_request :post, "/api/invites", {:query => {'emails' => emails} }
       end
+      
+      def visitors(id, params={})
+        api_request :get, "/api/poi/#{id}/visitors", {:query => params}
+      end      
+
+      def collectors(id, params={})
+        api_request :get, "/api/poi/#{id}/collectors", {:query => params}
+      end      
     end      
 
     def save

data/test/test_poi.rb

@@ -81,6 +81,14 @@ class TestPoi < Test::Unit::TestCase
     assert @poi.comments(:opt => 'test').is_a?(Whatser::Response)
   end   
   
+  def test_visitors
+    assert @poi.visitors.is_a?(Whatser::Response)
+  end
+  
+  def test_collectors
+    assert @poi.collectors.is_a?(Whatser::Response)
+  end  
+  
   def branded_tags
     @poi.branded_tags = nil
     assert_nil @poi.branded_tags

data/test/test_user.rb

@@ -22,6 +22,14 @@ class TestUser < Test::Unit::TestCase
     assert @client.users.suggested.is_a?(Whatser::Response)
   end  
   
+  def test_visitors
+    assert @client.users.visitors(1).is_a?(Whatser::Response)
+  end
+  
+  def test_collectors
+    assert @client.users.collectors(1).is_a?(Whatser::Response)
+  end    
+  
   def test_find
     assert @client.users.find(1, :opt => 'test').is_a?(Whatser::Response)
   end

data/whatser.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{whatser}
-  s.version = "0.5.0"
+  s.version = "0.6.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Travis Dunn"]
-  s.date = %q{2011-03-04}
+  s.date = %q{2011-03-15}
   s.description = %q{The 'Whatser API' Gem is a simple Ruby / Rails wrapper for interacting with Whatser's location-based web services (see http://docs.sogeoapi.com for more details).}
   s.email = %q{cmd@travisdunn.com}
   s.extra_rdoc_files = [

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: whatser
 version: !ruby/object:Gem::Version 
-  hash: 11
+  hash: 7
   prerelease: false
   segments: 
   - 0
-  - 5
+  - 6
   - 0
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors: 
 - Travis Dunn
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-04 00:00:00 +01:00
+date: 2011-03-15 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency