dexcom 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d92f8ee13e26400f77410fae6493272443160c5b0127a3707803441bdc9ac3ca
-  data.tar.gz: fc1ab6d1dcf9ef7830621422fa6e24900a3274745ea6844e7b3e8901ec7920b1
+  metadata.gz: a9fd13bc624d95fe72f20fb528eade9fc3240282f052450a18a81070d6b2c18f
+  data.tar.gz: 0fad9ab7130a00684ffc57bf4daebf6ef2bf50892437bb93590f755a20111575
 SHA512:
-  metadata.gz: aa6c3c86b3cf48bd6fae4d68c2eed1c7b44999d6e0f69282ce3742bbe7379d46c2e5f3b1696b92a2729a3fa7febedc0b072a1d93945ef186bc8b19f273589b4d
-  data.tar.gz: 807626594715076c8ad214156e3117a97eea810afa1b5feb4b182e6b7bb43c176ae8cc6f0a1e8d9d140e92dd12c49cd0ebeb7a18596fc83e25dc7d0bd7b1e9da
+  metadata.gz: 68ae42721d0b56cf18fb3d1b202f244702f5aa38e8da23c6747ed5ebe5b058093fb56197e35bbd975bfc2061d8ac2c2d223a4bb10f36e038812b4fa6693200d4
+  data.tar.gz: f6155dad0b5fb77910260612f6a386481e38885210dccf87291c56c602b2b8a837494a674daf4e9563fdcada49d3ea71098cb2cb0204bdde66e957f3647211b2

data/.circleci/config.yml

@@ -0,0 +1,50 @@
+version: 2.1
+orbs:
+    ruby: circleci/ruby@0.1.2
+
+common: &common
+    steps:
+        - checkout
+        - run:
+            name: Configure Bundler
+            command: |
+                echo 'export BUNDLER_VERSION=$(cat Gemfile.lock | tail -1 | tr -d " ")' >> $BASH_ENV
+                source $BASH_ENV
+                gem install bundler
+        - restore_cache:
+            keys:
+                - v1-dep-bundle-{{ checksum "Gemfile.lock" }}-{{ .Environment.CIRCLE_JOB }}
+        - run:
+            name: Install dependencies
+            command: |
+                bundle install --jobs=4 --retry=3 --path vendor/bundle
+        - save_cache:
+            key: v1-dep-bundle-{{ checksum "Gemfile.lock" }}-{{ .Environment.CIRCLE_JOB }}
+            paths:
+                - vendor/bundle
+        - run:
+            name: Run tests
+            command: |
+                bundle exec rspec --color --format documentation --format progress spec
+
+
+jobs:
+    "ruby-26":
+        <<: *common
+        docker:
+            - image: circleci/ruby:2.6
+    "ruby-27":
+        <<: *common
+        docker:
+            - image: ruby:2.7
+    "ruby-30":
+        <<: *common
+        docker:
+            - image: ruby:3.0
+workflows:
+    version: 2.1
+    build:
+        jobs:
+            - "ruby-26"
+            - "ruby-27"
+            - "ruby-30"

data/Gemfile

@@ -1,4 +1,3 @@
-source :rubygems
+source 'https://rubygems.org'
 
 gemspec
-

data/Gemfile.lock

@@ -1,64 +1,67 @@
 PATH
   remote: .
   specs:
-    dexcom (0.1.0)
+    dexcom (0.3.1)
+      activesupport
       httparty
 
 GEM
-  remote: http://rubygems.org/
+  remote: https://rubygems.org/
   specs:
