dexcom 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d280d55dcaebe7390a8c9abfa96f778d011030120b485bc63b6043a8095f179
-  data.tar.gz: 839a8c2d15504a7d6de4853285d5b8b0f01de3bb6c453f917d964930ea59765e
+  metadata.gz: 318075e2340168e9bdb2f21b974cfd3a434c0726396223938a614fb790d75d6e
+  data.tar.gz: d24bb4a72533377a0964616efca955920d10817e315be455f544efdec49487cc
 SHA512:
-  metadata.gz: 298d575a9935df69443b1d420a719cb2188bfa1c26ab7eff85c963f05ad7877e346f139289a641eab3d5aaf0f7c591edd92947085d8e4110ad548a0eb21fc115
-  data.tar.gz: a716d140828a40330c9c9f80f65380b66458c2c6fe9d2307e9433b973ab68e490b519f9ac7f593897f5b445fc10aed97878740eb9db32e09ab36dbf6e7dca2da
+  metadata.gz: 9ee214af2ee0be1ec1c2447a6834141d7ddcf1d0c49cd93555c8b40d7436dfeca725146da8fe58a3cb768c1c63e5bc9ceb133894a89c98337c62cdab95c140cc
+  data.tar.gz: a59ba85426354dce6fbd3d100f69bc53e2570a136f35b39c1ea9bd03791185a5d0aafdbc53ef97533ba4d9466ab2ccde6c9fe2246a9c3aefe4e2e1254bd86999

data/Gemfile.lock

@@ -1,7 +1,8 @@
 PATH
   remote: .
   specs:
-    dexcom (0.2.1)
+    dexcom (0.3.0)
+      activesupport
       httparty
 
 GEM
@@ -53,6 +54,7 @@ GEM
     rspec-support (3.9.3)
     safe_yaml (1.0.5)
     thread_safe (0.3.6)
+    timecop (0.9.1)
     tzinfo (1.2.5)
       thread_safe (~> 0.1)
     webmock (3.8.3)
@@ -70,6 +72,7 @@ DEPENDENCIES
   factory_bot
   pry
   rspec
+  timecop
   webmock
 
 BUNDLED WITH

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/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
@@ -14,19 +17,23 @@ module Dexcom
         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/version.rb

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

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: dexcom
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Alex Gascon
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-13 00:00:00.000000000 Z
+date: 2021-05-06 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
@@ -149,7 +177,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubyforge_project: 
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Gem to interact with Dexcom Share API