exist 0.1.0.beta.2

data/lib/exist/insight_list.rb

@@ -0,0 +1,11 @@
+module Exist
+  class InsightList < Hashie::Mash
+    include Hashie::Extensions::Coercion
+
+    coerce_key :insights, Array[Insight]
+
+    def size
+      insights.size
+    end
+  end
+end

data/lib/exist/user.rb

@@ -0,0 +1,8 @@
+module Exist
+  class User < Hashie::Mash
+    include Hashie::Extensions::Coercion
+
+    coerce_key :local_time, ->(v) { Time.parse(v) }
+    coerce_key :attributes, Array[Exist::Attributes]
+  end
+end

data/lib/exist/version.rb

@@ -0,0 +1,3 @@
+module Exist
+  VERSION = "0.1.0.beta.2"
+end

data/spec/exist/api_spec.rb

@@ -0,0 +1,238 @@
+require 'spec_helper'
+
+RSpec.describe Exist::API do
+  context "initialization" do
+    let(:token) { 'SOMETOKEN' }
+
+    it 'initializes with a token' do
+      client = described_class.new(token: token)
+      expect(client.api_key).to eq(token)
+    end
+
+    it 'reads the token from environment if not given' do
+      ENV['EXIST_API_TOKEN'] = token
+      client = described_class.new
+      expect(client.api_key).to eq(token)
+    end
+
+    it 'raises an error if no token present' do
+      ENV.delete('EXIST_API_TOKEN')
+
+      expect {
+        described_class.new
+      }.to raise_error(ArgumentError)
+    end
+
+    it 'negotiates a token if username and password are provided' do
+      stub_request(:post, api_root + '/auth/simple-token').to_return(
+        body:    { token: token                        }.to_json,
+        headers: { 'Content-Type' => 'application/json'}
+      )
+
+      client = described_class.new(username: 'some', password: 'pass')
+      expect(client.api_key).to be_truthy
+    end
+
+    it 'raises an error if fails to login' do
+      stub_request(:post, api_root + '/auth/simple-token').to_return(
+        status: 401
+      )
+      expect {
+        described_class.new(username: 'john', password: 'doe')
+      }.to raise_error(/There was a problem authenticating with the API/)
+    end
+  end
+
+  context 'API' do
+    let(:client) { described_class.new(token: 'SOME') }
+
+    describe '#me' do
+      let(:user) { client.me }
+
+      before do
+        stub_request_with_fixture(:get, '/users/$self/', :user_stripped)
+      end
+
+      it 'returns the current user' do
+        expect(user.id).to eq(1)
+        expect(user.local_time).to be_kind_of(Time)
+      end
+    end
+
+    describe '#overview' do
+      let(:overview) { client.overview }
+
+      before do
+        stub_request_with_fixture(:get, '/users/$self/today/', :overview)
+      end
+
+      it 'returns the overview for the current user' do
+        expect(overview.username).to eq('josh')
+      end
+
+      it 'coerces keys' do
+        expect(overview.local_time).to be_kind_of(Time)
+        expect(overview.private).to eq(false)
+      end
+
+      it 'contains attributes' do
+        expect(overview.attributes.first.group).to eq('steps')
+        expect(overview.attributes.first.items.size).to eq(2)
+        expect(overview.attributes.first.items.first.value).to eq(258)
+      end
+    end
+
+    describe '#attributes' do
+      let(:attributes) { client.attributes }
+
+      before do
+        stub_request_with_fixture(:get, '/users/$self/attributes/?limit=31', :attributes)
+      end
+
+      it 'returns the attributes for the current user' do
+        expect(attributes).to be
+      end
+
+      it 'wraps into an attribute list' do
+        expect(attributes).to be_kind_of(Exist::AttributeList)
+        expect(attributes.size).to eq(2)
+      end
+
+      it 'coerces values' do
+        pending
+        expect(attributes.first.values.first.date).to be_kind_of(Date)
+      end
+    end
+
+    describe '#attribute' do
+      let(:attribute) { client.attribute(:steps) }
+
+      before do
+        stub_request_with_fixture(
+          :get, '/users/$self/attributes/steps/?date_max=&date_min=&limit=31&page=1',
+          :specific_attribute
+        )
+      end
+
+      it 'returns a specific attribute' do
+        expect(attribute.attributes).to be
+      end
+
+      it 'wraps into an attribute list' do
+        expect(attribute.total).to eq(655)
+        expect(attribute.size).to eq(7)
+      end
+    end
+
+    describe '#insights' do
+      let(:insights) { client.insights }
+
+      before do
+        stub_request_with_fixture(
+          :get, '/users/$self/insights/?date_max=&date_min=&limit=31&page=1',
+          :insights
+        )
+      end
+
+      it 'returns the user insights' do
+        expect(insights.insights).to be
+      end
+
+      it 'wraps inside an insight list' do
+        expect(insights.total).to eq(740)
+        expect(insights.size).to eq(2)
+      end
+    end
+
+    describe '#insights_for_attribute' do
+      let(:insights) { client.insights_for_attribute(:sleep) }
+
+      before do
+        stub_request_with_fixture(
+          :get, '/users/$self/insights/attribute/sleep/?date_max=&date_min=&limit=31&page=1',
+          :insights_for_specific_attribute
+        )
+      end
+
+      it 'returns the specific attribute insights' do
+        expect(insights.insights).to be
+      end
+
+      it 'wrap in an insights list' do
+        expect(insights.size).to eq(1)
+        expect(insights.total).to eq(220)
+      end
+    end
+
+    describe '#averages' do
+      let(:averages) { client.averages }
+
+      before do
+        stub_request_with_fixture(:get, '/users/$self/averages/', :averages)
+      end
+
+      it 'returns the current averages' do
+        expect(averages.averages).to be
+      end
+
+      it 'wraps in an average list' do
+        expect(averages.size).to eq(2)
+      end
+    end
+
+    describe '#average_for_attribute' do
+      let(:average) { client.average_for_attribute(:steps) }
+
+      before do
+        stub_request_with_fixture(
+          :get, '/users/$self/averages/attribute/steps/?date_max=&date_min=&limit=31&page=1',
+          :average_for_specific_attribute
+        )
+      end
+
+      it 'returns the average for an specific attribute' do
+        expect(average.averages).to be
+      end
+
+      it 'wraps in an average list' do
+        expect(average.size).to eq(2)
+      end
+    end
+
+    describe '#correlations' do
+      let(:correlations) { client.correlations(:$self, :steps) }
+
+      before do
+        stub_request_with_fixture(
+          :get, '/users/$self/correlations/attribute/steps/?date_max=&date_min=&limit=31&page=1',
+          :correlations
+        )
+      end
+
+      it 'returns the correlations for an attribute' do
+        expect(correlations.correlations).to be
+      end
+
+      it 'wraps in a correlation list' do
+        expect(correlations.total).to eq(479)
+        expect(correlations.size).to eq(2)
+      end
+
+      context 'when specifying latest_only' do
+        before do
+          stub_request(
+            :get,
+            api_root + '/users/$self/correlations/attribute/steps/?latest_only=true&limit=31&page=1'
+          ).to_return(
+            body: {}.to_json,
+            headers: { 'Content-Type' => 'application/json'}
+          )
+        end
+
+        it 'returns only the latest correlations, avoiding date ranges' do
+          client.correlations(:$self, :steps, latest_only: true)
+        end
+      end
+    end
+  end
+end

