fitbit_api 0.11.0 → 0.12.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0199cc0ea15375afa47467c885ccf179c73955116fb9edf4a8f21bdfc4087867'
-  data.tar.gz: a394ad4302abe48783bc0bec9217a4132e5939cd067fc922d4e571cac7ea527e
+  metadata.gz: 78cae3c27a67636b099e84c993d65ca42e2039dd3caba794df413baf947dc7eb
+  data.tar.gz: 8cd276fc40a20b3592c54e7b4e53f86b450ce8b6f57160151080f9bf8586b557
 SHA512:
-  metadata.gz: 112c2fa3669262d9e86b09a356147ba6665f768b16a7fc096beb1a36de39350c2c79c5258b850fbe0027bab8a78bf5de2c237d79311406f3c537fd0d82a8f83d
-  data.tar.gz: fc9c32427092a0f4f3ccafe15c2a53c486bf7d0e67810bb957d384bb1a83bcc899615bbcf63d9ad881fa30ddbdc1bd7b1cc555ac4246c5c9c5f89bb074cfe9d6
+  metadata.gz: f197a5a6e3e8bd08c3d435b44fde8953716f9a1a589d6ea46ae469bb875b77ee39b1f0a289d1e66cd5f2bd055051e5f7dad73f468c628ab9a5ce4f41be7b0758
+  data.tar.gz: 062e014f64ab3780554c2e8f705bcee89a9c74ce3d2119371230207849fb991d777197722641f55cb9983186aa0a97960218eb7413e766fd9ff41e07557226ab

data/.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: Test
+
+on:
+  - push
+  - pull_request
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version:
+          - 2.6
+          - 2.7
+          - 3.0
+          - 3.1
+
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rake

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+0.12.2
+------
+- Fix docs formatting
+
+0.12.1
+------
+- Some docs improvements
+
+0.12.0
+------
+- Expand endpont support for foods (searching foods, creating custom foods, updating/deleting logs).
+- Expand endpoint support for water logging (create, update, delete water logs).
+- Expand endpoint support for sleep (list sleep logs, create/delete sleep logs).
+- Expand endpoint support for goals (food, sleep, water goals).
+- Add endpoint support for meals.
+- Allow `get`, `post`, and `delete` methods to accept blocks.
+- Switch to Github Actions for CI.
+- Rename a few methods for better accuracy/clarity:
+  - daily_goals -> daily_activity_goals
+  - weekly_goals -> weekly_activity_goals
+  - create_or_update_daily_goals -> update_daily_activity_goals
+  - create_or_update_weekly_goals -> update_weekly_activity_goals
+
 0.11.0
 ------
 - Add support for subscriptions endpoints.

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)
-[![Build Status](https://travis-ci.org/zokioki/fitbit_api.svg?branch=master)](https://travis-ci.org/zokioki/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)
 
 FitbitAPI provides a Ruby interface to the [Fitbit Web API](https://dev.fitbit.com/reference/web-api).
 

data/fitbit_api.gemspec

@@ -21,8 +21,8 @@ Gem::Specification.new do |spec|
 
   spec.add_runtime_dependency     'oauth2', '~> 1.0'
 
-  spec.add_development_dependency 'byebug'
+  spec.add_development_dependency 'byebug', '~> 11.0'
   spec.add_development_dependency 'bundler', '~> 2.3'
-  spec.add_development_dependency 'rake', '>= 12.3.3'
-  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.11'
 end

data/lib/fitbit_api/activities.rb

@@ -11,12 +11,7 @@ module FitbitAPI
 
     ACTIVITY_INTRADAY_RESOURCES = %w(calories steps distance floors elevation)
 
-    # GET Activities
-    # ==============
-
-    # Retrieves a summary and list of a user's activities and activity log entries
-    # for a given day in the format requested using units in the unit system which
-    # corresponds to the Accept-Language header provided.
+    # Retrieves a summary and list of a user's activities and activity log entries for a given day.
     #
     # @param date [Date] The date for which to retrieve the activity data.
 
@@ -24,13 +19,15 @@ module FitbitAPI
       get("user/#{user_id}/activities/date/#{format_date(date)}.json")
     end
 
-    # Retrieves a list of a user's frequent activities in the format requested using
-    # units in the unit system which corresponds to the Accept-Language header provided.
+    # Retrieves a list of a user's frequent activities.
 
     def frequent_activities
       get("user/#{user_id}/activities/frequent.json")
     end
 
+    # Retrieves a list of a user's recent activities types logged with some details
+    # of the last activity log of that type.
+
     def recent_activities
       get("user/#{user_id}/activities/recent.json")
     end
@@ -54,11 +51,13 @@ module FitbitAPI
     #
     #   activity_logs_list(before_date: Date.parse('2021-05-24'), limit: 5)
     #
-    # @param before_date [Date] Specify when filtering entries that occured before the given date
-    # @param after_date [Date] Specify when filtering entries that occured after the given date
-    # @param sort [String] the Sort order of entries by date (asc or desc)
-    # @param offset [Integer] The offset number of entries. Must always be 0
-    # @param limit [Integer] The max of the number of entries returned (max: 20)
+    # @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: 20)
 
     def activity_logs_list(params={})
       default_params = { before_date: Date.today, after_date: nil, sort: 'desc', limit: 20, offset: 0 }
@@ -133,28 +132,27 @@ module FitbitAPI
       end
 
       if (start_time && end_time)
-        get("user/-/activities/#{resource}/date/#{format_date(date)}/1d/#{detail_level}/time/#{format_time(start_time)}/#{format_time(end_time)}.json")
+        get("user/#{user_id}/activities/#{resource}/date/#{format_date(date)}/1d/#{detail_level}/time/#{format_time(start_time)}/#{format_time(end_time)}.json")
       else
-        get("user/-/activities/#{resource}/date/#{format_date(date)}/1d/#{detail_level}.json")
+        get("user/#{user_id}/activities/#{resource}/date/#{format_date(date)}/1d/#{detail_level}.json")
       end
     end
 
-    # POST Activities
-    # ===============
-
     # Creates log entry for an activity or user's private custom activity using units
     # in the unit system which corresponds to the Accept-Language header provided.
     #
     #   log_activity(activity_id: 90013, manual_calories: 300, duration_millis: 6000000)
     #
-    # @param activity_id [Integer, String] The activity ID
-    # @param activity_name [String] Custom activity name. Either activity ID or activity_name must be provided
-    # @param manual_calories [Integer] Calories burned, specified manually. Required with activity_name, otherwise optional
-    # @param start_time [String] Activity start time; formatted in HH:mm:ss
-    # @param duration_millis [Integer] Duration in milliseconds
-    # @param date [String] Log entry date; formatted in yyyy-MM-dd
-    # @param distance [Integer] Distance; required for logging directory activity
-    # @param distance_unit [String] Distance measurement unit
+    # @param body [Hash] The POST request body
+    #
+    # @option body :activity_id [Integer, String] The activity ID
+    # @option body :activity_name [String] Custom activity name. Either activity ID or activity_name must be provided
+    # @option body :manual_calories [Integer] Calories burned, specified manually. Required with activity_name, otherwise optional
+    # @option body :start_time [String] Activity start time; formatted in HH:mm:ss
+    # @option body :duration_millis [Integer] Duration in milliseconds
+    # @option body :date [String] Log entry date; formatted in yyyy-MM-dd
+    # @option body :distance [Integer] Distance; required for logging directory activity
+    # @option body :distance_unit [String] Distance measurement unit
 
     def log_activity(body)
       post("user/#{user_id}/activities.json", body)
@@ -168,9 +166,6 @@ module FitbitAPI
       post("user/#{user_id}/activities/favorite/#{activity_id}.json")
     end
 
-    # DELETE Activities
-    # =================
-
     # Deletes a user's activity log entry with the given ID.
     #
     # @param activity_log_id [Integer] The ID of the activity log entry

data/lib/fitbit_api/alarms.rb

@@ -1,29 +1,24 @@
 module FitbitAPI
   class Client
-    # GET Alarms
-    # ==========
-
     # Returns a list of the set alarms connected to a user's account.
     #
-    # @params tracker_id [Integer] The ID of the tracker for which the data is returned
+    # @param tracker_id [Integer] The ID of the tracker for which the data is returned
 
     def alarms(tracker_id)
       get("user/#{user_id}/devices/tracker/#{tracker_id}/alarms.json")
     end
 
-    # POST Alarms
-    # ===========
-
     # Adds the alarm settings to a given ID for a given device.
     #
     #   add_alarm(123, time: "07:15-08:00", recurring: true, week_days: "MONDAY,FRIDAY,SATURDAY")
     #
     # @param tracker_id [Integer] The ID of the tracker for which the alarm is created
+    # @param body [Hash] The POST request body
     #
-    # @param time [String] Time of day that the alarm vibrates with a UTC timezone offset, e.g. 07:15-08:00
-    # @param enabled [Boolean] If false, alarm does not vibrate until enabled is set to true
-    # @param recurring [Boolean] If false, the alarm is a single event
-    # @param week_days [String] Comma separated list of days of the week on which the alarm vibrates (MONDAY,TUESDAY)
+    # @option body :time [String] Time of day that the alarm vibrates with a UTC timezone offset, e.g. 07:15-08:00
+    # @option body :enabled [Boolean] If false, alarm does not vibrate until enabled is set to true
+    # @option body :recurring [Boolean] If false, the alarm is a single event
+    # @option body :week_days [String] Comma separated list of days of the week on which the alarm vibrates (MONDAY,TUESDAY)
 
     def add_alarm(tracker_id, body={})
       post("user/#{user_id}/devices/tracker/#{tracker_id}/alarms.json", body)
@@ -35,23 +30,21 @@ module FitbitAPI
     #
     # @param tracker_id [Integer] The ID of the tracker for which the alarm is created
     # @param alarm_id [Integer] The ID of the alarm to be updated
+    # @param body [Hash] The POST request body.
     #
-    # @param time [String] Time of day that the alarm vibrates with a UTC timezone offset, e.g. 07:15-08:00
-    # @param enabled [Boolean] If false, alarm does not vibrate until enabled is set to true
-    # @param recurring [Boolean] If false, the alarm is a single event
-    # @param week_days [String] Comma separated list of days of the week on which the alarm vibrates (MONDAY,TUESDAY)
-    # @param snooze_length [Integer] Minutes between alarms
-    # @param snooze_count [Integer] Maximum snooze count
-    # @param label [String] Label for alarm
-    # @param vibe [String] Vibe pattern; only one value for now (DEFAULT)
+    # @option body :time [String] Time of day that the alarm vibrates with a UTC timezone offset, e.g. 07:15-08:00
+    # @option body :enabled [Boolean] If false, alarm does not vibrate until enabled is set to true
+    # @option body :recurring [Boolean] If false, the alarm is a single event
+    # @option body :week_days [String] Comma separated list of days of the week on which the alarm vibrates (MONDAY,TUESDAY)
+    # @option body :snooze_length [Integer] Minutes between alarms
+    # @option body :snooze_count [Integer] Maximum snooze count
+    # @option body :label [String] Label for alarm
+    # @option body :vibe [String] Vibe pattern; only one value for now (DEFAULT)
 
     def update_alarm(tracker_id, alarm_id, body={})
       post("user/#{user_id}/devices/tracker/#{tracker_id}/alarms/#{alarm_id}.json", body)
     end
 
-    # DELETE Alarms
-    # =============
-
     # Deletes the user's device alarm entry with the given ID for a given device.
     #
     #   delete_alarm(123, 987)

data/lib/fitbit_api/body.rb

@@ -3,11 +3,11 @@ module FitbitAPI
     BODY_RESOURCES = %w(bmi fat weight)
 
     def weight_logs(date=Date.today)
-      get("user/-/body/log/weight/date/#{format_date(date)}.json")
+      get("user/#{user_id}/body/log/weight/date/#{format_date(date)}.json")
     end
 
     def body_fat_logs(date=Date.today)
-      get("user/-/body/log/fat/date/#{format_date(date)}.json")
+      get("user/#{user_id}/body/log/fat/date/#{format_date(date)}.json")
     end
 
     def body_time_series(resource, opts={})

data/lib/fitbit_api/client.rb

@@ -7,6 +7,7 @@ require 'fitbit_api/body'
 require 'fitbit_api/devices'
 require 'fitbit_api/food'
 require 'fitbit_api/friends'
+require 'fitbit_api/meals'
 require 'fitbit_api/sleep'
 require 'fitbit_api/subscriptions'
 require 'fitbit_api/user'
@@ -47,16 +48,16 @@ module FitbitAPI
       @token
     end
 
-    def get(path, params={}, opts={})
-      request(:get, path, opts.merge(params: params))
+    def get(path, params={}, opts={}, &block)
+      request(:get, path, opts.merge(params: params), &block)
     end
 
-    def post(path, body={}, opts={})
-      request(:post, path, opts.merge(body: body))
+    def post(path, body={}, opts={}, &block)
+      request(:post, path, opts.merge(body: body), &block)
     end
 
-    def delete(path, params={}, opts={})
-      request(:delete, path, opts.merge(params: params))
+    def delete(path, params={}, opts={}, &block)
+      request(:delete, path, opts.merge(params: params), &block)
     end
 
     private
@@ -115,7 +116,7 @@ module FitbitAPI
       refresh_token! if @token.token.empty?
     end
 
-    def request(verb, path, opts={})
+    def request(verb, path, opts={}, &block)
       request_path = "#{@api_version}/#{path}"
       request_headers = default_request_headers.merge(opts[:headers] || {})
       request_options = opts.merge(headers: request_headers)
@@ -125,7 +126,7 @@ module FitbitAPI
 
       refresh_token! if auto_refresh_token && token.expired?
 
-      response = token.public_send(verb, request_path, request_options).response
+      response = token.public_send(verb, request_path, request_options, &block).response
       response_body = MultiJson.load(response.body) unless response.status == 204
 
       process_keys!(response_body)

data/lib/fitbit_api/devices.rb

@@ -1,5 +1,7 @@
 module FitbitAPI
   class Client
+    # Retrieves a list of Fitbit devices paired to a user's account.
+
     def devices
       get("user/#{user_id}/devices.json")
     end

data/lib/fitbit_api/food.rb

@@ -6,6 +6,14 @@ module FitbitAPI
       get("user/#{user_id}/foods/log/date/#{format_date(date)}.json")
     end
 
+    # Retrieves a list of public foods from the Fitbit foods database and private foods the user created
+    #
+    # @param query [String] The search query
+
+    def search_foods(params)
+      get("foods/search.json", params)
+    end
+
     def recent_foods
       get("user/#{user_id}/foods/log/recent.json")
     end
@@ -18,8 +26,59 @@ module FitbitAPI
       get("user/#{user_id}/foods/log/favorite.json")
     end
 
-    def food_goals
-      get("user/#{user_id}/foods/log/goal.json")
+    # Creates a new private food for a user
+    #
+    # @param body [Hash] The POST request body
+
+    def create_food(body)
+      post("user/#{user_id}/foods.json", body)
+    end
+
+    # Deletes a custom food created by the user
+    #
+    # @param food_id [Integer] The ID of the food to be deleted
+
+    def delete_food(food_id)
+      delete("user/#{user_id}/foods/#{food_id}.json")
+    end
+
+    # Creates a food log entry
+    #
+    # @param body [Hash] The POST request body
+
+    def create_food_log(body)
+      post("user/#{user_id}/foods/log.json", body)
+    end
+
+    # Updates the quantity or calories consumed for a user's food log entry with the given Food Log ID
+    #
+    # @param food_log_id [Integer] The ID of the food log to edit
+    # @param body [Hash] The POST request body
+
+    def update_food_log(food_log_id, body)
+      post("user/#{user_id}/foods/log/#{food_log_id}.json", body)
+    end
+
+    # Deletes a user's food log entry using the given log ID
+    #
+    # @param food_log_id [Integer] The id of the food log entry
+
+    def delete_food_log(food_log_id)
+      delete("user/#{user_id}/foods/log/#{food_log_id}.json")
+    end
+
+    # Adds a food with the given ID to the user's list of favorite foods
+
+    def add_favorite_food(food_id)
+      post("user/#{user_id}/foods/log/favorite/#{food_id}.json")
+    end
+
+    # Deletes a food with the given ID from the user's list of favorite foods
+    #
+    # @param food_id [Integer] The ID of the food to delete from the user's favorites
+
+    def delete_favorite_food(food_id)
+      delete("user/#{user_id}/foods/log/favorite/#{food_id}.json")
     end
 
     def food_time_series(resource, opts={})
@@ -48,5 +107,17 @@ module FitbitAPI
       # remove root key from response
       result.values[0]
     end
+
+    # Retrieves the food locales used to search, log or create food
+
+    def food_locales
+      get("foods/locales.json")
+    end
+
+    # Retrieves a list of all valid Fitbit food units
+
+    def food_units
+      get("foods/units.json")
+    end
   end
 end

data/lib/fitbit_api/friends.rb

@@ -1,9 +1,13 @@
 module FitbitAPI
   class Client
+    # Retrieves a list of the Fitbit user's friends.
+
     def friends
       get("user/#{user_id}/friends.json")
     end
 
+    # Retrieves the user's friends leaderboard.
+
     def friends_leaderboard
       get("user/#{user_id}/friends/leaderboard.json")
     end

data/lib/fitbit_api/goals.rb

@@ -1,63 +1,118 @@
 module FitbitAPI
   class Client
-    # GET Goals
-    # =========
-
     # Retrieves a user's current weight goal.
 
     def weight_goal
-      get("user/-/body/log/weight/goal.json")
+      get("user/#{user_id}/body/log/weight/goal.json")
     end
 
     # Retrieves a user's current body fat percentage goal.
 
     def body_fat_goal
-      get("user/-/body/log/fat/goal.json")
+      get("user/#{user_id}/body/log/fat/goal.json")
     end
 
     # Retrieves a user's current daily activity goals.
 
-    def daily_goals
+    def daily_activity_goals
       get("user/#{user_id}/activities/goals/daily.json")
     end
 
     # Retrieves a user's current weekly activity goals.
 
-    def weekly_goals
+    def weekly_activity_goals
       get("user/#{user_id}/activities/goals/weekly.json")
     end
 
-    # POST Goals
-    # ==========
+    # Retrieves a user's current sleep goal.
+
+    def sleep_goal
+      get("user/#{user_id}/sleep/goal.json")
+    end
+
+    # Retrieves the user's current daily calorie consumption goal and/or food plan.
+
+    def food_goals
+      get("user/#{user_id}/foods/log/goal.json")
+    end
+
+    # Retrieves a user's daily water consumption goal.
+
+    def water_goal
+      get("user/#{user_id}/foods/log/water/goal.json")
+    end
 
     # Creates or updates a user's daily activity goals and returns a response using units
     # in the unit system which corresponds to the Accept-Language header provided.
     #
-    #   create_or_update_daily_goals(calories_out: 2000, active_minutes: 90, floors: 5)
+    #   update_daily_activity_goals(calories_out: 2000, active_minutes: 90, floors: 5)
+    #
+    # @param body [Hash] The POST request body
     #
-    # @param calories_out [Integer] Calories output goal value
-    # @param active_minutes [Integer] Active minutes goal value
-    # @param floors [Integer] Floor goal value
-    # @param distance [Integer, Float] Distance goal value
-    # @param steps [Integer] Steps goal value
+    # @option body :calories_out [Integer] Calories output goal value
+    # @option body :active_minutes [Integer] Active minutes goal value
+    # @option body :floors [Integer] Floor goal value
+    # @option body :distance [Integer, Float] Distance goal value
+    # @option body :steps [Integer] Steps goal value
 
-    def create_or_update_daily_goals(body={})
+    def update_daily_activity_goals(body={})
       post("user/#{user_id}/activities/goals/daily.json", body)
     end
 
     # Creates or updates a user's weekly activity goals and returns a response using units
     # in the unit system which corresponds to the Accept-Language header provided.
     #
-    #   create_or_update_weekly_goals(active_minutes: 300, floors: 20)
+    #   update_weekly_activity_goals(active_minutes: 300, floors: 20)
     #
-    # @param calories_out [Integer] Calories output goal value
-    # @param active_minutes [Integer] Active minutes goal value
-    # @param floors [Integer] Floor goal value
-    # @param distance [Integer, Float] Distance goal value
-    # @param steps [Integer] Steps goal value
+    # @param body [Hash] The POST request body
+    #
+    # @option body :calories_out [Integer] Calories output goal value
+    # @option body :active_minutes [Integer] Active minutes goal value
+    # @option body :floors [Integer] Floor goal value
+    # @option body :distance [Integer, Float] Distance goal value
+    # @option body :steps [Integer] Steps goal value
 
-    def create_or_update_weekly_goals(body={})
+    def update_weekly_activity_goals(body={})
       post("user/#{user_id}/activities/goals/weekly.json", body)
     end
+
+    # Creates or updates a user's weight goal.
+    #
+    # @param body [Hash] the POST request body
+    def update_weight_goal(body)
+      post("user/#{user_id}/body/log/weight/goal.json", body)
+    end
+
+    # Creates or updates a user's body fat goal.
+    #
+    # @param body [Hash] the POST request body
+
+    def update_body_fat_goal(body)
+      post("user/#{user_id}/body/log/fat/goal.json", body)
+    end
+
+    # Create or update a user's sleep goal.
+    #
+    # @param body [Hash] the POST request body
+
+    def update_sleep_goal(body)
+      post("user/#{user_id}/sleep/goal.json", body)
+    end
+
+    # Creates or updates a user's daily calorie consumption or food plan goals.
+    #
+    # @param body [Hash] the POST request body
+
+    def update_food_goals(body)
+      post("user/#{user_id}/foods/log/goal.json", body)
+    end
+
+    # Creates or updates a user's daily water consumption goal.
+    #
+    # @param body [Hash] the POST request body
+
+    def update_water_goal(body)
+      post("user/#{user_id}/foods/log/water/goal.json", body)
+    end
   end
 end

data/lib/fitbit_api/heart_rate.rb

@@ -42,9 +42,9 @@ module FitbitAPI
       end
 
       if (start_time && end_time)
-        get("user/-/activities/heart/date/#{format_date(date)}/1d/#{detail_level}/time/#{format_time(start_time)}/#{format_time(end_time)}.json")
+        get("user/#{user_id}/activities/heart/date/#{format_date(date)}/1d/#{detail_level}/time/#{format_time(start_time)}/#{format_time(end_time)}.json")
       else
-        get("user/-/activities/heart/date/#{format_date(date)}/1d/#{detail_level}.json")
+        get("user/#{user_id}/activities/heart/date/#{format_date(date)}/1d/#{detail_level}.json")
       end
     end
   end

data/lib/fitbit_api/helpers/utils.rb

@@ -1,6 +1,5 @@
 module FitbitAPI
   class Client
-
     PERIODS = %w(1d 7d 30d 1w 1m 3m 6m 1y max).freeze
 
     def format_date(date)
@@ -79,6 +78,5 @@ module FitbitAPI
       string.gsub!(/^\w{1}/) { |word| word.downcase } if opts[:lower]
       return string
     end
-
   end
 end

data/lib/fitbit_api/meals.rb

@@ -0,0 +1,42 @@
+module FitbitAPI
+  class Client
+    # Retrieves a list of meals created by the user from their food log
+
+    def meals
+      get("user/#{user_id}/meals.json")
+    end
+
+    # Retrieves a single meal created by the user from their food log given the meal id
+    #
+    # @param meal_id [Integer] The ID of the meal
+
+    def meal(meal_id)
+      get("user/#{user_id}/meals/#{meal_id}.json")
+    end
+
+    # Creates a meal with the given food
+    #
+    # @param body [Hash] The POST request body
+
+    def create_meal(body)
+      post("user/#{user_id}/meals.json", body)
+    end
+
+    # Updates an existing meal with the contents of the request
+    #
+    # @param meal_id [Integer] The ID of the meal
+    # @param body [Hash] The POST request body
+
+    def update_meal(meal_id, body)
+      post("user/#{user_id}/meals/#{meal_id}.json", body)
+    end
+
+    # Deletes an existing meal of the given meal ID
+    #
+    # @param meal_id [Integer] The ID of the meal
+
+    def delete_meal(meal_id)
+      delete("user/#{user_id}/meals/#{meal_id}.json")
+    end
+  end
+end

data/lib/fitbit_api/sleep.rb

@@ -3,10 +3,47 @@ module FitbitAPI
     SLEEP_RESOURCES = %w(startTime timeInBed minutesAsleep awakeningsCount
                          minutesAwake minutesToFallAsleep minutesAfterWakeup efficiency)
 
+    # Returns a list of a user's sleep log entries for a given date. The data returned can include sleep
+    # periods that began on the previous date. For example, if you request a Sleep Log for 2021-12-22,
+    # it may return a log entry that began the previous night on 2021-12-21, but ended on 2021-12-22.
+    #
+    # @param date [Date, String] The date for the sleep log to be returned in the format yyyy-MM-dd
+
     def sleep_logs(date=Date.today)
       get("user/#{user_id}/sleep/date/#{format_date(date)}.json")
     end
 
+    # Returns a list of a user's sleep log entries before or after a given date, and specifying offset,
+    # limit and sort order. The data returned for different dates can include sleep periods that began
+    # on the previous date. For example, a sleep log entry for 2018-10-21 may have ended that day but
+    # started the previous night on 2018-10-20.
+    #
+    #   sleep_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: 100)
+
+    def sleep_logs_list(params={})
+      default_params = { before_date: Date.today, after_date: nil, sort: 'desc', limit: 20, offset: 0 }
+      get("user/#{user_id}/sleep/list.json", default_params.merge(params))
+    end
+
+    # Creates a log entry for a sleep event
+
+    def create_sleep_log(body)
+      post("user/#{user_id}/sleep.json", body)
+    end
+
+    # Deletes a sleep log with the given log ID
+    def delete_sleep_log(sleep_log_id)
+      delete("user/#{user_id}/sleep/#{sleep_log_id}.json")
+    end
+
     def sleep_time_series(resource, opts={})
       start_date = opts[:start_date]
       end_date   = opts[:end_date] || Date.today

data/lib/fitbit_api/user.rb

@@ -1,13 +1,21 @@
 module FitbitAPI
   class Client
+    # Retrieves the user's profile data.
+
     def profile
       get("user/#{user_id}/profile.json")
     end
 
+    # Retrieves a list of the user's badges.
+
     def badges
       get("user/#{user_id}/badges.json")
     end
 
+    # Modifies a user's profile data.
+    #
+    # @param body [Hash] The POST request body
+
     def update_profile(body)
       post("user/#{user_id}/profile.json", body)
     end

data/lib/fitbit_api/version.rb

@@ -1,3 +1,3 @@
 module FitbitAPI
-  VERSION = '0.11.0'
+  VERSION = '0.12.2'
 end

data/lib/fitbit_api/water.rb

@@ -1,7 +1,36 @@
 module FitbitAPI
   class Client
+    # Retrieves a summary and list of a user's water log entries for a given day
+    #
+    # @param date [Date] The date for which entries are to be returned
+
     def water_logs(date=Date.today)
       get("user/#{user_id}/foods/log/water/date/#{format_date(date)}.json")
     end
+
+    # Create a user's water log entry
+    #
+    # @param body [Hash] The POST request body for creating the water log entry
+
+    def log_water(body)
+      post("user/#{user_id}/foods/log/water.json", body)
+    end
+
+    # Updates the quantity consumed for a user's water log entry with the given log ID
+    #
+    # @param water_log_id [Integer] The ID of the water log to be updated
+    # @param body [Hash] The POST request body for updating the water log
+
+    def update_water_log(water_log_id, body)
+      post("user/#{user_id}/foods/log/water/#{water_log_id}.json", body)
+    end
+
+    # Deleted a user's water log entry using the given log ID
+    #
+    # @param water_log_id [Integer] The id of the water log entry
+
+    def delete_water_log(water_log_id)
+      delete("user/#{user_id}/foods/log/water/#{water_log_id}.json")
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fitbit_api
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.2
 platform: ruby
 authors:
 - Zoran
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-05-07 00:00:00.000000000 Z
+date: 2022-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth2
@@ -28,16 +28,16 @@ dependencies:
   name: byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '11.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '11.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -56,39 +56,39 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 12.3.3
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 12.3.3
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.11'
 description: 
 email: 
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/test.yml"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
@@ -109,6 +109,7 @@ files:
 - 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/sleep.rb
 - lib/fitbit_api/subscriptions.rb
 - lib/fitbit_api/user.rb

data/.travis.yml

@@ -1,8 +0,0 @@
-language: ruby
-rvm:
-  - 2.7.2
-  - 2.6.6
-  - 2.5.1
-  - 2.4.2
-  - 2.3.5
-before_install: gem install bundler -v 1.10.3