fitbit_api 0.16.0 → 0.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84c71b886a0267daec62f3be7c7a4f1b8da73a893cb766b3a0a246089f5bded0
-  data.tar.gz: f662e151b49f846953dd278676c0bb70d5f473b33ce5727df2a496311f09fcf7
+  metadata.gz: 69af80fbdb9af28b9eb94f8eb53627586f4a37fd5761dc761e60487f275be752
+  data.tar.gz: 22cff0c61fb2679040f643f09b5a62200d17bc94a7e64b9b00fe57c7e05f9b05
 SHA512:
-  metadata.gz: '03948d366e08835c27d58c128c654c46c8a11ad8eb306de10a8584aae78d0e6c885e9a6ee3e4d4a3a1a60bb45dafe1b807c57649c3dc9eb58af85381845323c3'
-  data.tar.gz: 6b39da3d88cd2f0440196a9ce52466950892bf25af5e5ecb60a5f9438c0a14d14b48f10cf4b792151b4d23da1e52086ac7767b9a6ad82b7c00ea3cabf1858aa0
+  metadata.gz: bbf0efb4eda29415684a74c762782306325364b5ed582c8d457d2d6c1c7c8bea3e3d7df76b5818ac088e5e6202bf78ea39567fa8c4e6b100b14874c1d22d08c9
+  data.tar.gz: d29e794b7af47d27d1a0cc818ab20a70959106d4cb5d534c6f82d9638a4328ce25f091159ae741cd292829164a6b9a42bc7ff9864e1caee5068f4f7dd072d41f

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+0.17.1
+------
+- Some internal cleanup
+
+0.17.0
+------
+- Add ECG endpoint support
+- Add Active Zone Minutes endpoint support
+
 0.16.0
 ------
 - Add Sleep Log by Date Range endpoint support

data/README.md

@@ -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 | `"1"` |
 | `unit_system`        | The measurement unit system to use for response values | `"en_US"` |
 | `locale`             | The locale to use for response values | `"en_US"` |
-| `scope`              | A list of permissions being requested (array or space-delimited string) | `%w[activity nutrition profile settings sleep social weight heartrate respiratory_rate oxygen_saturation cardio_fitness temperature]` |
+| `scope`              | A list of permissions being requested (array or space-delimited string) | `%w[activity nutrition profile settings sleep social weight heartrate respiratory_rate oxygen_saturation cardio_fitness temperature electrocardiogram]` |
 | `snake_case_keys`    | Transform response payload's keys to snake case format | `false` |
 | `symbolize_keys`     | Transform response payload's keys to symbols | `false` |
 | `auto_refresh_token` | Automatically refreshes the access token once expired | `true` |

data/lib/fitbit_api/active_zone_minutes.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module FitbitAPI
+  class Client
+    # Returns the daily summary Active Zone Minutes (AZM) values over a specified date range or period.
+    #
+    #   active_zone_minutes_time_series(start_date: Date.parse('2021-04-16'), period: '7d')
+    #   active_zone_minutes_time_series(start_date: Date.parse('2021-05-18'), end_date: Date.parse('2021-05-24'))
+    #
+    # @param opts [Hash] The request parameters
+    #
+    # @option opts :start_date [Date] The start of the date range
+    # @option opts :end_date [Date] The end of the date range
+    # @option opts :period [String] The range for which data will be returned
+
+    def active_zone_minutes_time_series(opts = {})
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date] || Date.today
+      period     = opts[:period]
+
+      raise FitbitAPI::InvalidArgumentError, 'A start_date or period is required.' if [period, start_date].none?
+
+      if period && !PERIODS.include?(period)
+        raise FitbitAPI::InvalidArgumentError,
+              "Invalid period: \"#{period}\". Please provide one of the following: #{PERIODS}."
+      end
+
+      result = if period
+                 get("user/#{user_id}/activities/active-zone-minutes/date/#{format_date(end_date)}/#{period}.json")
+               else
+                 get(
+                   "user/#{user_id}/activities/active-zone-minutes/date/" \
+                   "#{format_date(start_date)}/#{format_date(end_date)}.json"
+                 )
+               end
+
+      strip_root_key(result)
+    end
+
+    # Retrieves the Active Zone Minutes (AZM) intraday time series data for a specific date or 24 hour period.
+    #
+    # @param opts [Hash] The request parameters
+    #
+    # @option opts :date [Date] The date for which to retrieve the data
+    # @option opts :detail_level [String] Number of data poins to include
+    # @option opts :start_time [String] The time in the format HH:mm
+    # @option opts :end_time [String] The time in the format HH:mm
+
+    def active_zone_minutes_intraday_time_series(opts = {})
+      date         = opts[:date] || Date.today
+      detail_level = opts[:detail_level]
+      start_time   = opts[:start_time]
+      end_time     = opts[:end_time]
+
+      if [date, detail_level].any?(&:nil?)
+        raise FitbitAPI::InvalidArgumentError, 'A date and detail_level are required.'
+      end
+
+      detail_levels = %(1min 5min 15min)
+
+      unless detail_levels.include? detail_level
+        raise FitbitAPI::InvalidArgumentError,
+              "Invalid detail_level: \"#{detail_level}\". Please provide one of the following: #{detail_levels}."
+      end
+
+      if (start_time || end_time) && !(start_time && end_time)
+        raise FitbitAPI::InvalidArgumentError, 'Both start_time and end_time are required if time is being specified.'
+      end
+
+      path = "user/#{user_id}/activities/active-zone-minutes/date/#{format_date(date)}/1d/#{detail_level}"
+      path += "/time/#{format_time(start_time)}/#{format_time(end_time)}" if start_time && end_time
+
+      get("#{path}.json")
+    end
+  end
+end

