nest_api 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fccd97bb052f88030e825f3f78fc43519a115d3e
+  data.tar.gz: 2f822a60663033710c3fe796ee01195264889411
+SHA512:
+  metadata.gz: fd5ee37688492a63a42fb7508e4dae078f233ceef1a0b28fca15d151ccaf8c706f51e5d8552749bcf45b828c838d4725bac3403901b95c6c3e5e99c8d7c64b7c
+  data.tar.gz: 6e07fa67383f1efa0c8d5523a5de150305020702ff39a86f63fdb5d383300d5335cf6474b179ad4e87005bbcdbaa7e946fe90d6078437a32e0cfc971da18060b

data/lib/nest_api/access_token.rb

@@ -0,0 +1,57 @@
+module NestApi
+  class AccessToken
+    def initialize(product_id, product_secret, file)
+      @product_id = product_id
+      @product_secret = product_secret
+      @file = file
+    end
+
+    def access_token
+      auth_code['access_token']
+    end
+
+    private
+
+    def auth_code
+      @auth_code ||= retrieve_credentials
+    end
+
+    # Initiate authorization process to obtain a nest access code
+    def authorize
+      # Prompt user for pin code -- must be retrieved from online
+      puts "Please generate a pin code at #{NestApi::AUTH_URL}#{@product_id} and enter it here:"
+      pin = gets.strip
+
+      result = HTTParty.post("#{NestApi::TOKEN_URL}", query: {
+          code: pin,
+          client_id: @product_id,
+          client_secret: @product_secret,
+          grant_type: 'authorization_code'
+        })
+
+      File.open(@file, "w") { |file| file.write(result.to_json) }
+
+      @auth_code = result
+    end
+
+    def configuration_error
+      raise ConfigurationError, "The config file is either empty or corrupt. Please remove #{@file} from the filesystem and reauthenticate."
+    end
+
+    # Read saved nest credentials from a file
+    def retrieve_credentials
+      @auth_code = JSON.parse(File.read(@file))
+
+      if @auth_code['access_token'].nil? || @auth_code['access_token'].empty?
+        configuration_error
+      end
+
+      @auth_code
+
+    rescue Errno::ENOENT
+      authorize
+    rescue JSON::ParserError
+      configuration_error
+    end
+  end
+end

data/lib/nest_api/api.rb

@@ -0,0 +1,24 @@
+module NestApi
+  class Api
+    def initialize(product_id: ENV.fetch("NEST_PRODUCT_ID"), product_secret: ENV.fetch("NEST_PRODUCT_SECRET"), file: NestApi::CONFIG_FILE)
+      @token = NestApi::AccessToken.new(product_id, product_secret, file)
+    end
+
+    # Retrieve a list of all thermostats registered to this account
+    def get_thermostat_list
+      create_thermostats(HTTParty.get("#{NestApi::API_URL}/devices/thermostats", query: { auth: @token.access_token }))
+    end
+
+    # Retrieve a single thermostat by name
+    def get_thermostat_by_name(name)
+      get_thermostat_list[name]
+    end
+
+    private
+
+    # Transform the nest api thermostats reponse into NestApi::Thermostat objects
+    def create_thermostats(thermostat_list)
+      thermostat_list.map { |device, info| [ info['name'], NestApi::Thermostat.new(device, @token) ] }.to_h
+    end
+  end
+end

data/lib/nest_api/thermostat.rb

@@ -0,0 +1,23 @@
+module NestApi
+  class Thermostat
+    def initialize(device_id, token)
+      @id = device_id
+      @token = token
+    end
+
+    # Retrieve a property of a thermostat
+    # If no property_id is supplied, all properties of the thermostat will be returned
+    def get(property_id = '')
+      HTTParty.get("#{NestApi::API_URL}/devices/thermostats/#{@id}/#{property_id}",  query: { auth: @token.access_token })
+    end
+
+    # Set a thermostat property to a new value
+    def update!(property_id:, value:)
+      HTTParty.put("#{NestApi::API_URL}/devices/thermostats/#{@id}",
+        query: { auth: @token.access_token },
+        body: { "#{property_id}" => value }.to_json,
+        headers: { 'Content-Type' => 'application/json'
+      })
+    end
+  end
+end

data/lib/nest_api.rb

@@ -0,0 +1,17 @@
+require 'HTTParty'
+require 'json'
+
+require_relative 'nest_api/access_token'
+require_relative 'nest_api/api'
+require_relative 'nest_api/thermostat'
+
+module NestApi
+  CONFIG_FILE = './nest_config'
+
+  API_URL = 'https://developer-api.nest.com'
+  AUTH_URL = 'https://home.nest.com/login/oauth2?state=STATE&client_id='
+  TOKEN_URL = 'https://api.home.nest.com/oauth2/access_token'
+
+  ConfigurationError = Class.new(StandardError)
+  ApiError = Class.new(StandardError)
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: nest_api
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Jessica Burns
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-02-23 00:00:00.000000000 Z
+dependencies: []
+description: Simple API Wrapper for Nest Thermostats
+email: jessburnsm@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/nest_api.rb
+- lib/nest_api/access_token.rb
+- lib/nest_api/api.rb
+- lib/nest_api/thermostat.rb
+homepage: http://rubygems.org/gems/nest_api
+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.6.8
+signing_key: 
+specification_version: 4
+summary: Nest thermostat API Wrapper
+test_files: []