foursquare2 1.9.8 → 2.0.0

data/VERSION

@@ -1 +1 @@
-1.9.8
+2.0.0

data/foursquare2.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "foursquare2"
-  s.version = "1.9.8"
+  s.version = "2.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Matt Mueller", "Marco Moura"]
-  s.date = "2013-11-09"
+  s.date = "2014-05-28"
   s.description = "Gives access to all endpoints in version 2 of foursquare's API with syntax that will be familiar to those who used the original foursquare gem by Jeremy Welch."
   s.email = ["muellermr@gmail.com", "email@marcomoura.com"]
   s.extra_rdoc_files = [

data/lib/foursquare2/campaigns.rb

@@ -4,12 +4,14 @@ module Foursquare2
     # Retrieve information about a campaign
     #
     # param [String] campaign_id The ID of the venue
-    def campaign(campaign_id)
-      response = connection.get("campaigns/#{campaign_id}")
+    def campaign(campaign_id, options={})
+      response = connection.get do |req|
+        req.url "campaigns/#{campaign_id}", options
+      end
       return_error_or_body(response, response.body.response.campaign)
     end
-    
-    # Add a campaign 
+
+    # Add a campaign
     # Details on param options can be found at https://developer.foursquare.com/docs/campaigns/add
     #
     # @param [Hash]  options
@@ -18,7 +20,7 @@ module Foursquare2
     # @option options String :venueId - comma-separated list of venue IDs (either groupId or venueId is required)
     # @option options Integer :endAt - DateTime when the campaign is to be automatically deactivated (seconds since epoch)
     # @option options Integer :startAt - DateTime when the campaign is to be started (seconds since epoch)
-    # @option options String :campaignId - ID of an existing campaign to copy. 
+    # @option options String :campaignId - ID of an existing campaign to copy.
     #
 
     def add_campaign(options={})
@@ -52,12 +54,12 @@ module Foursquare2
     #
     #
 
-    def end_campaign(campaign_id)
+    def end_campaign(campaign_id, options={})
       response = connection.post do |req|
-        req.url "campaigns/#{campaign_id}/end"
+        req.url "campaigns/#{campaign_id}/end", options
       end
         return_error_or_body(response, response.body.code)
     end
-    
+
   end
 end

data/lib/foursquare2/events.rb

@@ -5,15 +5,19 @@ module Foursquare2
     #
     # param [String] event_id The ID of the event
 
-    def event(event_id)
-      response = connection.get("events/#{event_id}")
+    def event(event_id, options={})
+      response = connection.get do |req|
+        req.url "events/#{event_id}", options
+      end
       return_error_or_body(response, response.body.response.event)
     end
 
     # Retrieve information about all event categories.
 
-    def event_categories
-      response = connection.get("events/categories")
+    def event_categories(options={})
+      response = connection.get do |req|
+        req.url "events/categories", options
+      end
       return_error_or_body(response, response.body.response.categories)
     end
 

data/lib/foursquare2/lists.rb

@@ -34,8 +34,10 @@ module Foursquare2
     #
     # @param [String] list_id - The id of the list to follow.
 
-    def follow_list(list_id)
-      response = connection.post "lists/#{list_id}/follow"
+    def follow_list(list_id, options={})
+      response = connection.post do |req|
+        req.url "lists/#{list_id}/follow", options
+      end
       return_error_or_body(response, response.body.response.list)
     end
 
@@ -43,8 +45,10 @@ module Foursquare2
     #
     # @param [String] list_id - The id of the list to unfollow.
 
-    def unfollow_list(list_id)
-      response = connection.post "lists/#{list_id}/unfollow"
+    def unfollow_list(list_id, options={})
+      response = connection.post do |req|
+        req.url "lists/#{list_id}/unfollow", options
+      end
       return_error_or_body(response, response.body.response.list)
     end
 
@@ -87,9 +91,9 @@ module Foursquare2
     # @param [String] list_id - The id of the list to delete item from
     # @param [String] item_id = The id of the item to delete from list
 
-    def delete_list_item(list_id, item_id)
+    def delete_list_item(list_id, item_id, options={})
       response = connection.post do |req|
-        req.url "lists/#{list_id}/deleteitem", :itemId => item_id
+        req.url "lists/#{list_id}/deleteitem", {:itemId => item_id}.merge(options)
       end
       return_error_or_body(response, response.body.response.item)
     end

data/lib/foursquare2/pages.rb

@@ -6,8 +6,10 @@ module Foursquare2
     # /!\ A page is considered by Foursquare as a user.
     # @param [Integer] user_id - Page to get information for.
 
-    def page(user_id)
-      response = connection.get("pages/#{user_id}")
+    def page(user_id, options={})
+      response = connection.get do |req|
+        req.url "pages/#{user_id}", options
+      end
       return_error_or_body(response, response.body.response.user)
     end
 
@@ -35,9 +37,9 @@ module Foursquare2
     # @option options Integer :offset - For paging through results
     # @option options String :ll - Latitude and longitude in format LAT,LON - Limit results to venues near this latitude and longitude. NOT VALID with NE or SW (see after).
     # @option String :radius - Can be used when including ll. Limit results to venues within this many meters of the specified ll. Not valid with ne or sw.
-    # @option String :sw - With ne, limits results to the bounding quadrangle defined by the latitude and longitude given by sw as its south-west corner, and ne as its north-east corner. Not valid with ll or radius. 
+    # @option String :sw - With ne, limits results to the bounding quadrangle defined by the latitude and longitude given by sw as its south-west corner, and ne as its north-east corner. Not valid with ll or radius.
     # @option String :ne - See sw
-    
+
     def page_venues(page_id, options={})
       response = connection.get do |req|
         req.url "pages/#{page_id}/venues", options

data/lib/foursquare2/photos.rb

@@ -5,10 +5,12 @@ module Foursquare2
     #
     # @params [String] photo_id - The ID of the photo
 
-    def photo(photo_id)
-      response = connection.get("photos/#{photo_id}")
+    def photo(photo_id, options={})
+      response = connection.get do |req|
+        req.url "photos/#{photo_id}", options
+      end
       return_error_or_body(response, response.body.response.photo)
-    end    
+    end
 
     # Add a photo
     #
@@ -26,7 +28,7 @@ module Foursquare2
       response = connection.post('photos/add', options)
       return_error_or_body(response, response.body.response.photo)
     end
-    
+
     # Retrieve photos for a venue
     #
     # @params [String] venue_id - The ID of the venue
@@ -40,7 +42,7 @@ module Foursquare2
       end
       return_error_or_body(response, response.body.response.photos)
     end
-    
+
   end
 end
 

data/lib/foursquare2/settings.rb

@@ -3,17 +3,21 @@ module Foursquare2
 
     # Retrive all settings for the authenticated user.
 
-    def settings
-      response = connection.get("settings/all")
+    def settings(options={})
+      response = connection.get do |req|
+        req.url "settings/all", options
+      end
       return_error_or_body(response, response.body.response.settings)
-    end    
+    end
 
     # Retrieve a single setting for the authenticated user.
     #
     # @param [String] setting - The name of the setting to retrieve, one of sendtotwitter, sendtofacebook, pings.
 
-    def setting(setting)
-      response = connection.get("settings/setting")
+    def setting(setting, options={})
+      response = connection.get do |req|
+        req.url "settings/setting", options
+      end
       return_error_or_body(response, response.body.response)
     end
 
@@ -22,13 +26,13 @@ module Foursquare2
     # @param [String] setting - The name of the setting to update, one of sendtotwitter, sendtofacebook, pings.
     # @param [String] value - One of '1','0'
 
-    def update_setting(setting,value)
+    def update_setting(setting, value, options={})
       response = connection.post do |req|
-        req.url "settings/#{setting}/set", {:value => value}
+        req.url "settings/#{setting}/set", {:value => value}.merge(options)
       end
       return_error_or_body(response, response.body.response)
     end
-    
+
   end
 end
 

data/lib/foursquare2/specials.rb

@@ -5,10 +5,12 @@ module Foursquare2
     #
     # param [String] special_id The ID of the special
 
-    def special(special_id)
-      response = connection.get("specials/#{special_id}")
+    def special(special_id, options={})
+      response = connection.get do |req|
+        req.url "specials/#{special_id}", options
+      end
       return_error_or_body(response, response.body.response.special)
-    end    
+    end
 
     # Search for specials
     #
@@ -25,7 +27,7 @@ module Foursquare2
       end
       return_error_or_body(response, response.body.response.specials.items)
     end
-    
+
     # Add a special for venue managers
     # Details on param options can be found at https://developer.foursquare.com/docs/specials/add
     #
@@ -33,10 +35,10 @@ module Foursquare2
     # @option options String :name - A name for the special.
     # @option options String :text - Required
     # @option options String :unlockedText - Required. Special text that is shown when the user has unlocked the special.
-    # @option options String :finePrint 
-    # @option options Integer :count1 
-    # @option options Integer :count2 
-    # @option options Integer :count3 
+    # @option options String :finePrint
+    # @option options Integer :count1
+    # @option options Integer :count2
+    # @option options Integer :count3
     # @option options String :type - Required.
     # @option options String :offerId
     # @option options Float :cost
@@ -48,7 +50,7 @@ module Foursquare2
       end
         return_error_or_body(response, response.body.response.special)
     end
-    
+
   end
 end
 

data/lib/foursquare2/tips.rb

@@ -5,10 +5,12 @@ module Foursquare2
     #
     # param [String] tip_id - The id of the tip to retrieve.
 
-    def tip(tip_id)
-      response = connection.get("tips/#{tip_id}")
+    def tip(tip_id, options={})
+      response = connection.get do |req|
+        req.url "tips/#{tip_id}", options
+      end
       return_error_or_body(response, response.body.response.tip)
-    end    
+    end
 
     # Search for tips.
     #
@@ -63,9 +65,9 @@ module Foursquare2
     #
     # param [String] tip_id - The id of the tip to mark.
 
-    def mark_tip_todo(tip_id)
+    def mark_tip_todo(tip_id, options={})
       response = connection.post do |req|
-        req.url "tips/#{tip_id}/marktodo"
+        req.url "tips/#{tip_id}/marktodo", options
       end
       return_error_or_body(response, response.body.response)
     end
@@ -74,9 +76,9 @@ module Foursquare2
     #
     # param [String] tip_id - The id of the tip to mark.
 
-    def mark_tip_done(tip_id)
+    def mark_tip_done(tip_id, options={})
       response = connection.post do |req|
-        req.url "tips/#{tip_id}/markdone"
+        req.url "tips/#{tip_id}/markdone", options
       end
       return_error_or_body(response, response.body.response)
     end
@@ -85,9 +87,9 @@ module Foursquare2
     #
     # param [String] tip_id - The id of the tip to unmark.
 
-    def unmark_tip(tip_id)
+    def unmark_tip(tip_id, options={})
       response = connection.post do |req|
-        req.url "tips/#{tip_id}/unmark"
+        req.url "tips/#{tip_id}/unmark", options
       end
       return_error_or_body(response, response.body.response)
     end

data/lib/foursquare2/users.rb

@@ -17,8 +17,10 @@ module Foursquare2
     #
     # @param [Integer] user_id - User to get information for.
 
-    def user(user_id)
-      response = connection.get("users/#{user_id}")
+    def user(user_id, options={})
+      response = connection.get do |req|
+        req.url "users/#{user_id}", options
+      end
       return_error_or_body(response, response.body.response.user)
     end
 
@@ -65,8 +67,10 @@ module Foursquare2
     end
     # Get all pending friend requests for the authenticated user
 
-    def user_requests
-      response = connection.get("users/requests")
+    def user_requests(options={})
+      response = connection.get do |req|
+        req.url "users/requests", options
+      end
       return_error_or_body(response, response.body.response.requests)
     end
 
@@ -74,8 +78,10 @@ module Foursquare2
     #
     # @param [String] user_id - The user to retrieve badges for.
 
-    def user_badges(user_id)
-      response = connection.get("users/#{user_id}/badges")
+    def user_badges(user_id, options={})
+      response = connection.get do |req|
+        req.url "users/#{user_id}/badges", options
+      end
       return_error_or_body(response, response.body.response)
     end
 
@@ -174,9 +180,9 @@ module Foursquare2
     #
     # @param [String] user_id - The user to retrieve friends for.
 
-    def user_mayorships(user_id)
+    def user_mayorships(user_id, options={})
       response = connection.get do |req|
-      req.url "users/#{user_id}/mayorships"
+        req.url "users/#{user_id}/mayorships", options
       end
       return_error_or_body(response, response.body.response.mayorships)
     end
@@ -199,9 +205,9 @@ module Foursquare2
     #
     # @param [String] user_id - The user to request friendship with.
 
-    def user_friend_request(user_id)
+    def user_friend_request(user_id, options={})
       response = connection.post do |req|
-        req.url "users/#{user_id}/request"
+        req.url "users/#{user_id}/request", options
       end
       return_error_or_body(response, response.body.response)
     end
@@ -210,9 +216,9 @@ module Foursquare2
     #
     # @param [String] user_id - The user to unfriend.
 
-    def user_unfriend(user_id)
+    def user_unfriend(user_id, options={})
       response = connection.post do |req|
-        req.url "users/#{user_id}/unfriend"
+        req.url "users/#{user_id}/unfriend", options
       end
       return_error_or_body(response, response.body.response)
     end
@@ -221,9 +227,9 @@ module Foursquare2
     #
     # @param [String] user_id - The user to approve friendship with.
 
-    def user_approve_friend(user_id)
+    def user_approve_friend(user_id, options={})
       response = connection.post do |req|
-        req.url "users/#{user_id}/approve"
+        req.url "users/#{user_id}/approve", options
       end
       return_error_or_body(response, response.body.response)
     end
@@ -232,9 +238,9 @@ module Foursquare2
     #
     # @param [String] user_id - The user to deny friendship with.
 
-    def user_deny_friend(user_id)
+    def user_deny_friend(user_id, options={})
       response = connection.post do |req|
-        req.url "users/#{user_id}/deny"
+        req.url "users/#{user_id}/deny", options
       end
       return_error_or_body(response, response.body.response)
     end

data/lib/foursquare2/venuegroups.rb

@@ -5,18 +5,20 @@ module Foursquare2
     #
     # param [String] group_id The ID of the venuegroup
 
-    def venuegroup(group_id)
-      response = connection.get("venuegroups/#{group_id}")
+    def venuegroup(group_id, options={})
+      response = connection.get do |req|
+        req.url "venuegroups/#{group_id}", options
+      end
       return_error_or_body(response, response.body.response.venueGroup)
     end
 
-    # Create a venue group. If the venueId parameter is specified, 
-    # then the endpoint will add the specified venues to the venue group. 
-    # If it is not possible to add all of the specified venues to the group, 
+    # Create a venue group. If the venueId parameter is specified,
+    # then the endpoint will add the specified venues to the venue group.
+    # If it is not possible to add all of the specified venues to the group,
     # then creation of the venue group will fail entirely.
     # @param [Hash]  options
     # @option options String :name - Required. The name to give the group.
-    # @option options String :venueId - Comma-delimited list of venue IDs to add to the group. If this parameter is not specified, then the venue group will initially be empty.  
+    # @option options String :venueId - Comma-delimited list of venue IDs to add to the group. If this parameter is not specified, then the venue group will initially be empty.
 
     def add_venuegroup(options={})
       response = connection.post do |req|
@@ -41,9 +43,9 @@ module Foursquare2
 
     # List all venue groups owned by the user.
 
-    def list_venuegroup
+    def list_venuegroup(options={})
       response = connection.get do |req|
-        req.url "venuegroups/list"
+        req.url "venuegroups/list", options
       end
       return_error_or_body(response, response.body.response.venueGroups)
     end
@@ -51,9 +53,9 @@ module Foursquare2
     # Delete a venue group.
     # param [String] group_id - The ID of the venuegroup to delete.
 
-    def delete_venuegroup(group_id)
+    def delete_venuegroup(group_id, options={})
       response = connection.post do |req|
-        req.url "venuegroups/#{group_id}/delete"
+        req.url "venuegroups/#{group_id}/delete", options
       end
       return_error_or_body(response, response.body.response)
     end

data/lib/foursquare2/venues.rb

@@ -5,8 +5,10 @@ module Foursquare2
     #
     # param [String] venue_id The ID of the venue
 
-    def venue(venue_id)
-      response = connection.get("venues/#{venue_id}")
+    def venue(venue_id, options={})
+      response = connection.get do |req|
+        req.url "venues/#{venue_id}", options
+      end
       return_error_or_body(response, response.body.response.venue)
     end
 
@@ -27,7 +29,7 @@ module Foursquare2
       end
       return_error_or_body(response, response.body.response)
     end
-    
+
     # Search for trending venues
     #
     # @param [String] :ll Latitude and longitude in format LAT,LON
@@ -36,7 +38,7 @@ module Foursquare2
     # @option options Integer :radius - Radius in meters, up to approximately 2000 meters.
 
     def trending_venues(ll, options={})
-      options[:ll] = ll    
+      options[:ll] = ll
       response = connection.get do |req|
         req.url "venues/trending", options
       end
@@ -63,8 +65,10 @@ module Foursquare2
 
     # Retrieve information about all venue categories.
 
-    def venue_categories
-      response = connection.get("venues/categories")
+    def venue_categories(options={})
+      response = connection.get do |req|
+        req.url "venues/categories", options
+      end
       return_error_or_body(response, response.body.response.categories)
     end
 
@@ -72,8 +76,10 @@ module Foursquare2
     #
     # param [String] venue_id The ID of the venue
 
-    def venue_links(venue_id)
-      response = connection.get("venues/#{venue_id}/links")
+    def venue_links(venue_id, options={})
+      response = connection.get do |req|
+        req.url "venues/#{venue_id}/links", options
+      end
       return_error_or_body(response, response.body.response.links)
     end
 
@@ -209,8 +215,10 @@ module Foursquare2
     #
     # param [String] venue_id The ID of the venue
 
-    def venue_menus(venue_id)
-      response = connection.get("venues/#{venue_id}/menu")
+    def venue_menus(venue_id, options={})
+      response = connection.get do |req|
+        req.url "venues/#{venue_id}/menu", options
+      end
       return_error_or_body(response, response.body.response)
     end
 
@@ -233,9 +241,9 @@ module Foursquare2
     #Returns a list of venues managed
     #
 
-    def managed_venues()
+    def managed_venues(options={})
       response = connection.get do |req|
-        req.url "venues/managed"
+        req.url "venues/managed", options
       end
       return_error_or_body(response, response.body.response.venues)
     end
@@ -276,8 +284,10 @@ module Foursquare2
     #
     # param [String] venue_id The ID of the venue
 
-    def venue_hours(venue_id)
-      response = connection.get("venues/#{venue_id}/hours")
+    def venue_hours(venue_id, options={})
+      response = connection.get do |req|
+        req.url "venues/#{venue_id}/hours", options
+      end
       return_error_or_body(response, response.body.response)
     end
 
@@ -285,8 +295,10 @@ module Foursquare2
     #
     # param [String] venue_id The ID of the venue
 
-    def venue_events(venue_id)
-      response = connection.get("venues/#{venue_id}/events")
+    def venue_events(venue_id, options={})
+      response = connection.get do |req|
+        req.url "venues/#{venue_id}/events", options
+      end
       return_error_or_body(response, response.body.response)
     end
 
@@ -294,8 +306,10 @@ module Foursquare2
     #
     # param [String] venue_id The ID of the venue to get likes for
 
-    def venue_likes(venue_id)
-      response = connection.get("venues/#{venue_id}/likes")
+    def venue_likes(venue_id, options={})
+      response = connection.get do |req|
+        req.url "venues/#{venue_id}/likes", options
+      end
       return_error_or_body(response, response.body.response)
     end
 
@@ -317,8 +331,10 @@ module Foursquare2
     #
     # param [String] venue_id Required. ID of the venue you want to see next venue information about
 
-    def venue_nextvenues(venue_id)
-      response = connection.get("venues/#{venue_id}/nextvenues")
+    def venue_nextvenues(venue_id, options={})
+      response = connection.get do |req|
+        req.url "venues/#{venue_id}/nextvenues", options
+      end
       return_error_or_body(response, response.body.response)
     end
 
@@ -326,8 +342,10 @@ module Foursquare2
     #
     # param [String] venue_id The venue you want similar venues for.
 
-    def venue_similar(venue_id)
-      response = connection.get("venues/#{venue_id}/similar")
+    def venue_similar(venue_id, options={})
+      response = connection.get do |req|
+        req.url "venues/#{venue_id}/similar", options
+      end
       return_error_or_body(response, response.body.response)
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foursquare2
 version: !ruby/object:Gem::Version
-  version: 1.9.8
+  version: 2.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-09 00:00:00.000000000 Z
+date: 2014-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -339,7 +339,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1220568585856823028
+      hash: -1615806452877883596
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: