basis-band 0.0.0

data/README.md

@@ -0,0 +1,31 @@
+# Basis API Access Gem
+
+This is extremely alpha quality, based on the existing PHP example at
+[https://github.com/btroia/basis-data-export](https://github.com/btroia/basis-data-export).
+That example includes instructions for finding your userid.
+
+The command line tool here does just a one-day dump of the JSON data raw. Pass
+it your userid and a date, and it'll spit back the raw data on stdout. For
+instance to dump my data for Oct 14th, 2013 (of course, xxxxx represents my 
+userid, but I'm not posting that):
+
+```
+> miker $ basis-band xxxxxxxxxxxxxxxxxxxxxxxx 2013-10-14
+```
+
+Or if you want to pretty print and paginate:
+
+```
+> miker $ basis-band xxxxxxxxxxxxxxxxxxxxxxxx 2013-10-14 | python -mjson.tool | more
+{
+    "bodystates": [
+        [
+            1381816740,
+            1381842000,
+            "sleep"
+...
+...
+```
+
+Just pushing up what I have so far, this is really meant to be a way to export to
+CSV eventually so I can use this data in spreadsheets. To be done.

data/bin/basis-band

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+
+require 'basis-band'
+require 'optparse'
+
+def samples_to_csv(samples)
+  lines = []
+  cols = samples.first.keys
+  lines << cols.join(',')
+  samples.each do |s|
+    lines << cols.map{|c| s[c]}.join(",")
+  end
+  lines
+end
+
+options = {}
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: basis-band [options]"
+  opts.on("-u", "--userid [USERID]", "User ID from mybasis.com") do |u|
+    options[:userid] = u
+  end
+  opts.on("-d", "--date [DATE]", "Date to fetch from mybasis.com") do |d|
+    options[:date] = d
+  end
+  opts.on("-c", "--[no-]csv", "Output CSV format") do |c|
+    options[:csv] = c
+  end
+end.parse!
+
+if options[:userid] and options[:date]
+  b = BasisBand.new(options[:userid])
+  raw = b.data_for_day(options[:date])
+else
+  raw = $stdin.read
+end
+
+if options[:csv]
+  m = ApiResponseModel.new(raw)
+  lines = samples_to_csv(m.samples_by_minute)
+  puts lines.join("\n")
+else
+  puts raw
+end

data/lib/basis-band.rb

@@ -0,0 +1,13 @@
+require 'basis-band/api-fetch'
+require 'basis-band/api-response-model'
+
+class BasisBand
+  def initialize(userid)
+    @userid = userid
+  end
+
+  def data_for_day(date)
+    f = ApiFetch.new()
+    f.get_day(@userid, date)
+  end
+end

data/lib/basis-band/api-fetch.rb

@@ -0,0 +1,47 @@
+require 'uri'
+require 'net/https'
+
+class ApiFetch
+  @@metrics = [:heartrate, :steps, :calories, :gsr, :skin_temp, :air_temp]
+
+  def flag_value(name, bool)
+    if bool
+      "#{name}=true"
+    else
+      "#{name}=false"
+    end
+  end
+
+  def filter_params(date, summary, body_states)
+    p = ['interval=60', 'units=s', "start_date=#{date}", 'start_offset=0', 'end_offset=0']
+    p << flag_value('summary', summary)
+    p << flag_value('bodystates', body_states)
+    p.join('&')
+  end
+
+  def metric_params(skip)
+    @@metrics.collect { |m|
+      flag_value(m.id2name, !skip.include?(m))
+    }.join("&")
+  end
+
+  def url(userid, date, summary, body_states, skip_metrics)
+    f = filter_params(date, summary, body_states)
+    m = metric_params(skip_metrics)
+    "https://app.mybasis.com/api/v1/chart/#{userid}.json?#{f}&#{m}"
+  end
+
+  def https_fetch(url)
+    u = URI.parse(url)
+    http = Net::HTTP.new(u.host, u.port)
+    http.use_ssl = true
+    http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+    request = Net::HTTP::Get.new(u.request_uri)
+    http.request(request).body
+  end
+
+  def get_day(userid, date, summary = true, body_states = true, skip_metrics = [])
+    res = https_fetch(url(userid, date, summary, body_states, skip_metrics))
+    res
+  end
+end

data/lib/basis-band/api-response-model.rb

@@ -0,0 +1,30 @@
+require 'time'
+require 'json'
+
+class ApiResponseModel
+  def initialize(raw_text)
+    @json = JSON.parse(raw_text)
+    # Use the local timezone intentionally
+    @starttime = Time.at(@json['starttime'])
+  end
+
+  def hash_for_minute(min)
+    t = @starttime + (min * 60)
+    res = {'t' => t.strftime("%Y/%m/%d %H:%M:%S")}
+    for m in @json["metrics"].keys
+      res[m] = @json["metrics"][m]["values"][min]
+    end
+    res
+  end
+
+  def num_samples
+    m = @json["metrics"].keys.first
+    @json["metrics"][m]["values"].length
+  end
+
+  def samples_by_minute
+    (0...num_samples).map { |x|
+      hash_for_minute(x)
+    }
+  end
+end

data/lib/basis-band/version.rb

@@ -0,0 +1,3 @@
+module BasisBand
+  VERSION = '0.0.0'
+end

data/test/test_api-fetch.rb

@@ -0,0 +1,32 @@
+require 'test/unit'
+require 'basis-band'
+
+class ApiFetchTest < Test::Unit::TestCase
+  def setup
+    @f = ApiFetch.new()
+  end
+
+  def test_defaults_url
+    url = @f.url('123user456', '1999-12-30', true, true, [])
+    assert url.include?('start_date=1999-12-30')
+    assert url.include?('summary=true')
+    assert url.include?('bodystates=true')
+  end
+
+  def test_filter_url
+    url = @f.url('123user456', '1999-12-30', true, false, [])
+    assert url.include?('summary=true')
+    assert url.include?('bodystates=false')
+  end
+
+  def test_metrics_url
+    url = @f.url('123user456', '1999-12-30', true, false, [:skin_temp, :steps])
+    assert url.include?('heartrate=true')
+    assert url.include?('steps=false')
+    assert url.include?('calories=true')
+    assert url.include?('gsr=true')
+    assert url.include?('skin_temp=false')
+    assert url.include?('air_temp=true')
+  end
+end
+

data/test/test_api-response-model.rb

@@ -0,0 +1,17 @@
+require 'test/unit'
+require 'basis-band'
+
+class ApiResponseModelTest < Test::Unit::TestCase
+  def test_defaults_url
+    test_fn = File.expand_path('../2013-10-01.json', __FILE__)
+    raw = File.read(test_fn)
+    m = ApiResponseModel.new(raw)
+    minutes = m.samples_by_minute
+    assert minutes.length == 1440
+    min_first = minutes.first
+    assert min_first["air_temp"] == 80.6
+    min_last = minutes.last
+    assert min_last["air_temp"] == 81.5
+  end
+end
+

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: basis-band
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Mike Rowehl
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A library and collection for tools for exporting monitoring data from
+  the website for the Basis B1 Band device. See http://mybasis.com
+email: mikerowehl@gmail.com
+executables:
+- basis-band
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/basis-band/api-fetch.rb
+- lib/basis-band/api-response-model.rb
+- lib/basis-band/version.rb
+- lib/basis-band.rb
+- bin/basis-band
+- README.md
+- test/test_api-fetch.rb
+- test/test_api-response-model.rb
+homepage: http://github.com/mikerowehl/basis-band
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Provides access to data from mybasis.com
+test_files:
+- test/test_api-fetch.rb
+- test/test_api-response-model.rb