-    activesupport (5.2.3)
+    activesupport (6.1.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-    addressable (2.7.0)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
-    climate_control (0.2.0)
+    climate_control (1.0.1)
     coderay (1.1.3)
-    concurrent-ruby (1.1.5)
-    crack (0.4.3)
-      safe_yaml (~> 1.0.0)
-    diff-lcs (1.3)
-    factory_bot (5.0.2)
-      activesupport (>= 4.2.0)
+    concurrent-ruby (1.1.9)
+    crack (0.4.5)
+      rexml
+    diff-lcs (1.4.4)
+    factory_bot (6.2.0)
+      activesupport (>= 5.0.0)
     hashdiff (1.0.1)
-    httparty (0.18.0)
+    httparty (0.18.1)
       mime-types (~> 3.0)
       multi_xml (>= 0.5.2)
-    i18n (1.6.0)
+    i18n (1.8.10)
       concurrent-ruby (~> 1.0)
     method_source (1.0.0)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2020.0512)
-    minitest (5.11.3)
+    mime-types-data (3.2021.0704)
+    minitest (5.14.4)
     multi_xml (0.6.0)
     pry (0.13.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (4.0.5)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
+    public_suffix (4.0.6)
+    rexml (3.2.5)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-    safe_yaml (1.0.5)
-    thread_safe (0.3.6)
-    tzinfo (1.2.5)
-      thread_safe (~> 0.1)
-    webmock (3.8.3)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    timecop (0.9.1)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    webmock (3.13.0)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
@@ -70,7 +73,8 @@ DEPENDENCIES
   factory_bot
   pry
   rspec
+  timecop
   webmock
 
 BUNDLED WITH
-   2.0.2
+   2.2.21

data/README.md

@@ -1,2 +1,108 @@
 # dexcom-ruby
-Gem to interact with Dexcom Share API, enabling real-time retrieval of glucose data
+[Imgur](https://i.imgur.com/HZdC1fH.png?1)
+[![Gem Version](https://badge.fury.io/rb/dexcom.svg)](https://rubygems.org/gems/dexcom) [![AlexGascon](https://circleci.com/gh/AlexGascon/dexcom-ruby.svg?style=svg)](https://app.circleci.com/pipelines/github/AlexGascon/dexcom-ruby)
+
+## Introduction
+`dexcom-ruby` allows you to easily interact with Dexcom Share APIs, enabling real-time retrieval of glucose data on your application
+
+## Install
+You can install the gem via Rubygems:
+
+```
+gem install dexcom
+```
+
+## Configuration
+The gem can be easily configured via the `configure` method:
+
+```ruby
+Dexcom.configure do |config|
+  config.username = 'my_username'
+  config.password = 'my_password'
+  config.outside_usa = true
+end
+```
+
+There are three available parameters to configure:
+* `username`: The username of your Dexcom account
+* `password`: The password of your Dexcom account
+* `outside_usa`: Boolean indicating if the account that you want to access is not an American one
+
+## Usage
+You can retrieve the last blood glucose reading from Dexcom using the method `Dexcom::BloodGlucose.last`
+
+```
+bg = Dexcom::BloodGlucose.last
+=> #<Dexcom::BloodGlucose:0x0000555c19959000
+ @timestamp=Sun, 21 Jun 2020 11:23:05 +0000,
+ @trend=4,
+ @value=147>
+```
+
+It will return a `Dexcom::BloodGlucose` object, which has the following fields:
+
+* `value`: The blood glucose value in mg/dL
+* `timestamp`: The instant when this reading was registered
+* `trend`: Number representing the type of progression of the latest readings. You can get a human-readable version using `trend_description` and its symbol using `trend_symbol`.
+* `mg_dl`: Alias to `value`
+* `mmol`: Blood glucose value in mmol/L
+
+```
+bg.timestamp
+=> Sun, 21 Jun 2020 11:23:05 +0000
+
+bg.trend_description
+=> "Steady"
+
+bg.trend_symbol
+=> "→"
+
+bg.mg_dl
+=> 147
+
+bg.mmol
+=> 8.2
+```
+
+Additionally, if you prefer to retrieve a range of values instead of only the last one, you can use the `.get_last` method. You can specify either the number of values that you want or how many minutes in the past you want to search for
+
+```
+Dexcom::BloodGlucose.get_last(max_count: 5)
+=> [#<Dexcom::BloodGlucose:0x0000555c19d7b7c8
+  @timestamp=Sun, 21 Jun 2020 11:23:05 +0000,
+  @trend=4,
+  @value=147>,
+ #<Dexcom::BloodGlucose:0x0000555c19d7b660
+  @timestamp=Sun, 21 Jun 2020 11:18:06 +0000,
+  @trend=4,
+  @value=148>,
+ #<Dexcom::BloodGlucose:0x0000555c19d7b4d0
+  @timestamp=Sun, 21 Jun 2020 11:13:06 +0000,
+  @trend=4,
+  @value=147>,
+ #<Dexcom::BloodGlucose:0x0000555c19d7b390
+  @timestamp=Sun, 21 Jun 2020 11:08:06 +0000,
+  @trend=4,
+  @value=148>,
+ #<Dexcom::BloodGlucose:0x0000555c19d7b138
+  @timestamp=Sun, 21 Jun 2020 11:03:06 +0000,
+  @trend=4,
+  @value=149>]
+
+
+Dexcom::BloodGluocse.get_last(minutes: 15)
+=> [#<Dexcom::BloodGlucose:0x0000555c19d7b7c8
+  @timestamp=Sun, 21 Jun 2020 11:23:05 +0000,
+  @trend=4,
+  @value=147>,
+ #<Dexcom::BloodGlucose:0x0000555c19d7b660
+  @timestamp=Sun, 21 Jun 2020 11:18:06 +0000,
+  @trend=4,
+  @value=148>,
+ #<Dexcom::BloodGlucose:0x0000555c19d7b4d0
+  @timestamp=Sun, 21 Jun 2020 11:13:06 +0000,
+  @trend=4,
+  @value=147>]
+```
+
+**NOTE:** You can retrieve data up to 1440 minutes (24 hours) in the past. Even if `minutes` is greater than 1440, or if you specify a `max_count` greater than the number of blood glucose values registered in the last 24 hours, you will only get data for that period

data/dexcom.gemspec

@@ -21,6 +21,7 @@ Gem::Specification.new do |spec|
   spec.executables    = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths  = ['lib']
 
+  spec.add_dependency 'activesupport'
   spec.add_dependency 'httparty'
 
   spec.add_development_dependency 'bundler'
@@ -28,5 +29,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'factory_bot'
   spec.add_development_dependency 'pry'
   spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'timecop'
   spec.add_development_dependency 'webmock'
 end

data/lib/dexcom.rb

@@ -6,14 +6,4 @@ require 'dexcom/configuration'
 require 'dexcom/constants'
 require 'dexcom/version'
 
-module Dexcom
-  class << self
-    def configuration
-      @configuration ||= Configuration.new
-    end
-
-    def configure
-      yield configuration
-    end
-  end
-end
+module Dexcom; end

data/lib/dexcom/authentication.rb

@@ -1,9 +1,11 @@
 # frozen_string_literal: true
 
-require 'httparty'
+require 'utils/httparty_configured'
 
 module Dexcom
   class Authentication
+    include ::Utils::HTTPartyConfigured
+
     class << self
       def access_token
         refresh_access_token if @access_token.nil?

data/lib/dexcom/blood_glucose/api_handler.rb

@@ -1,8 +1,12 @@
 # frozen_string_literal: true
 
+require 'utils/httparty_configured'
+
 module Dexcom
   module BloodGlucoseUtils
     module ApiHandler
+      include ::Utils::HTTPartyConfigured
+
       MAX_MINUTES = 1440
 
       def make_api_request(number_of_values)
@@ -42,7 +46,8 @@ module Dexcom
       def query(max_count)
         {
           maxCount: max_count,
-          minutes: MAX_MINUTES
+          minutes: MAX_MINUTES,
+          sessionId: Dexcom::Authentication.session_id
         }
       end
 
@@ -50,9 +55,8 @@ module Dexcom
         timestamp_info = blood_glucose_response_item['WT']
         timestamp_regex = /(\d+)000/
         timestamp = timestamp_info[timestamp_regex, 1]
-        utc = '+00:00'
 
-        DateTime.parse(Time.at(timestamp.to_i, in: utc).to_s)
+        DateTime.strptime(timestamp, '%s')
       end
 
       def config

data/lib/dexcom/blood_glucose/class_methods.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal
 
+require 'active_support'
+require 'active_support/core_ext'
+
 module Dexcom
   module BloodGlucoseUtils
     module ClassMethods
@@ -7,26 +10,30 @@ module Dexcom
       MINUTES_PER_DATAPOINT = 5
 
       def last
-        get_last(max_count: 1)
+        get_last(max_count: 1).first
       end
 
       def get_last(max_count: nil, minutes: nil)
         number_of_values = calculate_number_of_values(max_count, minutes)
 
         response = make_api_request(number_of_values)
-        process_api_response(response)
+        blood_glucose_values = process_api_response(response)
+
+        if minutes.present?
+          blood_glucose_values.select! { |bg| bg.timestamp >= minutes.minutes.ago }
+        end
+
+        blood_glucose_values
       end
 
       private
 
       def calculate_number_of_values(max_count, minutes)
-        if minutes.nil?
-          max_count || DEFAULT_NUMBER_OF_VALUES
-        elsif max_count.nil?
-          minutes / MINUTES_PER_DATAPOINT
-        else
-          [max_count, minutes / MINUTES_PER_DATAPOINT].min
-        end
+        return DEFAULT_NUMBER_OF_VALUES if (minutes.nil? && max_count.nil?)
+        return max_count if minutes.nil?
+        return (minutes / MINUTES_PER_DATAPOINT) if max_count.nil?
+
+        [max_count, minutes / MINUTES_PER_DATAPOINT].min
       end
     end
   end

data/lib/dexcom/configuration.rb

@@ -2,16 +2,37 @@
 
 module Dexcom
   class Configuration
-    attr_accessor :username, :password, :outside_usa
+    attr_accessor :username, :password, :outside_usa, :logger, :log_level
+
+    DEFAULT_LOGGER = nil
+    DEFAULT_LOGGER_LEVEL = :info
 
     def initialize
       @username = nil
       @password = nil
       @outside_usa = nil
+      @logger = DEFAULT_LOGGER
+      @log_level = DEFAULT_LOGGER_LEVEL
     end
 
     def base_url
       outside_usa ? URL_BASE_OUTSIDE_USA : URL_BASE
     end
   end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configuration=(config)
+      raise StandardError('Invalid configuration provided') unless config.is_a? Dexcom::Configuration
+
+      @configuration = config
+    end
+
+    def configure
+      yield configuration
+    end
+  end
 end

data/lib/dexcom/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dexcom
-  VERSION = '0.2.0'
+  VERSION = '0.3.1'
 end

data/lib/utils/httparty_configured.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'httparty'
+
+require 'dexcom/configuration'
+
+module Utils
+  module HTTPartyConfigured
+    include HTTParty
+
+    config = Dexcom.configuration
+
+    unless config.logger.nil?
+      logger config.logger, config.log_level, :apache
+      debug_output config.logger if config.log_level == :debug
+    end
+  end
+end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: dexcom
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Alex Gascon
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-06-13 00:00:00.000000000 Z
+date: 2021-07-31 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: httparty
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +108,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  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'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -108,12 +136,13 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description:
 email: alexgascon.93@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".circleci/config.yml"
 - ".gitignore"
 - ".rspec"
 - Gemfile
@@ -129,11 +158,12 @@ files:
 - lib/dexcom/configuration.rb
 - lib/dexcom/constants.rb
 - lib/dexcom/version.rb
-homepage: 
+- lib/utils/httparty_configured.rb
+homepage:
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -148,8 +178,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: Gem to interact with Dexcom Share API
 test_files: []