fitgem 0.5.1 → 0.5.2

data/.gitignore

@@ -5,3 +5,4 @@ pkg/*
 .yardoc/*
 test*.rb
 *.dmp
+.fitgem.yml

data/changelog.md

@@ -3,12 +3,42 @@
 
 # fitgem changelog
 
-## v0.4.0 
+## v0.5.2
+
+#### 2012-03-04 Zachery Moneypenny <fitgem@whazzmaster.com>
+
+* Added new <tt>symbolize_keys</tt> helper method for turning the string-key based return hashes into symbol-key based ones
+* Added new <tt>label_for_measurement</tt> helper method to get the correct unit measurement label given a measurement type and the current user's ApiUnitSystem setting
+* Added specs
+* Added new <tt>connected?</tt> method on Fitgem::Client that will report whether API calls may be made
+* Added <tt>InvalidUnitSystem</tt> error and <tt>InvalidMeasurementType</tt> error
+* Fixed a small issue where date values were not being formatted correctly in calls to <tt>log_body_measurements</tt>
+
+## v0.5.1
+
+#### 2012-01-24 Zachery Moneypenny <fitgem@whazzmaster.com>
+
+* Fix for creating and removing data subscriptions
+* Updated specs
+
+## v0.5.0
+
+#### 2012-01-22 Zachery Moneypenny <fitgem@whazzmaster.com>
+
+* Added view/log/delete access for blood pressure data
+* Added view/log/delete access for glucose data
+* Added view/log/delete access for heart rate data
+* Added updated time series documentation for new endpoints
+* Updated temporal information in the readme
+* Added unit tests for <tt>format_time</tt> method
+* Updated copyright date
+
+## v0.4.0
 
 #### 2011-11-29 Zachery Moneypenny <fitgem@whazzmaster.com>
 
 * Added YARD documentation to thoroughly document code
-* DEPRECATED: <tt>Fitgem::Client#log_weight</tt> method, use <tt>Fitgem::Client#log_body_measurements</tt> instead.  
+* DEPRECATED: <tt>Fitgem::Client#log_weight</tt> method, use <tt>Fitgem::Client#log_body_measurements</tt> instead.
   The new method allows you to log more than weight (bicep size, body fat %, etc.)
 * Added <tt>Fitgem::FoodFormType</tt> to be used in calls to <tt>Fitgem::Client#create_food</tt>
 * Added <tt>Fitgem::Client#log_sleep</tt> to log sleep data to fitbit

data/lib/fitgem/body_measurements.rb

@@ -25,7 +25,7 @@ module Fitgem
     #   an integer or a string in "X.XX'" format
     # @param [DateTime, String] date The date the weight should be
     #   logged, as either a DateTime or a String in "yyyy-MM-dd" format
-    # @return [Hash] 
+    # @return [Hash]
     #
     # @deprecated {#log_body_measurements} should be used instead of
     #   log_weight
@@ -35,7 +35,7 @@ module Fitgem
 
     # Log body measurements to fitbit for the current user
     #
-    # At least ONE measurement item is REQUIRED in the call, as well as the 
+    # At least ONE measurement item is REQUIRED in the call, as well as the
     # date. All measurement values to be logged for the user must be either an
     # Integer, a Decimal value, or a String in "X.XX" format. The
     # measurement units used for the supplied measurements are based on
@@ -54,13 +54,15 @@ module Fitgem
     # @option opts [Integer, Decimal, String] :bicep Bicep measurement
     # @option opts [DateTime, Date, String] :date Date to log measurements
     #   for; provided either as a DateTime, Date, or a String in
-    #   "yyyy-MM-dd" format 
+    #   "yyyy-MM-dd" format
     #
     # @return [Hash] Hash containing the key +:body+ with an inner hash
     #   of all of the logged measurements
     #
     # @since v0.4.0
     def log_body_measurements(opts)
+      # Update the date (if exists)
+      opts[:date] = format_date(opts[:date]) if opts[:date]
       post("/user/#{@user_id}/body.json", opts)
     end
   end

data/lib/fitgem/client.rb

@@ -150,6 +150,13 @@ module Fitgem
       access_token
     end
 
+    # Get the current state of the client
+    #
+    # @return True if api calls may be made, false if not
+    def connected?
+      !@access_token.nil?
+    end
+
     # Get an oauth request token
     #
     # @param [Hash] opts Request token request data; can be used to

data/lib/fitgem/errors.rb

@@ -13,4 +13,13 @@ module Fitgem
 
   class InvalidTimeRange < InvalidArgumentError
   end
+
+  class InvalidUnitSystem < InvalidArgumentError
+  end
+
+  class InvalidMeasurementType < InvalidArgumentError
+  end
+
+  class ConnectionRequiredError < Exception
+  end
 end

data/lib/fitgem/helpers.rb

@@ -63,5 +63,122 @@ module Fitgem
         raise Fitgem::InvalidTimeArgument, "Date used must be a valid time object or a string in the format HH:mm; supplied argument is a #{time.class}"
       end
     end
+
+    # Fetch the correct label for the desired measurement unit.
+    #
+    # The general use case for this method is that you are using the client for
+    # a specific user, and wish to get the correct labels for the unit measurements
+    # returned for that user.
+    #
+    # A secondary use case is that you wish to get the label for a measurement given a unit
+    # system that you supply (by setting the Fitgem::Client.api_unit_system attribute).
+    #
+    # In order for this method to get the correct value for the current user's preferences,
+    # the client must have the ability to make API calls.  If you respect_user_unit_preferences
+    # is passed as 'true' (or left as the default value) and the client cannot make API calls
+    # then an error will be raised by the method.
+    #
+    # @param [Symbol] measurement_type The measurement type to fetch the label for
+    # @param [Boolean] respect_user_unit_preferences Should the method fetch the current user's
+    #   specific measurement preferences and use those (true), or use the value set on Fitgem::Client.api_unit_system (false)
+    # @raise [Fitgem::ConnectionRequiredError] Raised when respect_user_unit_preferences is true but the
+    #   client is not capable of making API calls.
+    # @raise [Fitgem::InvalidUnitSystem] Raised when the current value of Fitgem::Client.api_unit_system
+    #   is not one of [ApiUnitSystem.US, ApiUnitSystem.UK, ApiUnitSystem.METRIC]
+    # @raise [Fitgem::InvalidMeasurementType] Raised when the supplied measurement_type is not one of
+    #   [:duration, :distance, :elevation, :height, :weight, :measurements, :liquids, :blood_glucose]
+    # @return [String] The string label corresponding to the measurement type and
+    #   current api_unit_system.
+    def label_for_measurement(measurement_type, respect_user_unit_preferences=true)
+      unless [:duration, :distance, :elevation, :height, :weight, :measurements, :liquids, :blood_glucose].include?(measurement_type)
+        raise InvalidMeasurementType, "Supplied measurement_type parameter must be one of [:duration, :distance, :elevation, :height, :weight, :measurements, :liquids, :blood_glucose], current value is :#{measurement_type}"
+      end
+
+      selected_unit_system = api_unit_system
+
+      if respect_user_unit_preferences
+        unless connected?
+          raise ConnectionRequiredError, "No connection to Fitbit API; one is required when passing respect_user_unit_preferences=true"
+        end
+        # Cache the unit systems for the current user
+        @unit_systems ||= self.user_info['user'].select {|key, value| key =~ /Unit$/ }
+
+        case measurement_type
+          when :distance
+            selected_unit_system = @unit_systems["distanceUnit"]
+          when :height
+            selected_unit_system = @unit_systems["heightUnit"]
+          when :liquids
+            selected_unit_system = @unit_systems["waterUnit"]
+          when :weight
+            selected_unit_system = @unit_systems["weightUnit"]
+          when :blood_glucose
+            selected_unit_system = @unit_systems["glucoseUnit"]
+          else
+            selected_unit_system = api_unit_system
+        end
+      end
+
+      # Fix the METRIC system difference
+      selected_unit_system = Fitgem::ApiUnitSystem.METRIC if selected_unit_system == "METRIC"
+
+      # Ensure the target unit system is one that we know about
+      unless [ApiUnitSystem.US, ApiUnitSystem.UK, ApiUnitSystem.METRIC].include?(selected_unit_system)
+        raise InvalidUnitSystem, "The select unit system must be one of [ApiUnitSystem.US, ApiUnitSystem.UK, ApiUnitSystem.METRIC], current value is #{selected_unit_system}"
+      end
+
+      unit_mappings[selected_unit_system][measurement_type]
+    end
+
+    # Recursively turns arrays and hashes into symbol-key based
+    # structures.
+    #
+    # @param [Array, Hash] The structure to symbolize keys for
+    # @return A new structure with the keys symbolized
+    def self.symbolize_keys(obj)
+      case obj
+      when Array
+        obj.inject([]){|res, val|
+          res << case val
+          when Hash, Array
+            symbolize_keys(val)
+          else
+            val
+          end
+          res
+        }
+      when Hash
+        obj.inject({}){|res, (key, val)|
+          nkey = case key
+          when String
+            key.to_sym
+          else
+            key
+          end
+          nval = case val
+          when Hash, Array
+            symbolize_keys(val)
+          else
+            val
+          end
+          res[nkey] = nval
+          res
+        }
+      else
+        obj
+      end
+    end
+
+    protected
+
+    # Defined mappings for unit measurements to labels
+    def unit_mappings
+      {
+        ApiUnitSystem.US => { :duration => "milliseconds", :distance => "miles", :elevation => "feet", :height => "inches", :weight => "pounds", :measurements => "inches", :liquids => "fl oz", :blood_glucose => "mg/dL" },
+        ApiUnitSystem.UK => { :duration => "milliseconds", :distance => "kilometers", :elevation => "meters", :height => "centimeters", :weight => "stone", :measurements => "centimeters", :liquids => "mL", :blood_glucose => "mmol/l" },
+        ApiUnitSystem.METRIC => { :duration => "milliseconds", :distance => "kilometers", :elevation => "meters", :height => "centimeters", :weight => "kilograms", :measurements => "centimeters", :liquids => "mL", :blood_glucose => "mmol/l" }
+      }
+    end
+
   end
 end

data/lib/fitgem/version.rb

@@ -1,3 +1,3 @@
 module Fitgem
-  VERSION = "0.5.1"
+  VERSION = "0.5.2"
 end

data/spec/fitgem_helper_spec.rb

@@ -124,4 +124,87 @@ describe Fitgem::Client do
       }.to raise_error Fitgem::InvalidTimeArgument
     end
   end
+
+  describe "#label_for_measurement" do
+    it "accepts the supported Fitgem::ApiUnitSystem values" do
+      @client.api_unit_system = Fitgem::ApiUnitSystem.US
+      @client.label_for_measurement :duration, false
+      @client.api_unit_system = Fitgem::ApiUnitSystem.UK
+      @client.label_for_measurement :duration, false
+      @client.api_unit_system = Fitgem::ApiUnitSystem.METRIC
+      @client.label_for_measurement :duration, false
+    end
+
+    it "raises an InvalidUnitSystem error if the Fitgem::Client.api_unit_system value is invalid" do
+      expect {
+        @client.api_unit_system = "something else entirely"
+        @client.label_for_measurement :duration, false
+      }.to raise_error Fitgem::InvalidUnitSystem
+    end
+
+    it "accepts the supported values for the measurement_type parameter" do
+      @client.label_for_measurement :duration, false
+      @client.label_for_measurement :distance, false
+      @client.label_for_measurement :elevation, false
+      @client.label_for_measurement :height, false
+      @client.label_for_measurement :weight, false
+      @client.label_for_measurement :measurements, false
+      @client.label_for_measurement :liquids, false
+      @client.label_for_measurement :blood_glucose, false
+    end
+
+    it "raises an InvalidMeasurementType error if the measurement_type parameter is invalid" do
+      expect {
+        @client.label_for_measurement :homina, false
+      }.to raise_error Fitgem::InvalidMeasurementType
+    end
+
+    it "returns the correct values when the unit system is Fitgem::ApiUnitSystem.US" do
+      @client.api_unit_system = Fitgem::ApiUnitSystem.US
+      @client.label_for_measurement(:duration, false).should == "milliseconds"
+      @client.label_for_measurement(:distance, false).should == "miles"
+      @client.label_for_measurement(:elevation, false).should == "feet"
+      @client.label_for_measurement(:height, false).should == "inches"
+      @client.label_for_measurement(:weight, false).should == "pounds"
+      @client.label_for_measurement(:measurements, false).should == "inches"
+      @client.label_for_measurement(:liquids, false).should == "fl oz"
+      @client.label_for_measurement(:blood_glucose, false).should == "mg/dL"
+    end
+
+    it "returns the correct values when the unit system is Fitgem::ApiUnitSystem.UK" do
+      @client.api_unit_system = Fitgem::ApiUnitSystem.UK
+      @client.label_for_measurement(:duration, false).should == "milliseconds"
+      @client.label_for_measurement(:distance, false).should == "kilometers"
+      @client.label_for_measurement(:elevation, false).should == "meters"
+      @client.label_for_measurement(:height, false).should == "centimeters"
+      @client.label_for_measurement(:weight, false).should == "stone"
+      @client.label_for_measurement(:measurements, false).should == "centimeters"
+      @client.label_for_measurement(:liquids, false).should == "mL"
+      @client.label_for_measurement(:blood_glucose, false).should == "mmol/l"
+    end
+
+    it "returns the correct values when the unit system is Fitgem::ApiUnitSystem.METRIC" do
+      @client.api_unit_system = Fitgem::ApiUnitSystem.METRIC
+      @client.label_for_measurement(:duration, false).should == "milliseconds"
+      @client.label_for_measurement(:distance, false).should == "kilometers"
+      @client.label_for_measurement(:elevation, false).should == "meters"
+      @client.label_for_measurement(:height, false).should == "centimeters"
+      @client.label_for_measurement(:weight, false).should == "kilograms"
+      @client.label_for_measurement(:measurements, false).should == "centimeters"
+      @client.label_for_measurement(:liquids, false).should == "mL"
+      @client.label_for_measurement(:blood_glucose, false).should == "mmol/l"
+    end
+
+    context "when respecting the user's unit measurement preferences" do
+      before(:each) do
+        @client.stub(:connected?).and_return(true)
+        @client.stub(:user_info).and_return({"user" => {"distanceUnit"=>"en_GB", "glucoseUnit"=>"en_GB", "heightUnit"=>"en_GB", "waterUnit"=>"METRIC", "weightUnit"=>"en_GB"}})
+      end
+
+      it "returns the correct overridden measurement label" do
+        @client.api_unit_system = Fitgem::ApiUnitSystem.US
+        @client.label_for_measurement(:distance).should == "kilometers"
+      end
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fitgem
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.5.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-24 00:00:00.000000000 Z
+date: 2012-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth
-  requirement: &70336813924980 !ruby/object:Gem::Requirement
+  requirement: &70237035564320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70336813924980
+  version_requirements: *70237035564320
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70336813924560 !ruby/object:Gem::Requirement
+  requirement: &70237035563860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70336813924560
+  version_requirements: *70237035563860
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70336813960400 !ruby/object:Gem::Requirement
+  requirement: &70237035563440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70336813960400
+  version_requirements: *70237035563440
 - !ruby/object:Gem::Dependency
   name: guard
-  requirement: &70336813959180 !ruby/object:Gem::Requirement
+  requirement: &70237035624880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70336813959180
+  version_requirements: *70237035624880
 - !ruby/object:Gem::Dependency
   name: guard-rspec
-  requirement: &70336813957720 !ruby/object:Gem::Requirement
+  requirement: &70237035623600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70336813957720
+  version_requirements: *70237035623600
 - !ruby/object:Gem::Dependency
   name: rb-fsevent
-  requirement: &70336813956900 !ruby/object:Gem::Requirement
+  requirement: &70237035622140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70336813956900
+  version_requirements: *70237035622140
 - !ruby/object:Gem::Dependency
   name: growl
-  requirement: &70336813956040 !ruby/object:Gem::Requirement
+  requirement: &70237035621320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +87,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70336813956040
+  version_requirements: *70237035621320
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70336813954640 !ruby/object:Gem::Requirement
+  requirement: &70237035620560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,10 +98,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70336813954640
+  version_requirements: *70237035620560
 - !ruby/object:Gem::Dependency
   name: rdiscount
-  requirement: &70336813953360 !ruby/object:Gem::Requirement
+  requirement: &70237035618860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -109,7 +109,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70336813953360
+  version_requirements: *70237035618860
 description: A client library to send and retrieve workout, weight, and diet data
   from fitbit.com
 email:
@@ -168,7 +168,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4091779949925866203
+      hash: 4572625795194822459
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -177,7 +177,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4091779949925866203
+      hash: 4572625795194822459
 requirements: []
 rubyforge_project: fitgem
 rubygems_version: 1.8.10