skittles 0.4.0 → 0.5.0

data/lib/skittles/client/special.rb

@@ -3,9 +3,23 @@ module Skittles
     # Define methods related to specials.
     # @see http://developer.foursquare.com/docs/specials/specials.html
     module Special
+      # Allows users to indicate a special is improper in some way.
+      #
+      # @params special_id [String] The id of the special being flagged.
+      # @param venue_id [String] The id of the venue running the special.
+      # @param problem [String] One of not_redeemable, not_valuable, other.
+      # @param options [Hash] A customizable set of options.
+      # @option options [String] text Additional text about why the user has flagged this special.
+      # @require_acting_user Yes
+      # @see https://developer.foursquare.com/docs/specials/flag.html
+      def flag_special(special_id, venue_id, problem, options = {})
+        post("specials/#{special_id}/flag", { :venueId => venue_id, :problem => problem }.merge(options))
+        nil
+      end
+      
       # Gives details about a special, including text and unlock rules.
       #
-      # @param id [String] Id of special to retrieve.
+      # @param special_id [String] Id of special to retrieve.
       # @return [Hashie::Mash] A complete special.
       # @requires_acting_user No
       # @see http://developer.foursquare.com/docs/specials/specials.html

data/lib/skittles/client/user.rb

@@ -1,3 +1,5 @@
+require 'mime/types'
+
 module Skittles
   class Client
     # Define methods related to users.
@@ -81,6 +83,7 @@ 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.
@@ -91,6 +94,16 @@ module Skittles
         get('users/leaderboard').leaderboard
       end
       
+      # Returns a user's mayorships
+      #
+      # @params user [String] Identity of the user to get mayorships for. Pass self to get friends of the acting user.
+      # @return [Hashie::Mash] A count and items of objects which currently only contain compact venue objects.
+      # @requires_acting_user Yes
+      # @see https://developer.foursquare.com/docs/users/mayorships.html
+      def mayorships(user = 'self')
+        get("users/#{user}/mayorships").mayorships
+      end
+      
       # Changes whether the acting user will receive pings (phone
       # notifications) when the specified user checks in. 
       #
@@ -116,6 +129,36 @@ module Skittles
         get("users/#{id}/todos", { :sort => sort }.merge(options)).todos
       end
       
+      # Updates the user's profile photo.
+      #
+      # @param photo [String] Photo under 100KB in multipark MIME encoding with content type image/jpeg, image/gif, or image/png. 
+      # @return [Hashie::Mash] The current user object
+      # @requires_acting_user Yes
+      # @see https://developer.foursquare.com/docs/users/update.html
+      def update_user_photo(photo)
+        mime_type = MIME::Types.type_for(photo)[0]
+        params = {
+          :photo => UploadIO.new(photo, mime_type.to_s, "image.#{mime_type.extensions[0]}"),
+          :oauth_token => access_token
+        }
+        uri = URI.parse("#{endpoint}/users/self/update")
+        File.open(photo) do
+          req = Net::HTTP::Post::Multipart.new(uri.path, params)
+          http = Net::HTTP.new(uri.host, uri.port)
+          http.use_ssl = true if uri.scheme == 'https'
+          resp = http.start do |net|
+            net.request(req)
+          end
+          
+          case resp.code.to_i
+          when 200..299
+            return Skittles::Utils.parse_json(resp.body).response.user
+          when 400..599
+            Skittles::Utils.handle_foursquare_error(resp)
+          end
+        end
+      end
+      
       # Returns profile information for a given user, including selected badges
       # and mayorships.
       #

data/lib/skittles/client/venue.rb

@@ -215,7 +215,7 @@ module Skittles
 			# @requires_acting_user No
 			# @see http://developer.foursquare.com/docs/venues/search.html 
 			def venue_search(ll, options = {})
-			  get('venues/search', { :ll => ll }.merge(options)).groups
+			  get('venues/search', { :ll => ll }.merge(options)).venues
 			end
 			
 			# Returns tips for a venue.
@@ -233,4 +233,4 @@ module Skittles
       end
 		end
 	end
-end
+end

data/lib/skittles/version.rb

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

metadata

@@ -1,116 +1,124 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: skittles
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 0.5.0
   prerelease: 
-  version: 0.4.0
 platform: ruby
-authors: 
+authors:
 - Anthony Smith
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-06-23 00:00:00 -04:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2011-07-29 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: oauth2
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &70223019913040 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
+      - !ruby/object:Gem::Version
         version: 0.4.1
   type: :runtime
   prerelease: false
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70223019913040
+- !ruby/object:Gem::Dependency
   name: yajl-ruby
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  requirement: &70223019912560 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
+      - !ruby/object:Gem::Version
         version: 0.8.1
   type: :runtime
   prerelease: false
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70223019912560
+- !ruby/object:Gem::Dependency
   name: hashie
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  requirement: &70223019912080 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
+      - !ruby/object:Gem::Version
         version: 1.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70223019912080
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: &70223019911600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70223019911600
+- !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  requirement: &70223019911120 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
+      - !ruby/object:Gem::Version
         version: 2.5.0
   type: :development
   prerelease: false
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70223019911120
+- !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  requirement: &70223019910640 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
+      - !ruby/object:Gem::Version
         version: 1.0.15
   type: :development
   prerelease: false
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70223019910640
+- !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &id006 !ruby/object:Gem::Requirement 
+  requirement: &70223019910160 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: 1.6.2
+      - !ruby/object:Gem::Version
+        version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *id006
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70223019910160
+- !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &id007 !ruby/object:Gem::Requirement 
+  requirement: &70223019909680 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id007
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70223019909680
+- !ruby/object:Gem::Dependency
   name: yard
-  requirement: &id008 !ruby/object:Gem::Requirement 
+  requirement: &70223019909200 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
+      - !ruby/object:Gem::Version
         version: 0.7.2
   type: :development
   prerelease: false
-  version_requirements: *id008
-description: Foursquare v2 REST API client library for Ruby
+  version_requirements: *70223019909200
+description: A Ruby implementation of the Foursquare v2 REST API. This library implements
+  the Foursquare v2 API and the Foursquare Venues Project (beta) endpoints.
 email: anthony@sticksnleaves.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE.txt
 - README.rdoc
-files: 
+files:
 - lib/skittles.rb
 - lib/skittles/api.rb
 - lib/skittles/client.rb
@@ -129,36 +137,32 @@ files:
 - lib/skittles/version.rb
 - LICENSE.txt
 - README.rdoc
-has_rdoc: true
 homepage: http://github.com/anthonator/skittles
-licenses: 
+licenses:
 - MIT
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: -3536193774362662556
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: 3746734199987061722
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
 summary: Foursquare v2 REST API client library for Ruby
 test_files: []
-