data/spec/exist_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+RSpec.describe Exist do
+  it "specifies the version" do
+    expect(subject.const_get('VERSION')).to_not be_empty
+  end
+end

data/spec/fixtures/attributes.json

@@ -0,0 +1,47 @@
+[
+    {
+        "attribute": "steps",
+        "label": "Steps",
+        "group": "activity",
+        "service": "Fitbit",
+        "private": false,
+        "values": [
+            {
+                "value": 331,
+                "date": "2014-08-01"
+            },
+            {
+                "value": 5872,
+                "date": "2014-07-31"
+            },
+            {
+                "value": 2832,
+                "date": "2014-07-30"
+            },
+            {
+                "value": 5153,
+                "date": "2014-07-29"
+            },
+            {
+                "value": 4354,
+                "date": "2014-07-28"
+            },
+            {
+                "value": 7132,
+                "date": "2014-07-27"
+            },
+            {
+                "value": 4144,
+                "date": "2014-07-26"
+            }
+        ]
+    },
+    {
+        "attribute": "floors",
+        "label": "Floors",
+        "group": "activity",
+        "service": "Fitbit",
+        "private": false,
+        "values": [ ]
+    }
+]

data/spec/fixtures/average_for_specific_attribute.json

@@ -0,0 +1,31 @@
+{
+    "count": 11,
+    "next": null,
+    "previous": null,
+    "results": [
+        {
+            "attribute": "steps",
+            "date": "2020-04-29",
+            "overall": 4174.0,
+            "monday": 4057.0,
+            "tuesday": 6614.0,
+            "wednesday": 4001.0,
+            "thursday": 3923.0,
+            "friday": 4528.0,
+            "saturday": 3649.0,
+            "sunday": 3904.0
+        },
+        {
+            "attribute": "steps",
+            "date": "2020-03-30",
+            "overall": 4062.0,
+            "monday": 4057.0,
+            "tuesday": 6618.0,
+            "wednesday": 3610.0,
+            "thursday": 3923.0,
+            "friday": 4063.0,
+            "saturday": 3636.0,
+            "sunday": 3904.0
+        }
+    ]
+}

