silver_mother 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ea61ac5c02969e7b8258501fbe2a54ff25185993
+  data.tar.gz: a6331dc774f99fb5274164ffeb592f54d0b83c22
+SHA512:
+  metadata.gz: 16fc121ae5ae3ce7dfdb43639b7363d2426de9f68500e4645c13805616f170cae3c72c589b3881810007caf6a036da939ba05c3996e95b40a1ac014f52ba4972
+  data.tar.gz: 669369ebf8a8c52cee0e4829ec2689379ba44902a23005ce7f710f8599d157718f9503aa7fe2e340ff6f13a394aaa565da99439db4b505e637ad3602a6a0a82b

data/.gitignore

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

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,29 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2016-12-14 15:40:09 -0700 using RuboCop version 0.46.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 9
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/silver_mother/api.rb'
+    - 'lib/silver_mother/application.rb'
+    - 'lib/silver_mother/event.rb'
+    - 'lib/silver_mother/feed.rb'
+    - 'lib/silver_mother/node.rb'
+    - 'lib/silver_mother/person.rb'
+    - 'lib/silver_mother/subscription.rb'
+    - 'lib/silver_mother/user.rb'
+    - 'lib/silver_mother/utils.rb'
+
+# Offense count: 23
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+# SupportedStyles: when_needed, always
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.3.1

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.12.5

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Mark Kreyman
+
+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,357 @@
+# SilverMother API
+
+A ruby library for communicating with the SilverMother REST API (https://sen.se/developers/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'silver_mother'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install silver_mother
+
+
+## Usage
+
+### Authorizing your app
+
+```ruby
+app_params = { gateway_url: 'http://your_app_domain/notification/',
+               redirect_url: 'http://your_app_domain/oauth/',
+               oauth2_client_id: 'your-client-id',
+               oauth2_client_secret: 'your-client-secret',
+               scope: 'profile+feeds.read' }
+
+# see https://sen.se/developers/documentation/ for a list of available scopes;
+# it appears that you could only use two scopes at a time.
+
+app = SilverMother::Application.new(app_params)
+```
+
+Then construct authorization url for your user
+
+```ruby
+app.authorization_url
+```
+
+After following the URL the user would be directed to a Sen.se auth page, and then redirected to your `redirect_url`, with an auth code as `code` parameter, i.e.
+
+```ruby
+http://your_app_domain/oauth/?code=2zykyywQ5bcGAVzMbLUjW4hJSqm4rO
+
+app.get_token('2zykyywQ5bcGAVzMbLUjW4hJSqm4rO')
+```
+
+**NOTE: You only have 60 secs to retrieve your access token with that code. If you’re getting an “invalid grant” error, it means that the given authorization code has expired already.**
+
+The `app.token` object would now have the following attributes:
+
+ * access_token
+ * token_type
+ * expires_in
+ * refresh_token
+ * scope
+ * expires_on (gets calculated based on `expires_in` and the current time)
+
+
+```ruby
+token = app.token.access_token
+```
+
+It appears that the access token is valid for 1 year. Use the `refresh_token` method to retrieve a new access token:
+
+```ruby
+app.refresh_token(app.token.refresh_token)
+```
+
+And now you have an updated `app.token` object
+
+```ruby
+token = app.token.access_token
+```
+
+### Events
+
+```ruby
+events_api = SilverMother::Event.instance
+events_api.call(token)
+feeds = events_api.feeds
+nodes = events_api.nodes
+node_uids = events_api.node_uids
+feed_uids = events_api.feed_uids
+
+params = {
+            uid:   'n3TQUtzAp3c67BYOUsIuMAwgWe7i0r3A',
+            type:  'notification',
+            limit: 5,   # limit the number of results, default is 10
+            secs:  3600 # ttl for returned results, default is 300
+          }
+```
+
+Possible types appear to be:
+
+ * 'alert'
+ * 'battery'
+ * 'medication'
+ * 'motion'
+ * 'notification'
+ * 'presence'
+ * 'status'
+ * 'temperature'
+ * 'tile'
+
+**NOTE:** you can only specify 'type' for node UIDs. An example of a params hash for a feed uid:
+
+ ```ruby
+params = {
+            uid:   'GS5vq3D3MvqUZmBqRQoQY9Av4KRgHPvs',
+            limit: 5,   # limit the number of results, default is 10
+            secs:  3600 # ttl for returned results, default is 300
+          }
+```
+
+```ruby
+events = events_api.events(params)
+```
+
+If you need to work with a particular event:
+
+```ruby
+event = events[0]
+```
+
+Attributes/methods now available for the `event` object:
+
+ * data
+ * dateEvent
+ * dateServer
+ * expiresAt
+ * feedUid
+ * gatewayNodeUid
+ * geometry
+ * nodeUid
+ * payload
+ * profile
+ * signal
+ * type
+ * version
+
+Some attributes might, in turn, be objects or arrays of objects that
+you could further explore, i.e.
+
+```ruby
+events.first.data.body
+events.first.geometry.coordinates
+```
+
+### Feeds
+
+```ruby
+feeds_api = SilverMother::Feed.instance
+feeds_api.call(token)
+feeds = feeds_api.feeds
+uids = feeds_api.uids
+```
+
+To get a feed (or feeds) for a particular uid:
+
+```ruby
+feed = feeds_api.feed(uid)
+```
+
+Attributes/methods now available for the `feed` object:
+
+ * uid
+ * eventsModel
+ * eventsUrl
+ * label
+ * node
+ * object
+ * type
+ * url
+ * used
+
+Some attributes are objects or arrays of objects that you could further explore, i.e.
+
+```ruby
+feed.eventsModel.geometry
+```
+
+### Nodes
+
+```ruby
+nodes_api = SilverMother::Node.instance
+nodes_api.call(token)
+nodes = nodes_api.nodes
+uids = nodes_api.uids
+```
+
+`nodes` is an array of node objects that you could iterate over. i.e.
+
+```ruby
+node = nodes.first
+```
+
+Attributes/methods now available for the `node` object:
+
+ * uid
+ * label
+ * url
+ * resource
+ * token
+ * object
+ * geometry
+ * createdAt
+ * updatedAt
+ * paused
+ * subscribes
+ * publishes
+
+Some attributes are, in turn, objects or arrays of objects that you could further explore, i.e.
+
+```ruby
+node.resource.type
+node.publishes[0].url
+```
+
+There's another way to get a node, assuming you've run `nodes_api.uids`, in order to get a list of uids:
+
+```ruby
+node = nodes_api.node(uid)
+```
+
+To get feed(s) for a uid:
+
+```ruby
+feed = nodes_api.feed(uid)
+```
+
+### Persons
+
+```ruby
+persons_api = SilverMother::Person.instance
+persons_api.call(token)
+persons = persons_api.persons
+person = persons.first
+```
+
+Attributes/methods now available for the `person` object:
+
+ * uid
+ * avatarUrl
+ * email
+ * firstName
+ * lastName
+ * gender
+ * object
+ * phoneNumber
+
+### Subscriptions
+
+```ruby
+subscriptions_api = SilverMother::Subscription.instance
+subscriptions_api.call(token)
+subscriptions = subscriptions_api.subscriptions
+subscription = subscriptions.first
+```
+
+Attributes/methods now available for the `subscription` object:
+
+ * uid
+ * createdAt
+ * updatedAt
+ * gatewayUrl
+ * geometry
+ * label
+ * object
+ * paused
+ * publishes
+ * resource
+ * subscribes
+ * url
+
+Some attributes might, in turn, be objects or arrays of objects that you could explore further, i.e.
+
+```ruby
+subscription.subscribes[0].type
+```
+
+### User
+
+```ruby
+users_api = SilverMother::User.instance
+users_api.call(token)
+user = users_api.user
+```
+
+Attributes/methods now available for the `user` object:
+
+ * uid
+ * email
+ * language
+ * object
+ * timezone
+ * country
+ * username
+ * subscriptions
+ * applications
+ * createdAt
+ * updatedAt
+ * is_developer
+ * firstName
+ * lastName
+ * devices
+ * persons
+
+Some attributes might be objects or arrays of objects that you could  explore further, i.e.
+
+```ruby
+user.subscriptions[0].uid
+user.applications.first.label
+user.devices.last.url
+user.persons[1].firstName
+```
+
+### Making API requests not covered by the current version of the gem
+
+```ruby
+silver_mother_api = SilverMother::Api.instance
+
+silver_mother_api.get(token, path, params = {})
+silver_mother_api.post(token, path, params = {})
+silver_mother_api.put(token, path, params = {})
+silver_mother_api.delete(token, path, params = {})
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+* Fork the project.
+* Run `bundle`
+* Run `bundle exec rake`
+* Create your feature branch (`git checkout -b my-new-feature`)
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Run `bundle exec rake` again.
+* Run `rubocop .`
+* Commit your changes. (`git commit -am 'Add some feature'`). Please do not mess with rakefile, version, or history.
+* Push to the branch. (`git push origin my-new-feature`)
+* Create a new Pull Request.
+
+## License
+
+The 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/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'silver_mother'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require 'pry'
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/silver_mother/api.rb

@@ -0,0 +1,64 @@
+require 'httparty'
+require 'singleton'
+
+module SilverMother
+  class Api
+    include Singleton
+    include HTTParty
+
+    # Uncomment for debugging
+    # debug_output
+
+    def get(path, token, params = {})
+      result = HTTParty.get(SENSE_API_URL + path,
+                            add_auth_header(params, token))
+
+      log_request(path, params, result)
+      result
+    end
+
+    def post(path, token, params = {})
+      result = HTTParty.post(SENSE_API_URL + path,
+                             add_auth_header(params, token))
+
+      log_request(path, params, result)
+      result
+    end
+
+    def put(path, token, params = {})
+      result = HTTParty.put(SENSE_API_URL + path,
+                            add_auth_header(params, token))
+
+      log_request(path, params, result)
+      result
+    end
+
+    def delete(path, token, params = {})
+      result = HTTParty.delete(SENSE_API_URL + path,
+                               add_auth_header(params, token))
+
+      log_request(path, params, result)
+      result
+    end
+
+    private
+
+    def add_auth_header(params, token = false)
+      params[:headers] ||= {}
+      params[:headers]['Authorization'] = "Bearer #{token}" if token
+      params
+    end
+
+    def log_request(path, params, result)
+      Utils.instance.log_request(path, params, result)
+    end
+  end
+end
+
+HTTParty::Response.class_eval do
+  def to_ostruct
+    JSON.parse(to_json, object_class: OpenStruct)
+  rescue JSON::ParserError
+    JSON.parse(self, object_class: OpenStruct)
+  end
+end

data/lib/silver_mother/application.rb

@@ -0,0 +1,104 @@
+module SilverMother
+  class Application
+    SENSE_URL      = 'https://sen.se/api/v2/'.freeze
+    RESPONSE_TYPE  = 'code'.freeze
+    GRANT_TYPES    = { access: 'authorization_code',
+                       refresh: 'refresh_token' }.freeze
+
+    DEFAULTS_PATHS = { authorization_path: 'oauth2/authorize/',
+                       token_path:         'oauth2/token/',
+                       refresh_path:       'oauth2/refresh/' }.freeze
+
+    attr_accessor :gateway_url,
+                  :redirect_url,
+                  :oauth2_client_id,
+                  :oauth2_client_secret,
+                  :scope,
+                  :token
+
+    def initialize(params = {})
+      @gateway_url          = params.fetch(:gateway_url)
+      @redirect_url         = params.fetch(:redirect_url)
+      @oauth2_client_id     = params.fetch(:oauth2_client_id)
+      @oauth2_client_secret = params.fetch(:oauth2_client_secret)
+      @scope                = params.fetch(:scope)
+    end
+
+    def authorization_url
+      url_params = { client_id:     @oauth2_client_id,
+                     scope:         @scope,
+                     redirect_uri:  html_encode(@redirect_url),
+                     response_type: RESPONSE_TYPE }
+                   .map { |k, v| "#{k}=#{v}" }.join('&')
+
+      SENSE_URL + DEFAULTS_PATHS[:authorization_path] + '?' + url_params
+    end
+
+    def get_token(auth_code)
+      @token = Api.instance
+                  .post(DEFAULTS_PATHS[:token_path],
+                        nil,
+                        url_encoded_params(auth_code, :access))
+                  .to_ostruct
+
+      @token.expires_on = ttl(@token.expires_in)
+      @token
+    end
+
+    def refresh_token(refresh_token)
+      @token = Api.instance
+                  .post(DEFAULTS_PATHS[:refresh_path],
+                        nil,
+                        url_encoded_params(refresh_token, :refresh))
+                  .to_ostruct
+
+      @token.expires_on = ttl(@token.expires_in)
+      @token
+    end
+
+    def expired?
+      Time.now.to_i > @token.expires_on.to_i
+    end
+
+    private
+
+    def url_encoded_params(code, grant_type)
+      case grant_type
+      when :access
+        params = params_for_access(code)
+      when :refresh
+        params = params_for_refresh(code)
+      else
+        raise 'Unsupported grant type'
+      end
+
+      { body: url_encode(params),
+        headers: { 'Content-Type' => 'application/x-www-form-urlencoded' } }
+    end
+
+    def ttl(secs)
+      Time.now.to_i + secs.to_i
+    end
+
+    def html_encode(url)
+      CGI.escape(url)
+    end
+
+    def url_encode(params)
+      params.map { |k, v| "#{k}=#{v}" }.join('&')
+    end
+
+    def params_for_access(code)
+      { client_id:     @oauth2_client_id,
+        client_secret: @oauth2_client_secret,
+        code:          code,
+        redirect_uri:  html_encode(@redirect_url),
+        grant_type:    GRANT_TYPES[:access] }
+    end
+
+    def params_for_refresh(code)
+      { refresh_token: code,
+        grant_type: GRANT_TYPES[:refresh] }
+    end
+  end
+end

data/lib/silver_mother/event.rb

@@ -0,0 +1,78 @@
+require 'singleton'
+
+module SilverMother
+  class Event
+    include Singleton
+
+    attr_accessor :token
+    attr_reader :feeds,
+                :feed_uids,
+                :nodes,
+                :node_uids,
+                :event_cache,
+                :ttls
+
+    def call(token)
+      @token     = token
+      @feeds_api = SilverMother::Feed.instance
+      @feeds_api.call(@token)
+      @nodes_api = SilverMother::Node.instance
+      @nodes_api.call(@token)
+    end
+
+    def feeds
+      @feeds ||= @feeds_api.feeds
+    end
+
+    def feed_uids
+      @feed_uids ||= @feeds_api.uids
+    end
+
+    def nodes
+      @nodes ||= @nodes_api.nodes
+    end
+
+    def node_uids
+      @node_uids ||= @nodes_api.uids
+    end
+
+    def events(uid, type = nil)
+      @event_cache ||= {}
+      @ttls ||= {}
+      clear_cache(uid) if expired?(@ttls[uid])
+      @ttls[uid] ||= ttl(TTL)
+      @event_cache[uid] ||= Api.instance
+                               .get(path(uid, type), @token)
+                               .to_ostruct
+                               .objects
+    end
+
+    def clear_cache!
+      @event_cache = {}
+      @ttls        = {}
+    end
+
+    private
+
+    def path(uid, type = nil)
+      if type
+        "nodes/#{uid}/feeds/#{type}/events/?limit=#{NUM_OF_RESULTS}"
+      else
+        "feeds/#{uid}/events/?limit=#{NUM_OF_RESULTS}"
+      end
+    end
+
+    def ttl(secs)
+      Time.now.to_i + secs.to_i
+    end
+
+    def expired?(ttl)
+      Time.now.to_i > ttl.to_i
+    end
+
+    def clear_cache(uid)
+      @event_cache.delete(uid)
+      @ttls.delete(uid)
+    end
+  end
+end

data/lib/silver_mother/feed.rb

@@ -0,0 +1,60 @@
+require 'singleton'
+
+module SilverMother
+  class Feed
+    include Singleton
+
+    FEEDS_PATH = 'feeds/'.freeze
+
+    attr_reader :feeds_raw, :feeds, :uids, :feed_cache
+
+    def call(token)
+      @token = token
+      @feeds_raw = []
+      @response = Api.instance.get(FEEDS_PATH, @token)
+      @feeds_raw << @response
+      while next_page
+        new_path = FEEDS_PATH + next_page_number
+        @response = Api.instance.get(new_path, @token)
+        @feeds_raw << @response
+      end
+    end
+
+    def feeds
+      @feeds ||= @feeds_raw.each_with_object([]) do |feed, array|
+        array << feed.to_ostruct.objects
+      end.flatten
+    end
+
+    def uids
+      @uids ||= @feeds_raw.each_with_object([]) do |feed, array|
+        feed.to_ostruct.objects.each do |object|
+          array << { uid: object.uid, type: object.type }
+        end
+      end
+    end
+
+    def feed(uid)
+      feed_path = FEEDS_PATH + uid + '/'
+      @feed_cache ||= {}
+      @feed_cache[uid] ||= Api.instance.get(feed_path, @token).to_ostruct
+    end
+
+    def clear_cache!
+      @feeds_raw  = []
+      @feeds      = []
+      @uids       = []
+      @feed_cache = {}
+    end
+
+    private
+
+    def next_page
+      @response.parsed_response['links']['next'] if @response
+    end
+
+    def next_page_number
+      @response.parsed_response['links']['next'].split('/').last if next_page
+    end
+  end
+end

data/lib/silver_mother/node.rb

@@ -0,0 +1,71 @@
+require 'singleton'
+
+module SilverMother
+  class Node
+    include Singleton
+
+    NODES_PATH = 'nodes/'.freeze
+
+    attr_reader :nodes_raw, :nodes, :uids, :node_cache, :uid_cache
+
+    def call(token)
+      @token = token
+      @nodes_raw = []
+      @response = Api.instance.get(NODES_PATH, @token)
+      @nodes_raw << @response
+      while next_page
+        new_path = NODES_PATH + next_page_number
+        @response = Api.instance.get(new_path, @token)
+        @nodes_raw << @response
+      end
+    end
+
+    def nodes
+      @nodes ||= @nodes_raw.each_with_object([]) do |node, array|
+        array << node.to_ostruct.objects
+      end.flatten
+    end
+
+    def uids
+      @uids ||= @nodes_raw.each_with_object([]) do |node, array|
+        node.to_ostruct.objects.each do |object|
+          array << { uid: object.uid,
+                     object: object.object,
+                     label: object.label,
+                     type: object.type,
+                     slug: object.slug }
+        end
+      end
+    end
+
+    def node(uid)
+      uid_path = NODES_PATH + uid + '/'
+      @node_cache ||= {}
+      @node_cache[uid] ||= Api.instance.get(uid_path, @token).to_ostruct
+    end
+
+    def feed(uid)
+      feed_path = NODES_PATH + uid + '/feeds/'
+      @feed_cache ||= {}
+      @feed_cache[uid] ||= Api.instance.get(feed_path, @token).to_ostruct
+    end
+
+    def clear_cache!
+      @nodes_raw  = []
+      @nodes      = []
+      @uids       = []
+      @node_cache = {}
+      @feed_cache = {}
+    end
+
+    private
+
+    def next_page
+      @response.parsed_response['links']['next'] if @response
+    end
+
+    def next_page_number
+      @response.parsed_response['links']['next'].split('/').last if next_page
+    end
+  end
+end

data/lib/silver_mother/person.rb

@@ -0,0 +1,44 @@
+require 'singleton'
+
+module SilverMother
+  class Person
+    include Singleton
+
+    PERSONS_PATH = 'persons/'.freeze
+
+    attr_reader :persons_raw, :persons
+
+    def call(token)
+      @token = token
+      @persons_raw = []
+      @response = Api.instance.get(PERSONS_PATH, @token)
+      @persons_raw << @response
+      while next_page
+        new_path = PERSONS_PATH + next_page_number
+        @response = Api.instance.get(new_path, @token)
+        @persons_raw << @response
+      end
+    end
+
+    def persons
+      @persons ||= @persons_raw.each_with_object([]) do |person, array|
+        array << person.to_ostruct.objects
+      end.flatten
+    end
+
+    def clear_cache!
+      @persons_raw = []
+      @persons     = []
+    end
+
+    private
+
+    def next_page
+      @response.parsed_response['links']['next'] if @response
+    end
+
+    def next_page_number
+      @response.parsed_response['links']['next'].split('/').last if next_page
+    end
+  end
+end

data/lib/silver_mother/subscription.rb

@@ -0,0 +1,44 @@
+require 'singleton'
+
+module SilverMother
+  class Subscription
+    include Singleton
+
+    SUBS_PATH = 'subscriptions/'.freeze
+
+    attr_reader :subscriptions_raw, :subscriptions
+
+    def call(token)
+      @token = token
+      @subscriptions_raw = []
+      @response = Api.instance.get(SUBS_PATH, @token)
+      @subscriptions_raw << @response
+      while next_page
+        new_path = SUBS_PATH + next_page_number
+        @response = Api.instance.get(new_path, @token)
+        @subscriptions_raw << @response
+      end
+    end
+
+    def subscriptions
+      @subscriptions ||= @subscriptions_raw.each_with_object([]) do |sub, arr|
+        arr << sub.to_ostruct.objects
+      end.flatten
+    end
+
+    def clear_cache!
+      @subscriptions_raw = []
+      @subscriptions     = []
+    end
+
+    private
+
+    def next_page
+      @response.parsed_response['links']['next'] if @response
+    end
+
+    def next_page_number
+      @response.parsed_response['links']['next'].split('/').last if next_page
+    end
+  end
+end

data/lib/silver_mother/user.rb

@@ -0,0 +1,15 @@
+require 'singleton'
+
+module SilverMother
+  class User
+    include Singleton
+
+    USER_PATH = 'user/'.freeze
+
+    attr_reader :user
+
+    def call(token)
+      @user ||= Api.instance.get(USER_PATH, token).to_ostruct
+    end
+  end
+end

data/lib/silver_mother/utils.rb

@@ -0,0 +1,23 @@
+require 'singleton'
+require 'logger'
+
+module SilverMother
+  class Utils
+    include Singleton
+
+    def logger
+      @logger ||= (defined?(Rails) ? Rails.logger : ::Logger.new(STDOUT))
+    end
+
+    def log_request(path, params, result)
+      log_message = <<-LOG_MESSAGE
+        \n
+        SENSE PATH: #{SENSE_API_URL}#{path}
+        SENSE PARAMS: #{params.inspect}
+        SENSE RESPONSE: #{result.success? && result.parsed_response.inspect}
+      LOG_MESSAGE
+
+      logger.debug(log_message) unless ENV['RACK_ENV'] == 'test'
+    end
+  end
+end

data/lib/silver_mother/version.rb

@@ -0,0 +1,3 @@
+module SilverMother
+  VERSION = '0.0.1'.freeze
+end

data/lib/silver_mother.rb

@@ -0,0 +1,14 @@
+require 'silver_mother/version'
+require 'silver_mother/utils'
+require 'silver_mother/api'
+require 'silver_mother/user'
+require 'silver_mother/node'
+require 'silver_mother/feed'
+require 'silver_mother/subscription'
+require 'silver_mother/person'
+require 'silver_mother/event'
+require 'silver_mother/application'
+
+SENSE_API_URL = 'https://apis.sen.se/v2/'.freeze
+NUM_OF_RESULTS = 10
+TTL = 300

data/silver_mother.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'silver_mother/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'silver_mother'
+  spec.version       = SilverMother::VERSION
+  spec.authors       = ['Mark Kreyman']
+  spec.email         = ['mark@kreyman.com']
+
+  spec.summary       = 'A library for communicating with the SilverMother API.'
+  spec.description   = 'A ruby library for communicating with the SilverMother \
+                        REST API. Register your application at \
+                        https://sen.se/developers/'
+
+  spec.homepage      = 'https://github.com/mkreyman/silver_mother'
+  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.add_development_dependency 'bundler', '~> 1.13.6'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'webmock'
+
+  spec.add_dependency 'httparty', '~> 0.14.0'
+end

metadata

@@ -0,0 +1,140 @@
+--- !ruby/object:Gem::Specification
+name: silver_mother
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Mark Kreyman
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-12-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.13.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.13.6
+- !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: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+description: |-
+  A ruby library for communicating with the SilverMother \
+                          REST API. Register your application at \
+                          https://sen.se/developers/
+email:
+- mark@kreyman.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/silver_mother.rb
+- lib/silver_mother/api.rb
+- lib/silver_mother/application.rb
+- lib/silver_mother/event.rb
+- lib/silver_mother/feed.rb
+- lib/silver_mother/node.rb
+- lib/silver_mother/person.rb
+- lib/silver_mother/subscription.rb
+- lib/silver_mother/user.rb
+- lib/silver_mother/utils.rb
+- lib/silver_mother/version.rb
+- silver_mother.gemspec
+homepage: https://github.com/mkreyman/silver_mother
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: A library for communicating with the SilverMother API.
+test_files: []