fitbit_api 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '03139ae4b7cbf7a8243f05b155cd4795c4dd2d3f02b86adadc27cebed83be9d8'
-  data.tar.gz: 9d2396e266cfa26e8e869e492c74d37605065eecb743ee5e8a64d59a1a13c8bb
+  metadata.gz: 32eab4ca789fa776fe5d1ddacf58dd51f43d01d12c049b2b4c5080c5969f902d
+  data.tar.gz: 4f83878440ed7f152f5a5eb3d101447972847c578adaf05b704d201565513189
 SHA512:
-  metadata.gz: 65750c1625faf8f7118120f8db01e1a80438baa496cce74c10aa6bc920692899595ad91973ecea3a1e63ffbb7d5b454f7f40f6433d2b1f08fdae40df4b4580ec
-  data.tar.gz: 95db8df54a789b5ab0a1fdfa1a8906d7d8d4818d9af4fe33f41fcd5a156bd3fd90006bd927c233cee67f0714eeabbd41d5162a6b7171f2ef40d03b73774cf9e8
+  metadata.gz: de894373c47758b4c7530ce3a4559a8284f3c2e2390f3925841015bced821a2c9370657199c527ac9a5416a597019c3bcf1d3a8dcb135fc0bda875aae4baea77
+  data.tar.gz: 3c03846f5f25e1117a88acbfb09e78903ec425deb663e7371154cbc3e57b8a70d43f17c5171bf41ee9c19a584fa932ad009a2171c1a2458637f01893c7b7e013

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+0.14.0
+------
+- Add support for the following endpoints:
+  - Breathing Rate
+  - Oxygen Saturation (SpO2)
+  - Cardio Score (VO2 Max)
+  - Heart Rate Variability
+  - Temperature (Core & Skin)
+
 0.13.0
 ------
 - Add support for token revocation via `revoke_token!`.

data/README.md

@@ -1,7 +1,7 @@
 # FitbitAPI
 