data/spec/fixtures/averages.json

@@ -0,0 +1,26 @@
+[
+    {
+        "attribute": "steps",
+        "date": "2020-04-29",
+        "overall": 4174.0,
+        "monday": 4057.0,
+        "tuesday": 6614.0,
+        "wednesday": 4001.0,
+        "thursday": 3923.0,
+        "friday": 4528.0,
+        "saturday": 3649.0,
+        "sunday": 3904.0
+    },
+    {
+        "attribute": "floors",
+        "date": "2020-04-29",
+        "overall": 13.0,
+        "monday": 13.0,
+        "tuesday": 16.0,
+        "wednesday": 14.0,
+        "thursday": 12.0,
+        "friday": 14.0,
+        "saturday": 13.0,
+        "sunday": 12.0
+    }
+]

data/spec/fixtures/correlations.json

@@ -0,0 +1,27 @@
+{
+    "count": 479,
+    "next": "https://exist.io/api/1/users/josh/correlations/attribute/steps/?page=2",
+    "previous": null,
+    "results": [
+        {
+            "date": "2015-05-11",
+            "period": 90,
+            "attribute": "steps",
+            "attribute2": "steps_distance",
+            "value": 0.999735821732415,
+            "p": 5.43055953485446e-146,
+            "first_person": "I am almost certain (100%) to travel a further distance on days I take more steps.",
+            "second_person": "You are almost certain (100%) to travel a further distance on days you take more steps."
+        },
+        {
+            "date": "2015-05-11",
+            "period": 90,
+            "attribute": "steps",
+            "attribute2": "floors",
+            "value": 0.693332839316818,
+            "p": 3.63477333939521e-14,
+            "first_person": "I am much more likely (69%) to climb floors on days I take more steps.",
+            "second_person": "You are much more likely (69%) to climb floors on days you take more steps."
+        }
+    ]
+}

data/spec/fixtures/insights.json

@@ -0,0 +1,51 @@
+{
+    "count": 740,
+    "next": "https://exist.io/api/1/users/josh/insights/?page=2",
+    "previous": null,
+    "results": [
+        {
+            "created": "2015-05-09T01:00:02Z",
+            "target_date": "2015-05-08",
+            "html": "<div class=\"secondary\">Friday night: Shortest sleep for 3 days</div>...",
+            "value": "303",
+            "value2": "3 days",
+            "comment": null,
+            "type": {
+                "name": "sleep_worst_since_x",
+                "period": 1,
+                "priority": 2,
+                "attribute": {
+                    "name": "sleep",
+                    "label": "Time asleep",
+                    "group": {
+                        "name": "sleep",
+                        "priority": 3
+                    },
+                    "priority": 2
+                }
+            }
+        },
+        {
+            "created": "2015-05-08T21:00:03Z",
+            "target_date": null,
+            "html": "<div class=\"number\">09:38</div>...",
+            "value": "578",
+            "value2": "65 min earlier",
+            "comment": null,
+            "type": {
+                "name": "sleep_end_average_week",
+                "period": 7,
+                "priority": 3,
+                "attribute": {
+                    "name": "sleep_end",
+                    "label": "Wake time",
+                    "group": {
+                        "name": "sleep",
+                        "priority": 3
+                    },
+                    "priority": 4
+                }
+            }
+        }
+    ]
+}