helium-ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 652e7ae9d3dda85ecf853683b0e83a1abcd0746a
+  data.tar.gz: 38302545f4d2b850bc17afb890ba0efd16e6de92
+SHA512:
+  metadata.gz: cf23c7d0f425d9106b54337aba35006cd95ad4a8ac89eb3ef776a2780ba0f46dfba63d68866e651600187c56d6c07e64ac1f7a78b6a0947d66c76f9da826f4a3
+  data.tar.gz: ed941a33a010e4b567b39083ecca5a140a18bc9825632215135831cf66a956d8df63e6c4fe76efc24f00f32e8a5edd9cdf156b23b3fadd5d0037951740d5bdee

data/.gitignore

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

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,17 @@
+sudo: false
+language: ruby
+cache: bundler
+
+rvm:
+  - 2.3.1
+
+before_install: gem install bundler -v 1.12.5
+
+script: 'bundle exec rake'
+
+notifications:
+  email:
+    recipients:
+      - allenan@helium.com
+    on_failure: change
+    on_success: never

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at allenan@helium.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,11 @@
+guard 'rspec', cmd: "bundle exec rspec" do
+  # watch /lib/ files
+  watch(%r{^lib/(.+).rb$}) do |m|
+    "spec"
+  end
+
+  # watch /spec/ files
+  watch(%r{^spec/(.+).rb$}) do |m|
+    "spec/#{m[1]}.rb"
+  end
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Andrew Allen
+
+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,184 @@
+# helium-ruby
+
+[![Build Status](https://travis-ci.org/helium/helium-ruby.svg?branch=master)](https://travis-ci.org/helium/helium-ruby)
+[![Coverage Status](https://coveralls.io/repos/github/helium/helium-ruby/badge.svg?branch=master)](https://coveralls.io/github/helium/helium-ruby?branch=master)
+[![Code Climate](https://codeclimate.com/github/helium/helium-ruby/badges/gpa.svg)](https://codeclimate.com/github/helium/helium-ruby)
+
+A Ruby gem for building applications with the Helium API. [Helium](https://www.helium.com/) is an integrated platform of smart sensors, communication, edge and cloud compute that enables numerous sensing applications. For more information about the underlying REST API, check out [the Helium docs](https://docs.helium.com/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'helium-ruby'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install helium-ruby
+
+## Usage
+
+### Setup
+
+```ruby
+require 'helium'
+
+client = Helium::Client.new(api_key: '<Your API Key>')
+```
+
+### Users
+
+```ruby
+client.user
+# => #<Helium::User:0x007fd58198d9e8 @id="dev-accounts@helium.co", @name="HeliumDevAccount Demo", @email="dev-accounts@helium.co", @created_at="2014-10-29T21:38:52Z", @updated_at="2015-08-06T18:21:32.186374Z">
+```
+
+### Organizations
+
+#### Get the current organization
+
+```ruby
+client.organization
+# => #<Helium::Organization:0x007fd3d94b1b08 @client=<Helium::Client @debug=true>, @id="dev-accounts@helium.co", @name="dev-accounts@helium.co", @timezone="UTC", @created_at="2015-09-10T20:50:18.183896Z", @updated_at="2015-09-10T20:50:18.183896Z">
+```
+
+#### Get all users associated with the current organization
+
+```ruby
+client.organization.users
+# => [
+#   [0] #<Helium::User:0x007fd3d9449490 @client=<Helium::Client @debug=true>, @id="tom@helium.com", @name="Tom Santero", @email="tom@helium.com", @created_at="2015-01-21T16:39:31.397048Z", @updated_at="2015-02-12T20:42:22.674452Z">,
+#   [1] #<Helium::User:0x007fd3d94492d8 @client=<Helium::Client @debug=true>, @id="dev-accounts@helium.co", @name="HeliumDevAccount Demo", @email="dev-accounts@helium.co", @created_at="2014-10-29T21:38:52Z", @updated_at="2015-08-06T18:21:32.186374Z">
+# ]
+```
+
+### Sensors
+
+#### Get all Sensors
+```ruby
+client.sensors
+# => [#<Helium::Sensor:0x007f89acdd1318 @id="08bab58b-d095-4c7c-912c-1f8024d91d95", @name="Marc's Isotope", @mac="6081f9fffe00019b", @ports=["t", "b"], @created_at="2015-08-06T17:28:11.614107Z", @updated_at="2016-05-30T22:36:50.810716Z">, ...]
+```
+
+#### Get a Sensor by id
+```ruby
+client.sensor("08bab58b-d095-4c7c-912c-1f8024d91d95")
+# => #<Helium::Sensor:0x007f89acdb1b58 @id="08bab58b-d095-4c7c-912c-1f8024d91d95", @name="Marc's Isotope", @mac="6081f9fffe00019b", @ports=["t", "b"], @created_at="2015-08-06T17:28:11.614107Z", @updated_at="2016-05-30T22:36:50.810716Z">
+```
+
+### Timeseries
+
+#### Get Timeseries data for a sensor
+```ruby
+sensor = client.sensor("08bab58b-d095-4c7c-912c-1f8024d91d95")
+sensor.timeseries
+# => #<Helium::Timeseries:0x007ff9dd92efa8 @data_points=[#<Helium::DataPoint:0x007ff9dd92ee18 @id="a4107e78-f15e-4c31-aab3-497bbfe3e33c", @timestamp="2015-08-11T18:50:04Z", @value=-40.125, @port="t">, ...
+```
+
+#### Working with data points
+A `Helium::Timeseries` is a collection of `Helium::DataPoint`s which can be accessed by calling `.data_points`, or iterated over using the usual `Object#Enumerable` methods:
+
+```ruby
+sensor.timeseries.each do |data_point|
+  puts data_point.id
+  puts data_point.timestamp
+  puts data_point.value
+  puts data_point.port
+end
+```
+
+#### Filtering Timeseries data
+Timeseries data can be filtered by port type and start/end time:
+
+```ruby
+sensor.timeseries.collect(&:port).uniq
+# => [
+#  [0] "b",
+#  [1] "l",
+#  [2] "h",
+#  [3] "p",
+#  [4] "t",
+#  [5] "_se",
+#  [6] "m"
+# ]
+
+sensor.timeseries(port: 't').collect(&:port).uniq
+# => [
+#   [0] "t"
+# ]
+
+sensor.timeseries(start_time: DateTime.parse("2016-08-01"), end_time: DateTime.parse("2016-08-02")).collect(&:timestamp)
+# => [
+#  [0] #<DateTime: 2016-08-01T23:55:29+00:00 ((2457602j,86129s,802000000n),+0s,2299161j)>,
+#  [1] #<DateTime: 2016-08-01T23:55:29+00:00 ((2457602j,86129s,61000000n),+0s,2299161j)>,
+#  [2] #<DateTime: 2016-08-01T23:55:29+00:00 ((2457602j,86129s,60000000n),+0s,2299161j)>,
+#  [3] #<DateTime: 2016-08-01T23:55:29+00:00 ((2457602j,86129s,59000000n),+0s,2299161j)>,
+#  [4] #<DateTime: 2016-08-01T23:54:45+00:00 ((2457602j,86085s,544000000n),+0s,2299161j)>,
+```
+
+#### Paging through Timeseries data
+Timeseries data is paginated at the API level. By default, 1000 data points are returned. This amount can be increased up to 10,000:
+
+```ruby
+sensor.timeseries(size: 10_000).length
+# => 10000
+```
+
+The data points are sorted from most recent, to least recent. The `.previous` method on a `Helium::Timeseries` object will return a new `Helium::Timeseries` object with the next page of Timeseries data:
+
+```ruby
+timeseries = sensor.timeseries
+# => #<Helium::Timeseries:0x007ff9e10d2c48 @data_points=[#<Helium::DataPoint:0x007ff9e10d2568 @id="3595e562-c065-442e-a3af-c6f43ddb1500", @timestamp="2016-08-10T13:21:49.866Z", @value=27, @port="l">, ...
+
+timeseries.previous
+# => #<Helium::Timeseries:0x007ff9dc141008 @data_points=[#<Helium::DataPoint:0x007ff9dc140f68 @id="1e4062cf-361d-415e-8c05-cd04954424d1", @timestamp="2016-08-10T13:11:49.353Z", @value=99804.15, @port="p">, ...
+```
+
+If no previous data exists, the `.previous` method will return `false`.
+
+```ruby
+sensor.timeseries.previous
+# => false
+```
+
+
+## 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`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+### Roadmap
+- [ ] Timeseries Aggregations
+- [ ] POST/PUT/DELETE users, orgs, sensors, timeseries
+- [ ] Ports
+- [ ] Labels
+- [ ] Elements
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/helium/helium-ruby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+### Running specs with Guard
+
+To receive system notifications of test status, install `terminal-notifier`:
+```
+$ brew install terminal-notifier
+```
+
+Then run Guard with:
+```
+$ bundle exec guard
+```
+
+When you modify any of the files in `lib/`, all specs will run. When you modify a spec file, just that file will be run. You can press `Enter` at the guard prompt to run all tests as well.
+
+## 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,16 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "helium"
+
+class Object
+  API_KEY = ENV['HELIUM_API_KEY'].freeze
+
+  def client
+    return nil if API_KEY.nil?
+    @client ||= Helium::Client.new(api_key: API_KEY, debug: true)
+  end
+end
+
+require "pry"
+Pry.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/helium-ruby.gemspec

@@ -0,0 +1,43 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'helium/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "helium-ruby"
+  spec.version       = Helium::VERSION
+  spec.authors       = ["Andrew Allen"]
+  spec.email         = ["allenan@helium.com"]
+
+  spec.summary       = %q{A Ruby gem for building applications with the Helium API}
+  spec.description   = %q{A Ruby gem for building applications with the Helium API}
+  spec.homepage      = "https://github.com/helium/helium-ruby"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  end
+
+  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_dependency "typhoeus", "~> 1.1.0"
+
+  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "vcr", "~> 3.0.3"
+  spec.add_development_dependency "coveralls", "~> 0.8.2"
+  spec.add_development_dependency "pry", "~> 0.10.4"
+  spec.add_development_dependency "awesome_print", "~> 1.7.0"
+  spec.add_development_dependency "guard", "~> 2.14.0"
+  spec.add_development_dependency "guard-rspec", "~> 4.7.3"
+  spec.add_development_dependency "terminal-notifier-guard", "~> 1.7.0"
+  spec.add_development_dependency "simplecov", "~> 0.12.0"
+end

data/lib/helium.rb

@@ -0,0 +1,15 @@
+require 'typhoeus'
+require 'json'
+require 'date'
+
+require "helium/version"
+require "helium/utils"
+require "helium/client"
+require "helium/user"
+require "helium/organization"
+require "helium/sensor"
+require "helium/timeseries"
+require "helium/data_point"
+
+module Helium
+end

data/lib/helium/client.rb

@@ -0,0 +1,45 @@
+require 'helium/client/http'
+require 'helium/client/users'
+require 'helium/client/organizations'
+require 'helium/client/sensors'
+
+module Helium
+  class Client
+    include Helium::Utils
+    include Helium::Client::Http
+    include Helium::Client::Users
+    include Helium::Client::Organizations
+    include Helium::Client::Sensors
+
+    API_VERSION = 1
+    HOST        = 'api.helium.com'
+    PROTOCOL    = 'https'
+
+    BASE_HTTP_HEADERS = {
+      'Accept'        => 'application/json',
+      'Content-Type'  => 'application/json',
+      'User-Agent'    => 'helium-ruby'
+    }
+
+    attr_accessor :api_key
+
+    def initialize(api_key:, debug: false)
+      @api_key = api_key
+      @debug = debug
+    end
+
+    def inspect
+      "<Helium::Client @debug=#{@debug}>"
+    end
+
+    def debug?
+      @debug == true
+    end
+
+    def http_headers
+      BASE_HTTP_HEADERS.merge({
+        'Authorization' => api_key
+      })
+    end
+  end
+end

data/lib/helium/client/http.rb

@@ -0,0 +1,33 @@
+module Helium
+  class Client
+    module Http
+      def get(path = nil, url: nil, options: {})
+        path = path.gsub(/^\//, '') if path
+        url ||= "#{PROTOCOL}://#{HOST}/v#{API_VERSION}/#{path}"
+
+        request = Typhoeus::Request.new(url, {
+          params: options,
+          headers: http_headers
+        })
+
+        run(request)
+      end
+
+      private
+
+      def run(request)
+        request.run()
+
+        if debug?
+          puts "GET #{url} #{request.response.code} #{request.response.total_time}"
+          # puts request.response.body
+        end
+
+        # TODO error handling
+        # halt(request.response.code, "Helium Get Failed: #{request.response.code.to_s}") unless request.response.code.between?(200,399)\
+
+        return request.response
+      end
+    end
+  end
+end

data/lib/helium/client/organizations.rb

@@ -0,0 +1,22 @@
+module Helium
+  class Client
+    module Organizations
+      def organization
+        response = get('/organization')
+        org_data = JSON.parse(response.body)["data"]
+        return Organization.new(client: self, params: org_data)
+      end
+
+      def organization_users
+        response = get('/organization/user')
+        users_data = JSON.parse(response.body)["data"]
+
+        users = users_data.map do |user_data|
+          User.new(client: self, params: user_data)
+        end
+
+        return users
+      end
+    end
+  end
+end

data/lib/helium/client/sensors.rb

@@ -0,0 +1,56 @@
+module Helium
+  class Client
+    module Sensors
+      def sensors
+        response = get('/sensor')
+        sensors_data = JSON.parse(response.body)["data"]
+
+        sensors = sensors_data.map do |sensor_data|
+          Sensor.new(client: self, params: sensor_data)
+        end
+
+        return sensors
+      end
+
+      def sensor(id)
+        response = get("/sensor/#{id}")
+        sensor_data = JSON.parse(response.body)["data"]
+
+        return Sensor.new(client: self, params: sensor_data)
+      end
+
+      def sensor_timeseries(sensor, size: 1000, port: nil, start_time: nil, end_time: nil)
+        options = {
+          "page[size]" => size,
+          "filter[port]" => port,
+          "filter[start]" => datetime_to_iso(start_time),
+          "filter[end]" => datetime_to_iso(end_time)
+        }.delete_if { |key, value| value.to_s.empty? }
+
+        response = get("/sensor/#{sensor.id}/timeseries", options: options)
+        json_results = JSON.parse(response.body)
+        timeseries_data = json_results["data"]
+        timeseries_links = json_results["links"]
+
+        return Timeseries.new(
+          client: self,
+          params: timeseries_data,
+          links: timeseries_links
+        )
+      end
+
+      def sensor_timeseries_by_link(url)
+        response = get(url: url)
+        json_results = JSON.parse(response.body)
+        timeseries_data = json_results["data"]
+        timeseries_links = json_results["links"]
+
+        return Timeseries.new(
+          client: self,
+          params: timeseries_data,
+          links: timeseries_links
+        )
+      end
+    end
+  end
+end

data/lib/helium/client/users.rb

@@ -0,0 +1,11 @@
+module Helium
+  class Client
+    module Users
+      def user
+        response = get('/user')
+        user_data = JSON.parse(response.body)["data"]
+        return User.new(client: self, params: user_data)
+      end
+    end
+  end
+end

data/lib/helium/data_point.rb

@@ -0,0 +1,17 @@
+module Helium
+  class DataPoint
+    attr_accessor :id, :timestamp, :value, :port
+
+    def initialize(client:, params:)
+      @client     = client
+      @id         = params["id"]
+      @timestamp  = params["attributes"]["timestamp"]
+      @value      = params["attributes"]["value"]
+      @port       = params["attributes"]["port"]
+    end
+
+    def timestamp
+      DateTime.parse(@timestamp)
+    end
+  end
+end

data/lib/helium/organization.rb

@@ -0,0 +1,27 @@
+module Helium
+  class Organization
+    attr_accessor :id, :name, :timezone, :created_at, :updated_at
+
+    def initialize(client:, params:)
+      @client     = client
+      @id         = params["id"]
+      @name       = params["attributes"]["name"]
+      @timezone   = params["attributes"]["timezone"]
+      @created_at = params["meta"]["created"]
+      @updated_at = params["meta"]["updated"]
+    end
+
+    def created_at
+      DateTime.parse(@created_at)
+    end
+
+    def updated_at
+      DateTime.parse(@updated_at)
+    end
+
+    # TODO refactor into relationships
+    def users
+      @client.organization_users
+    end
+  end
+end

data/lib/helium/sensor.rb

@@ -0,0 +1,32 @@
+module Helium
+  class Sensor
+    attr_accessor :id, :name, :mac, :ports, :created_at, :updated_at
+
+    def initialize(client:, params:)
+      @client     = client
+      @id         = params["id"]
+      @name       = params["attributes"]["name"]
+      @mac        = params["meta"]["mac"]
+      @ports      = params["meta"]["ports"]
+      @created_at = params["meta"]["created"]
+      @updated_at = params["meta"]["updated"]
+    end
+
+    def created_at
+      DateTime.parse(@created_at)
+    end
+
+    def updated_at
+      DateTime.parse(@updated_at)
+    end
+
+    def timeseries(size: 1000, port: nil, start_time: nil, end_time: nil)
+      @client.sensor_timeseries(self,
+        size:       size,
+        port:       port,
+        start_time: start_time,
+        end_time:   end_time
+      )
+    end
+  end
+end

data/lib/helium/timeseries.rb

@@ -0,0 +1,27 @@
+module Helium
+  class Timeseries
+    include Enumerable
+    extend Forwardable
+
+    def_delegators :@data_points, :size, :length, :last
+
+    attr_accessor :data_points, :previous_link
+
+    def initialize(client:, params:, links:)
+      @client = client
+      @data_points = params.map { |data_point_params|
+        DataPoint.new(client: client, params: data_point_params)
+      }
+      @previous_link = links["prev"]
+    end
+
+    def each(&block)
+      @data_points.each(&block)
+    end
+
+    def previous
+      return false if @previous_link.nil?
+      @client.sensor_timeseries_by_link(@previous_link)
+    end
+  end
+end

data/lib/helium/user.rb

@@ -0,0 +1,22 @@
+module Helium
+  class User
+    attr_accessor :id, :name, :email, :created_at, :updated_at
+
+    def initialize(client:, params:)
+      @client     = client
+      @id         = params["id"]
+      @name       = params["attributes"]["name"]
+      @email      = params["meta"]["email"]
+      @created_at = params["meta"]["created"]
+      @updated_at = params["meta"]["updated"]
+    end
+
+    def created_at
+      DateTime.parse(@created_at)
+    end
+
+    def updated_at
+      DateTime.parse(@updated_at)
+    end
+  end
+end

data/lib/helium/utils.rb

@@ -0,0 +1,8 @@
+module Helium
+  module Utils
+    def datetime_to_iso(datetime)
+      return nil if datetime.nil?
+      Time.parse(datetime.to_s).utc.iso8601
+    end
+  end
+end

data/lib/helium/version.rb

@@ -0,0 +1,3 @@
+module Helium
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,238 @@
+--- !ruby/object:Gem::Specification
+name: helium-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andrew Allen
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-08-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !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: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.3
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.14.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.14.0
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.3
+- !ruby/object:Gem::Dependency
+  name: terminal-notifier-guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+description: A Ruby gem for building applications with the Helium API
+email:
+- allenan@helium.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- helium-ruby.gemspec
+- lib/helium.rb
+- lib/helium/client.rb
+- lib/helium/client/http.rb
+- lib/helium/client/organizations.rb
+- lib/helium/client/sensors.rb
+- lib/helium/client/users.rb
+- lib/helium/data_point.rb
+- lib/helium/organization.rb
+- lib/helium/sensor.rb
+- lib/helium/timeseries.rb
+- lib/helium/user.rb
+- lib/helium/utils.rb
+- lib/helium/version.rb
+homepage: https://github.com/helium/helium-ruby
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+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 Ruby gem for building applications with the Helium API
+test_files: []