-[![Gem Version](https://badge.fury.io/rb/fitbit_api.svg)](https://badge.fury.io/rb/fitbit_api)
-[![Test Workflow](https://github.com/zokioki/fitbit_api/actions/workflows/test.yml/badge.svg)](https://github.com/zokioki/fitbit_api/actions/workflows/test.yml)
+[![Gem Version](https://img.shields.io/gem/v/fitbit_api)](https://rubygems.org/gems/fitbit_api)
+[![Test Workflow](https://img.shields.io/github/workflow/status/zokioki/fitbit_api/Test)](https://github.com/zokioki/fitbit_api/actions/workflows/test.yml)
 
 FitbitAPI provides a Ruby interface to the [Fitbit Web API](https://dev.fitbit.com/reference/web-api).
 
@@ -100,7 +100,7 @@ When initializing a `FitbitAPI::Client` instance, you're given access to a handf
 | api_version        | API version to be used when making requests (default: "1") |
 | unit_system        | The measurement unit system to use for response values (default: "en_US") |
 | locale             | The locale to use for response values (default: "en_US") |
-| scope              | A space-delimited list of permissions being requested (default: "activity nutrition profile settings sleep social weight heartrate") |
+| scope              | A space-delimited list of permissions being requested (default: "activity nutrition profile settings sleep social weight heartrate respiratory_rate oxygen_saturation cardio_fitness temperature") |
 | snake_case_keys    | Transform response payload's keys to snake case format (default: false) |
 | symbolize_keys     | Transform response payload's keys to symbols (default: false) |
 | auto_refresh_token | Automatically refreshes the access token once expired (default: true) |

data/lib/fitbit_api/base.rb

@@ -15,7 +15,7 @@ module FitbitAPI
 
   define_setting :unit_system,     'en_US'
   define_setting :locale,          'en_US'
-  define_setting :scope,           'activity nutrition profile settings sleep social weight heartrate'
+  define_setting :scope,           'activity nutrition profile settings sleep social weight heartrate respiratory_rate oxygen_saturation cardio_fitness temperature'
 
   define_setting :api_version,     '1'
 

data/lib/fitbit_api/breathing_rate.rb

@@ -0,0 +1,49 @@
+module FitbitAPI
+  class Client
+    def breathing_rate_summary(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        result = get("user/#{user_id}/br/date/#{format_date(start_date)}/#{format_date(end_date)}.json")
+      else
+        result = get("user/#{user_id}/br/date/#{format_date(date)}.json")
+      end
+
+      # remove root key from response
+      result.values[0]
+    end
+
+    def breathing_rate_intraday(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        result = get("user/#{user_id}/br/date/#{format_date(start_date)}/#{format_date(end_date)}/all.json")
+      else
+        result = get("user/#{user_id}/br/date/#{format_date(date)}/all.json")
+      end
+
+      # remove root key from response
+      result.values[0]
+    end
+  end
+end

data/lib/fitbit_api/cardio_score.rb

@@ -0,0 +1,26 @@
+module FitbitAPI
+  class Client
+    def cardio_score_summary(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        result = get("user/#{user_id}/cardioscore/date/#{format_date(start_date)}/#{format_date(end_date)}.json")
+      else
+        result = get("user/#{user_id}/cardioscore/date/#{format_date(date)}.json")
+      end
+
+      # remove root key from response
+      result.values[0]
+    end
+  end
+end

data/lib/fitbit_api/client.rb

@@ -1,6 +1,9 @@
 require 'fitbit_api/base'
 require 'fitbit_api/activities'
+require 'fitbit_api/breathing_rate'
+require 'fitbit_api/cardio_score'
 require 'fitbit_api/heart_rate'
+require 'fitbit_api/heart_rate_variability'
 require 'fitbit_api/goals'
 require 'fitbit_api/alarms'
 require 'fitbit_api/body'
@@ -8,8 +11,10 @@ require 'fitbit_api/devices'
 require 'fitbit_api/food'
 require 'fitbit_api/friends'
 require 'fitbit_api/meals'
+require 'fitbit_api/oxygen_saturation'
 require 'fitbit_api/sleep'
 require 'fitbit_api/subscriptions'
+require 'fitbit_api/temperature'
 require 'fitbit_api/user'
 require 'fitbit_api/water'
 

data/lib/fitbit_api/heart_rate_variability.rb

@@ -0,0 +1,49 @@
+module FitbitAPI
+  class Client
+    def heart_rate_variability_summary(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        result = get("user/#{user_id}/hrv/date/#{format_date(start_date)}/#{format_date(end_date)}.json")
+      else
+        result = get("user/#{user_id}/hrv/date/#{format_date(date)}.json")
+      end
+
+      # remove root key from response
+      result.values[0]
+    end
+
+    def heart_rate_variability_intraday(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        result = get("user/#{user_id}/hrv/date/#{format_date(start_date)}/#{format_date(end_date)}/all.json")
+      else
+        result = get("user/#{user_id}/hrv/date/#{format_date(date)}/all.json")
+      end
+
+      # remove root key from response
+      result.values[0]
+    end
+  end
+end

data/lib/fitbit_api/oxygen_saturation.rb

@@ -0,0 +1,43 @@
+module FitbitAPI
+  class Client
+    def oxygen_saturation_summary(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        get("user/#{user_id}/spo2/date/#{format_date(start_date)}/#{format_date(end_date)}.json")
+      else
+        get("user/#{user_id}/spo2/date/#{format_date(date)}.json")
+      end
+    end
+
+    def oxygen_saturation_intraday(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        get("user/#{user_id}/spo2/date/#{format_date(start_date)}/#{format_date(end_date)}/all.json")
+      else
+        get("user/#{user_id}/spo2/date/#{format_date(date)}/all.json")
+      end
+    end
+  end
+end

data/lib/fitbit_api/temperature.rb

@@ -0,0 +1,49 @@
+module FitbitAPI
+  class Client
+    def core_temperature_summary(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        result = get("user/#{user_id}/temp/core/date/#{format_date(start_date)}/#{format_date(end_date)}.json")
+      else
+        result = get("user/#{user_id}/temp/core/date/#{format_date(date)}.json")
+      end
+
+      # remove root key from response
+      result.values[0]
+    end
+
+    def skin_temperature_summary(opts={})
+      date       = opts[:date] || Date.today
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date]
+
+      if start_date && !end_date
+        end_date = Date.today
+      end
+
+      unless date || start_date
+        raise FitbitAPI::InvalidArgumentError, 'A date or start_date and end_date are required.'
+      end
+
+      if start_date
+        result = get("user/#{user_id}/temp/skin/date/#{format_date(start_date)}/#{format_date(end_date)}.json")
+      else
+        result = get("user/#{user_id}/temp/skin/date/#{format_date(date)}.json")
+      end
+
+      # remove root key from response
+      result.values[0]
+    end
+  end
+end

data/lib/fitbit_api/version.rb

@@ -1,3 +1,3 @@
 module FitbitAPI
-  VERSION = '0.13.0'
+  VERSION = '0.14.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fitbit_api
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Zoran
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-31 00:00:00.000000000 Z
+date: 2022-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth2
@@ -100,18 +100,23 @@ files:
 - lib/fitbit_api/alarms.rb
 - lib/fitbit_api/base.rb
 - lib/fitbit_api/body.rb
+- lib/fitbit_api/breathing_rate.rb
+- lib/fitbit_api/cardio_score.rb
 - lib/fitbit_api/client.rb
 - lib/fitbit_api/devices.rb
 - lib/fitbit_api/food.rb
 - lib/fitbit_api/friends.rb
 - lib/fitbit_api/goals.rb
 - lib/fitbit_api/heart_rate.rb
+- lib/fitbit_api/heart_rate_variability.rb
 - lib/fitbit_api/helpers/configuration.rb
 - lib/fitbit_api/helpers/exceptions.rb
 - lib/fitbit_api/helpers/utils.rb
 - lib/fitbit_api/meals.rb
+- lib/fitbit_api/oxygen_saturation.rb
 - lib/fitbit_api/sleep.rb
 - lib/fitbit_api/subscriptions.rb
+- lib/fitbit_api/temperature.rb
 - lib/fitbit_api/user.rb
 - lib/fitbit_api/version.rb
 - lib/fitbit_api/water.rb