hue 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 32b4e4137e61f92f9e4a2033f4b01f5abf57a197
+  data.tar.gz: fcd37ed79cb42411e10ac9bc84b4802390b54d5e
+SHA512:
+  metadata.gz: 7c72e22fdd17c1065ae118474c03a6aaf9efe2d1cca17b7f27620e2727949b74808795cb729fb2851a1c21ea6e4117f3bb0641940c6a78f954970866cae3b3b2
+  data.tar.gz: 6b5ab557a8a00e8ea23fa1f485134ad963052e8b517ed2b969c4895f8adab9ab8b621332997362835f64466064fa88b35acd4204aa5e03849245af3a3510f240

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Contributing.markdown

@@ -0,0 +1,19 @@
+## Submitting a Pull Request
+
+1. [Fork the repository.][fork]
+2. [Create a topic branch.][branch]
+3. Add tests for your unimplemented feature or bug fix.
+4. Run `bundle exec rake`. If your tests pass, return to step 3.
+5. Implement your feature or bug fix.
+6. Run `bundle exec rake`. If your tests fail, return to step 5.
+7. Run `open coverage/index.html`. If your changes are not completely covered
+   by your tests, return to step 3.
+8. Add documentation for your feature or bug fix.
+9. Run `bundle exec rake doc`. If your changes are not 100% documented, go
+   back to step 8.
+10. Add, commit, and push your changes.
+11. [Submit a pull request.][pr]
+
+[fork]: http://help.github.com/fork-a-repo/
+[branch]: http://learn.github.com/p/branching.html
+[pr]: http://help.github.com/send-pull-requests/

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rake'

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Sam Soffes
+
+MIT License
+
+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/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/Readme.markdown

@@ -0,0 +1,24 @@
+# Hue
+
+Work with Philips Hue light bulbs from Ruby.
+
+## Installation
+
+This gem is currently unreleased. For now, simply clone the repository.
+
+## Usage
+
+``` shell
+$ git clone https://github.com/soffes/hue.git
+$ irb -Ihue/lib -rhue
+```
+
+``` ruby
+> client = Hue::Client.new
+> light = client.lights.first
+> light.on = true
+```
+
+## Contributing
+
+See the [contributing guide](Contributing.markdown).