data/lib/fitbit_api/base.rb

@@ -19,7 +19,7 @@ module FitbitAPI
   define_setting :locale,          'en_US'
   define_setting :scope,           %w[activity nutrition profile settings sleep social weight
                                       heartrate respiratory_rate oxygen_saturation cardio_fitness
-                                      temperature]
+                                      temperature electrocardiogram]
 
   define_setting :api_version,     '1'
 

data/lib/fitbit_api/client.rb

@@ -1,9 +1,11 @@
 # frozen_string_literal: true
 
 require 'fitbit_api/base'
+require 'fitbit_api/active_zone_minutes'
 require 'fitbit_api/activities'
 require 'fitbit_api/breathing_rate'
 require 'fitbit_api/cardio_score'
+require 'fitbit_api/electrocardiogram'
 require 'fitbit_api/heart_rate'
 require 'fitbit_api/heart_rate_variability'
 require 'fitbit_api/goals'

data/lib/fitbit_api/electrocardiogram.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module FitbitAPI
+  class Client
+    # This endpoint retrieves a list of the user's Electrocardiogram
+    # (ECG) log entries before or after a given day.
+    #
+    #   ecg_logs_list(before_date: Date.parse('2021-05-24'), limit: 5)
+    #
+    # @param params [Hash] The request parameters
+    #
+    # @option params :before_date [Date] Specify when filtering entries that occured before the given date
+    # @option params :after_date [Date] Specify when filtering entries that occured after the given date
+    # @option params :sort [String] the Sort order of entries by date (asc or desc)
+    # @option params :offset [Integer] The offset number of entries. Must always be 0
+    # @option params :limit [Integer] The max of the number of entries returned (max: 10)
+
+    def ecg_logs_list(params = {})
+      default_params = { before_date: Date.today, after_date: nil, sort: 'desc', limit: 10, offset: 0 }
+      get("user/#{user_id}/ecg/list.json", default_params.merge(params))
+    end
+  end
+end

data/lib/fitbit_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FitbitAPI
-  VERSION = '0.16.0'
+  VERSION = '0.17.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fitbit_api
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.1
 platform: ruby
 authors:
 - Zoran
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-19 00:00:00.000000000 Z
+date: 2023-12-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth2
@@ -90,6 +90,7 @@ files:
 - LICENSE.txt
 - README.md
 - lib/fitbit_api.rb
+- lib/fitbit_api/active_zone_minutes.rb
 - lib/fitbit_api/activities.rb
 - lib/fitbit_api/alarms.rb
 - lib/fitbit_api/base.rb
@@ -98,6 +99,7 @@ files:
 - lib/fitbit_api/cardio_score.rb
 - lib/fitbit_api/client.rb
 - lib/fitbit_api/devices.rb
+- lib/fitbit_api/electrocardiogram.rb
 - lib/fitbit_api/food.rb
 - lib/fitbit_api/friends.rb
 - lib/fitbit_api/goals.rb
@@ -119,8 +121,8 @@ licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/zokioki/fitbit_api
-  changelog_uri: https://github.com/zokioki/fitbit_api/blob/v0.16.0/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/fitbit_api/0.16.0
+  changelog_uri: https://github.com/zokioki/fitbit_api/blob/v0.17.1/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/fitbit_api/0.17.1
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []