fitbit_api 0.8.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 31efa6a0f7a2789cf58d8e7610896d61a62190b6
+  data.tar.gz: 18ca4f3a85c6ef71912eab47ad1b967fad4a70f2
+SHA512:
+  metadata.gz: 15cd160837bffa0569b67427559213897620e58512e531ef8f244ea0ac80f23738870cc95ff5e021322223f014014a2df4ec6adac2aac7f7a80c54b4965034e3
+  data.tar.gz: 59fe662dabce55df5f2bfc6163802fcd43a71286b1bd44a0211c7df31c406c494b0af146d636bf3969729b0708ccd4b04d1f5a53cdb51b6670e88a4c65af840c

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 2.2.2
+  - 2.1.6
+  - 2.0.0
+  - 1.9.3
+before_install: gem install bundler -v 1.10.3

data/CHANGELOG.md

@@ -0,0 +1,88 @@
+0.7.1
+-----
+- Rename `#auth_page_link` to `#auth_url`
+- Rename `snake_case` option to `snake_case_keys`
+- Code cleanup
+
+0.7.0
+-----
+- Add support for Activity and Heart Rate Intraday Time Series endpoints.
+- Add support for weight and fat logging and deletion endpoints.
+- Renamed `#weight_goals` and `#body_fat_goals` to `#weight_goal` and `#body_fat_goal`.
+
+0.6.0
+-----
+- A `refresh_token` option can be passed in to retrieve an existing access token.
+- A configuration block can now be passed in to FitbitAPI, to allow for the setting of default instance attributes.
+- File/code reorganization.
+
+0.5.0
+-----
+- Add Heart Rate endpoint support. Add support for Time Series endpoints.
+- Minor improvements to some helper functions
+
+0.4.1
+-----
+- Users can now provide either snake_cased or camelCased param attribute keys when POSTing data to Fitbit. Keys are automatically converted to camelCase before a request is sent to Fitbit's API.
+
+0.4.0
+-----
+- Remove FitStruct objects
+- The response's hash keys can now be transformed using the following options:
+  - `snake_case` - if set to true, all keys are formatted to snake_case
+  - `symbolize_keys` - if set to true, all keys are converted to symbols
+
+0.3.0
+-----
+- API endpoint support for the following actions:
+  - Add alarm
+  - Update alarm
+  - Delete alarm
+- File reorganization
+
+0.2.7
+-----
+- Set minimum required Ruby version
+- Minor testing tweaks for Travis CI
+
+0.2.6
+-----
+- Expand API endpoint support for the following actions:
+  - Add activity to favorites
+  - Retrieve list of activity log entries
+  - Create/update daily/weekly goals
+  - Delete activity
+  - Remove activity from favorites
+
+0.2.5
+-----
+- Responses now return FitStruct objects (inherit from OpenStruct).
+
+- Ability to set default data return format by setting `raw_response` on FitbitAPI::Client instance (defaults to using FitStruct objects). Can be overridden on each API call by specifying the `raw` boolean option.
+
+0.2.4
+-----
+- Default result format for `get` calls now return OpenStruct objects, allowing for more convenient method-like attribute access. Specifying `raw: true` returns original JSON.
+
+0.2.3
+-----
+- Remove `require 'json'`
+
+0.2.2
+-----
+- MultiJson used for parsing JSON (with symbolized keys)
+
+0.2.1
+-----
+- `user_id` is interpolated into resource URLs, removing the hardcoded `-`.
+
+0.2.0
+-----
+- API version in resource URLs is now user settable.
+- Scope argument takes both String and Array types.
+- Default init values moved to `defaults` hash.
+
+0.1.0
+-----
+- Initial auth logic setup for Client class.
+- Endpoint support added for retrieving Food, Sleep, Water, Activities, Alarms, Body, Devices, Friends, and Users.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in fitbit_api.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Zoran Pesic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,95 @@
+# 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)
+
+FitbitAPI provides a Ruby interface to the [Fitbit Web API](https://dev.fitbit.com/reference/web-api/quickstart).
+
+## Installation
+
+To install the latest release:
+
+    $ gem install fitbit_api
+
+To include in a Rails project, add it to the Gemfile:
+
+```ruby
+gem 'fitbit_api'
+```
+
+## Usage
+
+To use the Fitbit API, you must register your application at [dev.fitbit.com](https://dev.fitbit.com/apps). After registering, you should have access to **CLIENT ID**, **CLIENT SECRET**, and **REDIRECT URI (Callback URL)** values for use in instantiating a *FitbitAPI::Client* object.
+
+### Rails
+
+Please reference the [fitbit_api_rails repo](https://github.com/zokioki/fitbit_api_rails) as an example of how to use this gem within Rails.
+
+### Standalone
+
+- Create a client instance:
+
+```ruby
+client = FitbitAPI::Client.new(client_id: 'XXXXXX',
+                             client_secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
+                             redirect_uri: 'http://example.com/handle/callback')
+```
+
+- Generate a link for the Fitbit authorization page:
+
+```ruby
+client.auth_url
+# => https://fitbit.com/oauth2/authorize?client_id=123XYZ&redirect_uri=...
+```
+
+- Follow the generated link to Fitbit's authorization page. After approving your app, you're sent to the `redirect_uri`, with an appended authorization `code` param, which you'll exchange for an access token:
+
+```ruby
+client.get_token(auth_code)
+```
+
+You're now authenticated and can make calls to Fitbit's API:
+
+```ruby
+client.food_logs Date.today
+# => { "foods" => [{ "isFavorite" => true, "logDate" => "2015-06-26", "logId" => 1820, "loggedFood" => { "accessLevel" => "PUBLIC", "amount" => 132.57, "brand" => "", "calories" => 752, ...}] }
+```
+
+To make the response more easily suited for attribute-assignment, it can be parsed to return a hash whose keys are in snake_case format. This can be done by setting the client's `snake_case_keys` option to `true`, like so:
+
+```ruby
+client.snake_case_keys = true
+client.food_logs Date.today
+# => { "foods" => [{ "is_favorite" => true, "log_date" => "2015-06-26", "log_id" => 1820, "logged_food" => { "access_level" => "PUBLIC", "amount" => 132.57, "brand" => "", "calories" => 752, ...}] }
+```
+
+Similarly, all arguments passed in through a POST request are automatically converted to camelCase before they hit Fitbit's API, making it easy to keep your codebase stylistically consistent. For example, all of the following would result in valid API calls:
+
+```ruby
+client.log_activity activity_id: 12345, duration_millis: '50000'
+client.log_activity activityId: 54321, durationMillis: '44100'
+# If for some reason you had to mix snake and camel case like below,
+# FitbitAPI would make sure the result is a validly formatted request
+client.log_activity activity_id: 12345, durationMillis: '683300'
+```
+
+### Options
+
+When initializing a `FitbitAPI::Client` instance, you're given access to a handful of options:
+
+- `: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" | available: "en_US", "en_GB", and "any" for metric)
+
+- `:locale` - The locale to use for response values (default: "en_US" | available: "en_US", "fr_FR", "de_DE", "es_ES", "en_GB", "en_AU", "en_NZ" and "ja_JP")
+
+- `:scope` - A space-delimited list of the permissions you are requesting (default: "activity nutrition profile settings sleep social weight heartrate" | available: "activity", "heartrate", "location", "nutrition", "profile", "settings" "sleep", "social" and "weight")
+
+- `:snake_case_keys` - Transform returned object's keys to snake case format (default: false)
+
+- `:symbolize_keys` - Transform returned object's keys to symbols (default: false)
+
+
+## License
+
+This gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/fitbit_api.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fitbit_api/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'fitbit_api'
+  spec.version       = FitbitAPI::VERSION
+  spec.authors       = ['Zoran']
+
+  spec.summary       = %q{A Ruby interface to the Fitbit API, using OAuth2 (renamed to fitbit_api)}
+  spec.homepage      = FitbitAPI::REPO_URL
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 1.9.3'
+
+  spec.add_runtime_dependency     'oauth2', '~> 1.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.10'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec'
+
+  spec.post_install_message = %q{
+    The fitbit_api gem has been renamed to fitbit_api and will no longer be supported.
+    Please switch to using fitbit_api for all versions greater than 0.7.1.
+  }
+end

data/lib/fitbit_api.rb

@@ -0,0 +1,6 @@
+require 'oauth2'
+require 'date'
+require 'fitbit_api/version'
+require 'fitbit_api/client'
+
+module FitbitAPI; end

data/lib/fitbit_api/activities.rb

@@ -0,0 +1,174 @@
+module FitbitAPI
+  class Client
+
+    ACTIVITY_RESOURCES = %w(calories caloriesBMR steps distance floors elevation
+                            minutesSedentary minutesLightlyActive minutesFairlyActive
+                            minutesVeryActive activityCalories tracker/calories
+                            tracker/steps tracker/distance tracker/floors
+                            tracker/elevation tracker/minutesSedentary
+                            tracker/minutesLightlyActive tracker/minutesFairlyActive
+                            tracker/minutesVeryActive tracker/activityCalories)
+
+    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.
+
+    def daily_activity_summary(date=Date.today, opts={})
+      get("user/#{user_id}/activities/date/#{format_date(date)}.json", opts)
+    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.
+
+    def frequent_activities(opts={})
+      get("user/#{user_id}/activities/frequent.json", opts)
+    end
+
+    def recent_activities(opts={})
+      get("user/#{user_id}/activities/recent.json", opts)
+    end
+
+    # Returns a list of a user's favorite activities.
+
+    def favorite_activities(opts={})
+      get("user/#{user_id}/activities/favorite.json", opts)
+    end
+
+    # Gets a tree of all valid Fitbit public activities from
+    #   the activities catalog as well as private custom activities the user created.
+
+    def all_activities(opts={})
+      get('activities.json', opts)
+    end
+
+    # Retrieves a list of a user's activity log entries before or after a given day with
+    #   offset and limit using units in the unit system which corresponds to the Accept-Language header provided.
+
+    # ==== Parameters
+    # * +:beforeDate+ - the date; formatted in yyyy-MM-ddTHH:mm:ss
+    # * +:afterDate+ - the date; formatted in yyyy-MM-ddTHH:mm:ss
+    # * +:sort+ - the sort order of entries by date (asc or desc)
+    # * +:offset+ - the offset number of entries
+    # * +:limit+ - the max of the number of entries returned (max: 100)
+
+    def activity_logs_list(opts={})
+      get("user/#{user_id}/activities/list.json", opts)
+    end
+
+    # Returns the details of a specific activity in the Fitbit activities database in the format requested.
+    #   If activity has levels, also returns a list of activity level details.
+
+    def activity(activity_id)
+      get("activities/#{activity_id}.json")
+    end
+
+    # Retrieves the user's activity statistics in the format requested using units
+    #   in the unit system which corresponds to the Accept-Language header provided.
+    #   Activity statistics includes Lifetime and Best achievement values from the
+    #   My Achievements tile on the website dashboard.
+
+    def lifetime_stats(opts={})
+      get("user/#{user_id}/activities.json", opts)
+    end
+
+    def activity_time_series(resource, opts={})
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date] || Date.today
+      period     = opts[:period]
+
+      unless ACTIVITY_RESOURCES.include?(resource)
+        raise FitbitAPI::InvalidArgumentError, "Invalid resource: \"#{resource}\". Please provide one of the following: #{ACTIVITY_RESOURCES}."
+      end
+
+      if [start_date, period].none?
+        raise FitbitAPI::InvalidArgumentError, 'A start_date or period is required.'
+      end
+
+      if period && !PERIODS.include?(period)
+        raise FitbitAPI::InvalidArgumentError, "Invalid period: \"#{period}\". Please provide one of the following: #{PERIODS}."
+      end
+
+      if period
+        result = get("user/#{user_id}/activities/#{resource}/date/#{format_date(end_date)}/#{period}.json", opts)
+      else
+        result = get("user/#{user_id}/activities/#{resource}/date/#{format_date(start_date)}/#{format_date(end_date)}.json", opts)
+      end
+      # remove root key from response
+      result.values[0]
+    end
+
+    def activity_intraday_time_series(resource, opts={})
+      date         = opts[:date] || Date.today
+      detail_level = opts[:detail_level]
+      start_time   = opts[:start_time]
+      end_time     = opts[:end_time]
+
+      unless ACTIVITY_INTRADAY_RESOURCES.include?(resource)
+        raise FitbitAPI::InvalidArgumentError, "Invalid resource: \"#{resource}\". Please provide one of the following: #{ACTIVITY_RESOURCES}."
+      end
+
+      if [date, detail_level].any?(&:nil?)
+        raise FitbitAPI::InvalidArgumentError, 'A date and detail_level are required.'
+      end
+
+      unless %(1min 15min).include? detail_level
+        raise FitbitAPI::InvalidArgumentError, "Invalid detail_level: \"#{detail_level}\". Please provide one of the following: \"1min\" or \"15min\"."
+      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
+
+      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")
+      else
+        get("user/-/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.
+
+    # ==== POST Parameters
+    # * +:activityId+ - activity id
+    # * +:activityName+ - custom activity name. Either activity ID or activityName must be provided
+    # * +:manualCalories+ - calories burned, specified manually. Required with activityName, otherwise optional
+    # * +:startTime+ - activity start time; formatted in HH:mm:ss
+    # * +:durationMillis+ - duration in milliseconds
+    # * +:date+ - log entry date; formatted in yyyy-MM-dd
+    # * +:distance+ - distance; required for logging directory activity; formatted in X.XX
+    # * +:distanceUnit+ - distance measurement unit
+
+    def log_activity(opts)
+      post("user/#{user_id}/activities.json", opts)
+    end
+
+    # Adds the activity with the given ID to user's list of favorite activities.
+
+    def add_favorite_activity(activity_id)
+      post("user/#{user_id}/activities/favorite/#{activity_id}.json")
+    end
+
+    # DELETE Activities
+    # =================
+
+    # Deletes a user's activity log entry with the given ID.
+
+    def delete_activity(activity_log_id)
+      delete("user/#{user_id}/activities/#{activity_log_id}.json")
+    end
+
+    # Removes the activity with the given ID from a user's list of favorite activities.
+
+    def delete_favorite_activity(activity_id)
+      delete("user/#{user_id}/activities/favorite/#{activity_id}.json")
+    end
+  end
+end

data/lib/fitbit_api/alarms.rb

@@ -0,0 +1,52 @@
+module FitbitAPI
+  class Client
+    # GET Alarms
+    # ==========
+
+    # Returns a list of the set alarms connected to a user's account.
+
+    def alarms(tracker_id, opts={})
+      get("user/#{user_id}/devices/tracker/#{tracker_id}/alarms.json", opts)
+    end
+
+    # POST Alarms
+    # ===========
+
+    # Adds the alarm settings to a given ID for a given device.
+
+    # ==== POST Parameters
+    # * +:time+ - time of day that the alarm vibrates with a UTC timezone offset, e.g. 07:15-08:00
+    # * +:enabled+ - boolean; if false, alarm does not vibrate until enabled is set to true
+    # * +:recurring+ - boolean; if false, the alarm is a single event
+    # * +:weekDays+ - comma separated list of days of the week on which the alarm vibrates (MONDAY,TUESDAY)
+
+    def add_alarm(tracker_id, opts={})
+      post("user/#{user_id}/devices/tracker/#{tracker_id}/alarms.json", opts)
+    end
+
+    # Updates the alarm entry with a given ID for a given device.
+
+    # ==== POST Parameters
+    # * +:time+ - time of day that the alarm vibrates with a UTC timezone offset, e.g. 07:15-08:00
+    # * +:enabled+ - boolean; if false, alarm does not vibrate until enabled is set to true
+    # * +:recurring+ - boolean; if false, the alarm is a single event
+    # * +:weekDays+ - comma separated list of days of the week on which the alarm vibrates (MONDAY,TUESDAY)
+    # * +:snoozeLength+ - integer; minutes between alarms
+    # * +:snoozeCount+ - integer; maximum snooze count
+    # * +:label+ - string; label for alarm
+    # * +:vibe+ - vibe pattern; only one value for now (DEFAULT)
+
+    def update_alarm(tracker_id, alarm_id, opts={})
+      post("user/#{user_id}/devices/tracker/#{tracker_id}/alarms/#{alarm_id}.json", opts)
+    end
+
+    # DELETE Alarms
+    # =============
+
+    # Deletes the user's device alarm entry with the given ID for a given device.
+
+    def delete_alarm(tracker_id, alarm_id, opts={})
+      delete("user/#{user_id}/devices/tracker/#{tracker_id}/alarms/#{alarm_id}.json", opts)
+    end
+  end
+end

data/lib/fitbit_api/base.rb

@@ -0,0 +1,24 @@
+require 'fitbit_api/helpers/configuration'
+require 'fitbit_api/helpers/utils'
+require 'fitbit_api/helpers/exceptions'
+
+module FitbitAPI
+  extend Configuration
+
+  define_setting :client_id
+  define_setting :client_secret
+  define_setting :redirect_uri
+
+  define_setting :site_url,        'https://api.fitbit.com'
+  define_setting :authorize_url,   'https://www.fitbit.com/oauth2/authorize'
+  define_setting :token_url,       'https://api.fitbit.com/oauth2/token'
+
+  define_setting :unit_system,     'en_US'
+  define_setting :locale,          'en_US'
+  define_setting :scope,           'activity nutrition profile settings sleep social weight heartrate'
+
+  define_setting :api_version,     '1'
+
+  define_setting :snake_case_keys, false
+  define_setting :symbolize_keys,  false
+end

data/lib/fitbit_api/body.rb

@@ -0,0 +1,55 @@
+module FitbitAPI
+  class Client
+    BODY_RESOURCES = %w(bmi fat weight)
+
+    def weight_logs(date=Date.today, opts={})
+      get("user/-/body/log/weight/date/#{format_date(date)}.json", opts)
+    end
+
+    def body_fat_logs(date=Date.today, opts={})
+      get("user/-/body/log/fat/date/#{format_date(date)}.json", opts)
+    end
+
+    def body_time_series(resource, opts={})
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date] || Date.today
+      period     = opts[:period]
+
+      unless BODY_RESOURCES.include?(resource)
+        raise FitbitAPI::InvalidArgumentError, "Invalid resource: \"#{resource}\". Please provide one of the following: #{BODY_RESOURCES}."
+      end
+
+      if [period, start_date].none?
+        raise FitbitAPI::InvalidArgumentError, 'A start_date or period is required.'
+      end
+
+      if period && !PERIODS.include?(period)
+        raise FitbitAPI::InvalidArgumentError, "Invalid period: \"#{period}\". Please provide one of the following: #{PERIODS}."
+      end
+
+      if period
+        result = get("user/#{user_id}/body/#{resource}/date/#{format_date(end_date)}/#{period}.json", opts)
+      else
+        result = get("user/#{user_id}/body/#{resource}/date/#{format_date(start_date)}/#{format_date(end_date)}.json", opts)
+      end
+      # remove root key from response
+      result.values[0]
+    end
+
+    def log_weight(opts)
+      post("user/#{user_id}/body/log/weight.json", opts)
+    end
+
+    def delete_weight_log(weight_log_id, opts={})
+      delete("user/#{user_id}/body/log/weight/#{weight_log_id}.json", opts)
+    end
+
+    def log_body_fat(opts)
+      post("user/#{user_id}/body/log/fat.json", opts)
+    end
+
+    def delete_body_fat_log(body_fat_log_id, opts={})
+      delete("user/#{user_id}/body/log/fat/#{body_fat_log_id}.json", opts)
+    end
+  end
+end

data/lib/fitbit_api/client.rb

@@ -0,0 +1,94 @@
+require 'fitbit_api/base'
+require 'fitbit_api/activities'
+require 'fitbit_api/heart_rate'
+require 'fitbit_api/goals'
+require 'fitbit_api/alarms'
+require 'fitbit_api/body'
+require 'fitbit_api/devices'
+require 'fitbit_api/food'
+require 'fitbit_api/friends'
+require 'fitbit_api/sleep'
+require 'fitbit_api/user'
+require 'fitbit_api/water'
+
+module FitbitAPI
+  class Client
+    attr_accessor :api_version, :unit_system, :locale, :scope, :snake_case_keys, :symbolize_keys
+    attr_reader   :user_id
+
+    def initialize(opts)
+      missing_args = [:client_id, :client_secret] - opts.keys
+      raise FitbitAPI::InvalidArgumentError, "Required arguments: #{missing_args.join(', ')}" if missing_args.size > 0
+
+      %w(client_id client_secret redirect_uri site_url authorize_url token_url
+      unit_system locale scope api_version snake_case_keys symbolize_keys).each do |attr|
+        instance_variable_set("@#{attr}", (opts[attr.to_sym] || FitbitAPI.send(attr)))
+      end
+
+      @client = OAuth2::Client.new(@client_id, @client_secret, site: @site_url,
+                                   authorize_url: @authorize_url, token_url: @token_url)
+
+      restore_token(opts[:refresh_token]) if opts[:refresh_token]
+    end
+
+    def auth_url
+      @client.auth_code.authorize_url(redirect_uri: @redirect_uri, scope: @scope)
+    end
+
+    def get_token(auth_code)
+      @token = @client.auth_code.get_token(auth_code, redirect_uri: @redirect_uri, headers: auth_header)
+      @user_id = @token.params['user_id']
+      return @token
+    end
+
+    def restore_token(refresh_token)
+      @token = OAuth2::AccessToken.from_hash(@client, refresh_token: refresh_token).refresh!(headers: auth_header)
+      @user_id = @token.params['user_id']
+      return @token
+    end
+
+    def token
+      @token.expired? ? refresh_token : @token
+    end
+
+    def refresh_token
+      @token = @token.refresh!(headers: auth_header)
+    end
+
+    def auth_header
+      { 'Authorization' => ('Basic ' + Base64.encode64(@client_id + ':' + @client_secret)) }
+    end
+
+    def request_headers
+      {
+        'User-Agent' => "fitbit_api-#{FitbitAPI::VERSION} gem (#{FitbitAPI::REPO_URL})",
+        'Accept-Language' => @unit_system,
+        'Accept-Locale' => @locale
+      }
+    end
+
+    def get(path, opts={})
+      response = token.get(("#{@api_version}/" + path), headers: request_headers).response
+      object = MultiJson.load(response.body) unless response.status == 204
+      process_keys!(object, opts)
+    end
+
+    def post(path, opts={})
+      response = token.post(("#{@api_version}/" + path), body: deep_keys_to_camel_case!(opts), headers: request_headers).response
+      object = MultiJson.load(response.body) unless response.status == 204
+      process_keys!(object, opts)
+    end
+
+    def delete(path, opts={})
+      response = token.delete(("#{@api_version}/" + path), headers: request_headers).response
+      object = MultiJson.load(response.body) unless response.status == 204
+      process_keys!(object, opts)
+    end
+
+    def process_keys!(object, opts={})
+      deep_keys_to_snake_case!(object) if (opts[:snake_case_keys] || snake_case_keys)
+      deep_symbolize_keys!(object) if (opts[:symbolize_keys] || symbolize_keys)
+      return object
+    end
+  end
+end

data/lib/fitbit_api/devices.rb

@@ -0,0 +1,7 @@
+module FitbitAPI
+  class Client
+    def devices(opts={})
+      get("user/#{user_id}/devices.json", opts)
+    end
+  end
+end

data/lib/fitbit_api/food.rb

@@ -0,0 +1,51 @@
+module FitbitAPI
+  class Client
+    FOOD_RESOURCES = %w(caloriesIn water)
+
+    def food_logs(date=Date.today, opts={})
+      get("user/#{user_id}/foods/log/date/#{format_date(date)}.json", opts)
+    end
+
+    def recent_foods(opts={})
+      get("user/#{user_id}/foods/log/recent.json", opts)
+    end
+
+    def frequent_foods(opts={})
+      get("user/#{user_id}/foods/log/frequent.json", opts)
+    end
+
+    def favorite_foods(opts={})
+      get("user/#{user_id}/foods/log/favorite.json", opts)
+    end
+
+    def food_goals(opts={})
+      get("user/#{user_id}/foods/log/goal.json", opts)
+    end
+
+    def food_time_series(resource, opts={})
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date] || Date.today
+      period     = opts[:period]
+
+      unless FOOD_RESOURCES.include?(resource)
+        raise FitbitAPI::InvalidArgumentError, "Invalid resource: \"#{resource}\". Please provide one of the following: #{FOOD_RESOURCES}."
+      end
+
+      if [period, start_date].none?
+        raise FitbitAPI::InvalidArgumentError, 'A start_date or period is required.'
+      end
+
+      if period && !PERIODS.include?(period)
+        raise FitbitAPI::InvalidArgumentError, "Invalid period: \"#{period}\". Please provide one of the following: #{PERIODS}."
+      end
+
+      if period
+        result = get("user/#{user_id}/foods/log/#{resource}/date/#{format_date(end_date)}/#{period}.json", opts)
+      else
+        result = get("user/#{user_id}/foods/log/#{resource}/date/#{format_date(start_date)}/#{format_date(end_date)}.json", opts)
+      end
+      # remove root key from response
+      result.values[0]
+    end
+  end
+end

data/lib/fitbit_api/friends.rb

@@ -0,0 +1,11 @@
+module FitbitAPI
+  class Client
+    def friends(opts={})
+      get("user/#{user_id}/friends.json", opts)
+    end
+
+    def friends_leaderboard(opts={})
+      get("user/#{user_id}/friends/leaderboard.json", opts)
+    end
+  end
+end

data/lib/fitbit_api/goals.rb

@@ -0,0 +1,61 @@
+module FitbitAPI
+  class Client
+    # GET Goals
+    # =========
+
+    # Retrieves a user's current weight goal.
+
+    def weight_goal(opts={})
+      get("user/-/body/log/weight/goal.json", opts)
+    end
+
+    # Retrieves a user's current body fat percentage goal.
+
+    def body_fat_goal(opts={})
+      get("user/-/body/log/fat/goal.json", opts)
+    end
+
+    # Retrieves a user's current daily activity goals.
+
+    def daily_goals(opts={})
+      get("user/#{user_id}/activities/goals/daily.json", opts)
+    end
+
+    # Retrieves a user's current weekly activity goals.
+
+    def weekly_goals(opts={})
+      get("user/#{user_id}/activities/goals/weekly.json", opts)
+    end
+
+    # POST Goals
+    # ==========
+
+    # 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.
+
+    # ==== POST Parameters
+    # * +:caloriesOut+ - calories output goal value; integer
+    # * +:activeMinutes+ - active minutes goal value; integer
+    # * +:floors+ - floor goal value; integer
+    # * +:distance+ - distance goal value; X.XX or integer
+    # * +:steps+ - steps goal value; integer
+
+    def create_or_update_daily_goals(opts={})
+      post("user/#{user_id}/activities/goals/daily.json", opts)
+    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.
+
+    # ==== POST Parameters
+    # * +:caloriesOut+ - calories output goal value; integer
+    # * +:activeMinutes+ - active minutes goal value; integer
+    # * +:floors+ - floor goal value; integer
+    # * +:distance+ - distance goal value; X.XX or integer
+    # * +:steps+ - steps goal value; integer
+
+    def create_or_update_weekly_goals(opts={})
+      post("user/#{user_id}/activities/goals/weekly.json", opts)
+    end
+  end
+end

data/lib/fitbit_api/heart_rate.rb

@@ -0,0 +1,50 @@
+module FitbitAPI
+  class Client
+    def heart_rate_time_series(opts={})
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date] || Date.today
+      period     = opts[:period]
+
+      if [period, start_date].none?
+        raise FitbitAPI::InvalidArgumentError, 'A start_date or period is required.'
+      end
+
+      if period && !PERIODS.include?(period)
+        raise FitbitAPI::InvalidArgumentError, "Invalid period: \"#{period}\". Please provide one of the following: #{PERIODS}."
+      end
+
+      if period
+        result = get("user/#{user_id}/activities/heart/date/#{format_date(end_date)}/#{period}.json", opts)
+      else
+        result = get("user/#{user_id}/activities/heart/date/#{format_date(start_date)}/#{format_date(end_date)}.json", opts)
+      end
+      # remove root key from response
+      result.values[0]
+    end
+
+    def heart_rate_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
+
+      unless %(1sec 1min).include? detail_level
+        raise FitbitAPI::InvalidArgumentError, "Invalid detail_level: \"#{detail_level}\". Please provide one of the following: \"1sec\" or \"1min\"."
+      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
+
+      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")
+      else
+        get("user/-/activities/heart/date/#{format_date(date)}/1d/#{detail_level}.json")
+      end
+    end
+  end
+end

data/lib/fitbit_api/helpers/configuration.rb

@@ -0,0 +1,25 @@
+module Configuration
+  def configure
+    yield self
+  end
+
+  def define_setting(name, default = nil)
+    class_variable_set("@@#{name}", default)
+
+    define_class_method "#{name}=" do |value|
+      class_variable_set("@@#{name}", value)
+    end
+
+    define_class_method name do
+      class_variable_get("@@#{name}")
+    end
+  end
+
+  private
+
+  def define_class_method(name, &block)
+    (class << self; self; end).instance_eval do
+      define_method name, &block
+    end
+  end
+end

data/lib/fitbit_api/helpers/exceptions.rb

@@ -0,0 +1,4 @@
+module FitbitAPI
+  class InvalidArgumentError < ArgumentError
+  end
+end

data/lib/fitbit_api/helpers/utils.rb

@@ -0,0 +1,84 @@
+module FitbitAPI
+  class Client
+
+    PERIODS = %w(1d 7d 30d 1w 1m 3m 6m 1y max)
+
+    def format_date(date)
+      if [Date, Time, DateTime].include?(date.class)
+        date.strftime("%Y-%m-%d")
+      elsif date.is_a? String
+        if date =~ /\d{4}\-\d{2}\-\d{2}/
+          date
+        else
+          raise FitbitAPI::InvalidArgumentError, "Invalid argument [\"#{date}\"] - string must follow yyyy-MM-dd format."
+        end
+      else
+        raise FitbitAPI::InvalidArgumentError, "Invalid type [#{date.class}] - provide a Date/Time/DateTime or a String(yyyy-MM-dd format)."
+      end
+    end
+
+    def format_time(time)
+      if [Time, DateTime].include?(time.class)
+        time.strftime('%H:%M')
+      elsif time.is_a? String
+        if time =~ /\d{2}\:\d{2}/
+          time
+        else
+          raise FitbitAPI::InvalidArgumentError, "Invalid argument [\"#{time}\"] - string must follow HH:mm format."
+        end
+      else
+        raise FitbitAPI::InvalidArgumentError, "Invalid type [#{time.class}] - provide a Time/DateTime or a String(HH:mm format)."
+      end
+    end
+
+    def format_scope(scope)
+      scope.is_a?(Array) ? scope.join(' ') : scope
+    end
+
+    def deep_keys_to_snake_case!(object)
+      deep_transform_keys!(object) { |key| to_snake_case(key, replace_dashes: true) }
+    end
+
+    def deep_keys_to_camel_case!(object)
+      deep_transform_keys!(object) { |key| to_camel_case(key, lower: true) }
+    end
+
+    def deep_symbolize_keys!(object)
+      deep_transform_keys!(object) { |key| key.to_sym rescue key }
+    end
+
+    # Inspired by ActiveSupport's implementation
+    def deep_transform_keys!(object, &block)
+      case object
+      when Hash
+        object.keys.each do |key|
+          value = object.delete(key)
+          object[yield(key)] = deep_transform_keys!(value) { |key| yield(key) }
+        end
+        object
+      when Array
+        object.map! { |e| deep_transform_keys!(e) { |key| yield(key) } }
+      else
+        object
+      end
+    end
+
+    def to_snake_case(word, opts={})
+      string = word.to_s.dup
+      return string.downcase if string.match(/\A[A-Z]+\z/)
+      string.gsub!(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+      string.gsub!(/([a-z])([A-Z])/, '\1_\2')
+      string.gsub!('-', '_') if opts[:replace_dashes]
+      string.downcase
+    end
+
+    def to_camel_case(word, opts={})
+      string = word.to_s
+      return string if string.match(/[A-Z]|[a-z]([A-Z0-9]*[a-z][a-z0-9]*[A-Z]|[a-z0-9]*[A-Z][A-Z0-9]*[a-z])[A-Za-z0-9]*/)
+      string = word.to_s.split('_').collect(&:capitalize).join
+      string.gsub!(/^\w{1}/) { |word| word.downcase } if opts[:lower]
+      return string
+    end
+
+  end
+end

data/lib/fitbit_api/sleep.rb

@@ -0,0 +1,36 @@
+module FitbitAPI
+  class Client
+    SLEEP_RESOURCES = %w(startTime timeInBed minutesAsleep awakeningsCount
+                         minutesAwake minutesToFallAsleep minutesAfterWakeup efficiency)
+
+    def sleep_logs(date=Date.today, opts={})
+      get("user/#{user_id}/sleep/date/#{format_date(date)}.json", opts)
+    end
+
+    def sleep_time_series(resource, opts={})
+      start_date = opts[:start_date]
+      end_date   = opts[:end_date] || Date.today
+      period     = opts[:period]
+
+      unless SLEEP_RESOURCES.include?(resource)
+        raise FitbitAPI::InvalidArgumentError, "Invalid resource: \"#{resource}\". Please provide one of the following: #{SLEEP_RESOURCES}."
+      end
+
+      if [period, start_date].none?
+        raise FitbitAPI::InvalidArgumentError, 'A start_date or period is required.'
+      end
+
+      if period && !PERIODS.include?(period)
+        raise FitbitAPI::InvalidArgumentError, "Invalid period: \"#{period}\". Please provide one of the following: #{PERIODS}."
+      end
+
+      if period
+        result = get("user/#{user_id}/activities/#{resource}/date/#{format_date(end_date)}/#{period}.json", opts)
+      else
+        result = get("user/#{user_id}/activities/#{resource}/date/#{format_date(start_date)}/#{format_date(end_date)}.json", opts)
+      end
+      # remove root key from response
+      result.values[0]
+    end
+  end
+end

data/lib/fitbit_api/user.rb

@@ -0,0 +1,15 @@
+module FitbitAPI
+  class Client
+    def profile(opts={})
+      get("user/#{user_id}/profile.json", opts)
+    end
+
+    def badges(opts={})
+      get("user/#{user_id}/badges.json", opts)
+    end
+
+    def update_profile(opts)
+      post("user/#{user_id}/profile.json", opts)
+    end
+  end
+end

data/lib/fitbit_api/version.rb

@@ -0,0 +1,4 @@
+module FitbitAPI
+  VERSION = '0.8.0'
+  REPO_URL = 'https://github.com/zokioki/fitbit_api'
+end

data/lib/fitbit_api/water.rb

@@ -0,0 +1,7 @@
+module FitbitAPI
+  class Client
+    def water_logs(date=Date.today, opts={})
+      get("user/#{user_id}/foods/log/water/date/#{format_date(date)}.json", opts)
+    end
+  end
+end

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification
+name: fitbit_api
+version: !ruby/object:Gem::Version
+  version: 0.8.0
+platform: ruby
+authors:
+- Zoran
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-09-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- fitbit_api.gemspec
+- lib/fitbit_api.rb
+- lib/fitbit_api/activities.rb
+- lib/fitbit_api/alarms.rb
+- lib/fitbit_api/base.rb
+- lib/fitbit_api/body.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/helpers/configuration.rb
+- lib/fitbit_api/helpers/exceptions.rb
+- lib/fitbit_api/helpers/utils.rb
+- lib/fitbit_api/sleep.rb
+- lib/fitbit_api/user.rb
+- lib/fitbit_api/version.rb
+- lib/fitbit_api/water.rb
+homepage: https://github.com/zokioki/fitbit_api
+licenses:
+- MIT
+metadata: {}
+post_install_message: "\n    The fitbit_api gem has been renamed to fitbit_api and
+  will no longer be supported.\n    Please switch to using fitbit_api for all versions
+  greater than 0.7.1.\n  "
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: A Ruby interface to the Fitbit API, using OAuth2 (renamed to fitbit_api)
+test_files: []