data/bin/hue

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path('../../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hue'
+require 'hue/cli'
+
+Hue::Cli.start

data/hue.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hue/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'hue'
+  spec.version       = Hue::VERSION
+  spec.authors       = ['Sam Soffes']
+  spec.email         = ['sam@soff.es']
+  spec.description   = 'Work with Philips Hue light bulbs.'
+  spec.summary       = 'Work with Philips Hue light bulbs from Ruby.'
+  spec.homepage      = 'https://github.com/soffes/hue'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 1.8.7'
+  spec.add_dependency 'multi_json'
+  spec.add_dependency 'thor'
+end

data/lib/hue.rb

@@ -0,0 +1,8 @@
+require 'hue/version'
+require 'hue/errors'
+require 'hue/client'
+require 'hue/light'
+
+module Hue
+  USERNAME_RANGE = 10..40
+end

data/lib/hue/cli.rb

@@ -0,0 +1,26 @@
+require 'thor'
+
+module Hue
+  class Cli < Thor
+    desc 'lights', 'Find all of the lights on your network'
+    def lights
+      client.lights.each do |light|
+        puts light.id.to_s.ljust(6) + light.name
+      end
+    end
+
+    desc 'all STATE', 'Send commands to all lights'
+    def all(state)
+      on = state == 'on'
+      client.lights.each do |light|
+        light.on = on
+      end
+    end
+
+  private
+
+    def client
+      @client ||= Hue::Client.new
+    end
+  end
+end

data/lib/hue/client.rb

@@ -0,0 +1,80 @@
+require 'net/http'
+require 'multi_json'
+
+module Hue
+  class Client
+    attr_reader :username
+
+    def initialize(username = '1234567890')
+      unless USERNAME_RANGE.include?(username.length)
+        raise InvalidUsername, "Usernames must be between #{USERNAME_RANGE.first} and #{USERNAME_RANGE.last}."
+      end
+
+      @username = username
+      validate_user
+    end
+
+    def base_station
+      # Pick the first one for now. In theory, they should all do the same thing.
+      base_station = base_stations.first
+      raise NoBaseStationFound unless base_station
+      base_station
+    end
+
+    def base_stations
+      @base_stations ||= MultiJson.load(Net::HTTP.get(URI.parse('http://www.meethue.com/api/nupnp')))
+    end
+
+    def lights
+      @lights ||= begin
+        ls = []
+        json = MultiJson.load(Net::HTTP.get(URI.parse("http://#{bridge_ip}/api/#{@username}/lights")))
+        json.each do |key, value|
+          ls << Light.new(self, key, value['name'])
+        end
+        ls
+      end
+    end
+
+  private
+
+    def validate_user
+      response = MultiJson.load(Net::HTTP.get(URI.parse("http://#{bridge_ip}/api/#{@username}")))
+      if error = response['error']
+        parse_error(error)
+      end
+      response['success']
+    end
+
+    def register_user
+      body = {
+        devicetype: 'Ruby',
+        username: @username
+      }
+
+      uri = URI.parse("http://#{bridge_ip}/api")
+      http = Net::HTTP.new(uri.hostname)
+      response = MultiJson.load(http.request_post(uri.path, MultiJson.dump(body)).body).first
+
+      if error = response['error']
+        parse_error(error)
+      end
+      response['success']
+    end
+
+    def bridge_ip
+      base_station['internalipaddress']
+    end
+
+    def parse_error(error)
+      # Find error or return
+      klass = Hue::ERROR_MAP[error['type']]
+      klass = UnknownError unless klass
+
+      # Raise error
+      raise klass.new(error['description'])
+    rescue  Hue::UnauthorizedUser
+      register_user
+    end
+  end
+end

data/lib/hue/errors.rb

@@ -0,0 +1,37 @@
+module Hue
+  class Error < StandardError; end
+
+  class UnauthorizedUser < Error; end
+  class InvalidJSON < Error; end
+  class ResourceNotAvailable < Error; end
+  class MethodNotAvailable < Error; end
+  class MissingBody < Error; end
+  class ParameterNotAvailable < Error; end
+  class InvalidValueForParameter < Error; end
+  class ParameterNotModifiable < Error; end
+  class InternalError < Error; end
+  class LinkButtonNotPressed < Error; end
+  class ParameterNotModifiableWhileOff < ParameterNotModifiable; end
+  class TooManyGroups < Error; end
+  class GroupTooFull < Error; end
+
+  class InvalidUsername < Error; end
+  class UnknownError < Error; end
+
+  # Status code to exception map
+  ERROR_MAP = {
+      1 => Hue::UnauthorizedUser,
+      2 => Hue::InvalidJSON,
+      3 => Hue::ResourceNotAvailable,
+      4 => Hue::MethodNotAvailable,
+      5 => Hue::MissingBody,
+      6 => Hue::ParameterNotAvailable,
+      7 => Hue::InvalidValueForParameter,
+      8 => Hue::ParameterNotModifiable,
+    901 => Hue::InternalError,
+    101 => Hue::LinkButtonNotPressed,
+    201 => Hue::ParameterNotModifiableWhileOff,
+    301 => Hue::TooManyGroups,
+    302 => Hue::GroupTooFull
+  }
+end

data/lib/hue/light.rb

@@ -0,0 +1,66 @@
+module Hue
+  class Light
+    attr_reader :id
+    attr_reader :name
+    attr_reader :state
+    attr_reader :type
+    attr_reader :model
+    attr_reader :software_version
+    attr_reader :point_symbol
+
+    def initialize(client, id, name)
+      @client = client
+      @id = id
+      @name = name
+      refresh
+    end
+
+    def on?
+      @state['on']
+    end
+
+    def on=(new_state)
+      self.set_state(new_state)
+    end
+
+    def hsb
+      @state.select { |k, v| %w{sat bri hue}.include?(k) }
+    end
+
+    def set_state(on, hue = nil, saturation = nil, brightness = nil)
+      body = {
+        on: on
+      }
+
+      if on
+        body.merge!({
+          hue: hue,
+          sat: saturation,
+          bri: brightness
+        })
+      end
+
+      bridge_ip = @client.base_station['internalipaddress']
+      uri = URI.parse("http://#{bridge_ip}/api/#{@client.username}/lights/#{self.id}/state")
+
+      http = Net::HTTP.new(uri.hostname)
+      response = http.request_put(uri.path, MultiJson.dump(body))
+      MultiJson.load(response.body)
+    end
+
+  private
+
+    def refresh
+      bridge_ip = @client.base_station['internalipaddress']
+      uri = URI.parse("http://#{bridge_ip}/api/#{@client.username}/lights/#{self.id}")
+      json = MultiJson.load(Net::HTTP.get(uri))
+
+      @state = json['state']
+      @type = json['type']
+      @name = json['name']
+      @model = json['modelid']
+      @software_version = json['swversion']
+      @point_symbol = json['pointsymbol']
+    end
+  end
+end

data/lib/hue/version.rb

@@ -0,0 +1,3 @@
+module Hue
+  VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: hue
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Sam Soffes
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Work with Philips Hue light bulbs.
+email:
+- sam@soff.es
+executables:
+- hue
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Contributing.markdown
+- Gemfile
+- LICENSE
+- Rakefile
+- Readme.markdown
+- bin/hue
+- hue.gemspec
+- lib/hue.rb
+- lib/hue/cli.rb
+- lib/hue/client.rb
+- lib/hue/errors.rb
+- lib/hue/light.rb
+- lib/hue/version.rb
+homepage: https://github.com/soffes/hue
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.0
+signing_key: 
+specification_version: 4
+summary: Work with Philips Hue light bulbs from Ruby.
+test_files: []