fitgem 0.2.2 → 0.3.0

data/README.md

@@ -64,29 +64,33 @@ The docs are very fuzzy on subscription support at the moment; we definitely pla
 
 There is a good looking gem called [ruby-fitbit](https://github.com/danmayer/ruby-fitbit "ruby-fitbit") that
 also aims to collect data from the site.  It was created before they released their REST API and uses screen-scraping to gather the data rather than through their API.  I looked into forking it and refactoring
-to use the new API but after looking through the code I felt it would be more of a total rewrite and so decided 
+to use the new API but after looking through the code I felt it would be more of a total rewrite and so decided
 to create a new gem that I could design from scratch.
 
 ## Why the Name Change? ##
 
 It turns out that Fitbit.com does not want people to create libraries or applications that incorporate the name 'fitbit'.  So, on May 12th I changed the name of the project/gem from 'fitbit' to 'fitgem'.
 
-
 # Changelog #
 
+* 12 July, 2011:
+  * Added friends support (get friends, friend leaderboard, create invites, accept/reject invites)
+  * Added water support (get water data per date)
+  * Added sleep support (get sleep data per date)
+  * Added ability to update user profile information
 * 12 May, 2011:
 	* Changed name and all references of this project from 'fitbit' to 'fitgem'
 * 11 April, 2011:
   * Fixed an issue where blank user id's are used and an error is thrown.
   * Added support for creating/removing subscriptions (this support is experimental for now, more tests coming)
-* 24 March, 2011: 
+* 24 March, 2011:
   * Added logging of activities and foods
   * Added ability to add favorite activities and foods
   * Added ability to delete logged activities and foods, and remove favorite activities and foods
   * Refactored data_by_time_range for more testability
   * Added ability to query devices
-* 19 March, 2011: 
-  * Updated auth client to support first-time auth and reconnections (if you have previously been authorized and received token/secret). 
+* 19 March, 2011:
+  * Updated auth client to support first-time auth and reconnections (if you have previously been authorized and received token/secret).
   * Added 'named' retrieval of activities and foods (recent_, favorite_, frequent_)
   * Added ability to log weight back to the site using the API
 * 18 March, 2001: First revision. Supports the auth process via oauth, and retrieval of user info and activities.
@@ -98,7 +102,7 @@ To be clear: __I am not employed by fitbit.com__.  I created this library to ass
 # Contributing to fitgem #
 
 The Fitbit REST API is in BETA right now, and so it will quite likely change over time (though I can't be sure whether it will be additive change or change of the non-backwards-compatible variety).  I aim to keep as up-to-date as I can but if you absolutely need functionality that isn't included here, feel free to fork and implement it, then send me a pull request.
- 
+
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
 * Fork the project

data/lib/fitgem.rb

@@ -4,5 +4,5 @@ require 'oauth'
 require 'fitgem/client'
 
 module Fitgem
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 end

data/lib/fitgem/client.rb

@@ -2,8 +2,11 @@ require 'fitgem/helpers'
 require 'fitgem/errors'
 require 'fitgem/users'
 require 'fitgem/activities'
+require 'fitgem/sleep'
+require 'fitgem/water'
 require 'fitgem/units'
 require 'fitgem/foods'
+require 'fitgem/friends'
 require 'fitgem/body_measurements'
 require 'fitgem/time_range'
 require 'fitgem/devices'

data/lib/fitgem/friends.rb

@@ -0,0 +1,51 @@
+module Fitgem
+  class Client
+
+    # ==========================================
+    #          Friend Retrieval Methods
+    # ==========================================
+    def friends
+      get("/user/#{@user_id}/friends.json")
+    end
+
+    def weekly_leaderboard
+      leaderboard('7d')
+    end
+
+    def monthly_leaderboard
+      leaderboard('30d')
+    end
+
+    # ==========================================
+    #       Invitation Management Methods
+    # ==========================================
+    def invite_friend(options)
+      unless options[:email] || options[:user_id]
+        raise InvalidArgumentError.new "add_friend hash argument must include :email or :user_id"
+      end
+      translated_options = {}
+      translated_options[:invitedUserEmail] = options[:email] if options[:email]
+      translated_options[:invitedUserId] = options[:user_id] if options[:user_id]
+      post("/user/#{@user_id}/friends/invitations.json", translated_options)
+    end
+
+    def accept_invite(requestor_id)
+      respond_to_invite(requestor_id, true)
+    end
+
+    def decline_invite(requestor_id)
+      respond_to_invite(requestor_id, false)
+    end
+
+    private
+
+    def leaderboard(range)
+      get("/user/#{@user_id}/friends/leaderboard/#{range}.json")
+    end
+
+    def respond_to_invite(requestor_id, does_accept)
+      options = { :accept => does_accept.to_s }
+      post("/user/#{@user_id}/friends/invitations/#{requestor_id}.json", options)
+    end
+  end
+end

data/lib/fitgem/sleep.rb

@@ -0,0 +1,12 @@
+module Fitgem
+  class Client
+
+    # ==========================================
+    #          Sleep Retrieval Methods
+    # ==========================================
+    def sleep_on_date(date)
+      get("/user/#{@user_id}/sleep/date/#{format_date(date)}.json")
+    end
+
+  end
+end

data/lib/fitgem/users.rb

@@ -1,9 +1,19 @@
 module Fitgem
   class Client
-    
-    def user_info(options = {})    
+
+    def user_info(options = {})
       get("/user/#{@user_id}/profile.json")
     end
-    
+
+    # options[:gender] optional Gender; (MALE/FEMALE/NA)
+    # options[:birthday] optional Date of Birth; in the format yyyy-MM-dd
+    # options[:height] optional Height
+    # options[:nickname] optional Nickname
+    # options[:fullName] optional Full name
+    # options[:timezone] optional Timezone; in the format "America/Los_Angeles"
+    def update_user_info(options)
+      post("/user/#{@user_id}/profile.json", options)
+    end
+
   end
 end

data/lib/fitgem/water.rb

@@ -0,0 +1,12 @@
+module Fitgem
+  class Client
+
+    # ==========================================
+    #          Water Retrieval Methods
+    # ==========================================
+    def water_on_date(date)
+      get("/user/#{@user_id}/foods/log/water/date/#{format_date(date)}.json")
+    end
+
+  end
+end

metadata

@@ -2,7 +2,7 @@
 name: fitgem
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors: 
 - Zachery Moneypenny
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-01 00:00:00 -05:00
+date: 2011-07-12 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -104,11 +104,14 @@ files:
 - lib/fitgem/devices.rb
 - lib/fitgem/errors.rb
 - lib/fitgem/foods.rb
+- lib/fitgem/friends.rb
 - lib/fitgem/helpers.rb
 - lib/fitgem/notifications.rb
+- lib/fitgem/sleep.rb
 - lib/fitgem/time_range.rb
 - lib/fitgem/units.rb
 - lib/fitgem/users.rb
+- lib/fitgem/water.rb
 - spec/fitgem_spec.rb
 - spec/spec_helper.rb
 has_rdoc: true