skittles 0.3.1 → 0.4.0

data/lib/skittles/client/user.rb

@@ -81,6 +81,15 @@ module Skittles
       def friends(id, options = {})
         get("users/#{id}/friends").friends
       end
+      # Returns the user's leaderboard.
+      #
+      # @param neightbors [Integer] Number of friends' scores to return that are adjacent to your score in ranked order. The current user's score is returned as well.
+      # @return [Hashie::Mash] A count and items containing compact user objects, their respective scores, and their integer rank value relative to the current user.
+      # @requires_acting_user Yes
+      # @see https://developer.foursquare.com/docs/users/leaderboard.html
+      def leaderboard(neighbors = nil)
+        get('users/leaderboard').leaderboard
+      end
       
       # Changes whether the acting user will receive pings (phone
       # notifications) when the specified user checks in. 

data/lib/skittles/client/venue.rb

@@ -47,6 +47,26 @@ module Skittles
         get('venues/categories').categories
       end
       
+      # Returns a list of recommended venues near the current location.
+      #
+      # @note This is an experimental API.
+      # @param ll [String] Latitude and longitude of the user's location.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Decimal] llAcc Accuracy of latitude and longitude, in meters.
+      # @option options [Decimal] alt Altitude of the user's location, in meters.
+      # @option options [Decimal] altAcc Accuracy of the user's altitude, in meters.
+      # @option radius [Integer] Radius to search within, in meters.
+      # @option section [String] One of food, drinks, coffee, shops, or arts. Limits results to venues with categories matching these terms.
+      # @option query [String] A search term to be applies against tips, category tips, etc. at a venue.
+      # @option limit [Integer] Number of results to return, up to 50.
+      # @option basis [String] If present and set to friends or me, limits results to only places where friends have visited or user has visited, respectively.
+      # @return [Hashie::Mash] Response fields keywords, warnings and groups.
+      # @requires_acting_user No
+      # @see https://developer.foursquare.com/docs/venues/explore.html
+      def explore(ll, options = {})
+        get('venues/explore', { :ll => ll }.merge(options)).groups
+      end
+      
       # Allows a user to indicated a venue is incorrect in some way.
       #
       # @param id [String] The venue id for which an edit is being proposed.
@@ -148,6 +168,18 @@ module Skittles
         get("venues/#{id}").venue
       end
       
+      # Returns URLs or identifier from third parties that have been applied to this
+      # venue.
+      #
+      # @note This is an experimental API.
+      # @param id [String] The venue you want annotations for.
+      # @return [Hashie::Mash] A count and items of links.
+      # @requires_acting_user No
+      # @see https://developer.foursquare.com/docs/venues/links.html
+      def venue_links(id)
+        get("venues/#{id}/links").links
+      end
+      
       # Allows a user to mark a venue to-do, with optional text.
       #
       # @param id The venue you want to mark to-do.
@@ -175,6 +207,10 @@ module Skittles
 			# @option options [String] query A search term to be applied against titles.
 			# @option options [Integer] limit Number of results to return, up to 50.
 			# @option options [String] intent Indicates your intent in performing the search.
+			# @option options [String] categoryId A category to limit the results to. (experimental)
+			# @option options [String] url A third-party URL which is attempted to match against a map of venues to URLs. (experimental)
+			# @option options [String] providerId Identifier for a known third party that is part of a map of venues to URLs, used in conjunction with linkedId. (experimental)
+			# @option options [Integer] linkedId Identifier used by third party specified in providerId, which will be attempted to match against a map of venues to URLs. (experimental)
 			# @return [Hashie::Mash] An array of objects representing groups of venues.
 			# @requires_acting_user No
 			# @see http://developer.foursquare.com/docs/venues/search.html 

data/lib/skittles/request.rb

@@ -36,6 +36,10 @@ module Skittles
 		  		:client_secret => client_secret
 		  	})
 		  	
+		  	options.merge!({
+		  	  :v => Time.now.strftime('%Y%m%d')
+		  	})
+		  	
 		  	begin
 		  	  response = connection.request(method, paramify(path, options), headers)
 		  	rescue OAuth2::ErrorWithResponse => e

data/lib/skittles/version.rb

@@ -1,3 +1,3 @@
 module Skittles
-	VERSION = '0.3.1'
+	VERSION = '0.4.0'
 end

metadata

@@ -2,7 +2,7 @@
 name: skittles
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors: 
 - Anthony Smith
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-12 00:00:00 -05:00
+date: 2011-06-23 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -20,7 +20,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 0.1.1
+        version: 0.4.1
   type: :runtime
   prerelease: false
   version_requirements: *id001
@@ -64,7 +64,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 1.0.10
+        version: 1.0.15
   type: :development
   prerelease: false
   version_requirements: *id005
@@ -75,7 +75,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 1.5.2
+        version: 1.6.2
   type: :development
   prerelease: false
   version_requirements: *id006
@@ -97,7 +97,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 0.6.4
+        version: 0.7.2
   type: :development
   prerelease: false
   version_requirements: *id008
@@ -129,8 +129,6 @@ files:
 - lib/skittles/version.rb
 - LICENSE.txt
 - README.rdoc
-- spec/skittles_spec.rb
-- spec/spec_helper.rb
 has_rdoc: true
 homepage: http://github.com/anthonator/skittles
 licenses: 
@@ -145,7 +143,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 4092488723339903251
+      hash: -3536193774362662556
       segments: 
       - 0
       version: "0"
@@ -162,6 +160,5 @@ rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Foursquare v2 REST API client library for Ruby
-test_files: 
-- spec/skittles_spec.rb
-- spec/spec_helper.rb
+test_files: []
+

data/spec/skittles_spec.rb

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

data/spec/spec_helper.rb

@@ -1,12 +0,0 @@
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-require 'rspec'
-require 'skittles'
-
-# 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