milight-easybulb 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4a0fc0787879689b686f3cb0b6a7162eded64ea0
+  data.tar.gz: 1a587697381987b7db82e693a9ba5aad58a5a3e1
+SHA512:
+  metadata.gz: 06e31da3238529ee47fb1a702bed3e91f20477b46727d1e1d43cd4a2ca448526b0fc7f74e7c0b9a99dfd07bec0b2b6657558871f71e0cbd2a1ca867b81296dd3
+  data.tar.gz: 713aede83575d8a77004933e6ecc2abac29f7e26b261e5edd7de1d85dcba2b44a844d12ad7c835aa94f0753ce320f5ca63b7173cadb50226a48ac35bb5037eab

data/.gitignore

@@ -0,0 +1,4 @@
+log
+tmp
+*.gem
+notes.md

data/.rubocop-https---raw-githubusercontent-com-dvmtn-house-style-master-rubocop-yml

@@ -0,0 +1,64 @@
+AllCops:
+  Include:
+    - '**/Rakefile'
+    - '**/config.ru'
+  Exclude:
+    - 'db/**/*'
+    - 'config/**/*'
+    - 'script/**/*'
+    - 'tmp/**/*'
+    - 'vendor/**/*'
+    - 'bin/**/*'
+    - 'log/**/*'
+
+Rails:
+  Enabled: true
+
+Style/AlignHash:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+  EnforcedLastArgumentHashStyle: ignore_implicit
+  SupportedLastArgumentHashStyles: ignore_implicit
+
+Style/DefWithParentheses:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/MethodDefParentheses:
+  Enabled: false
+
+Style/Encoding:
+  Enabled: false
+
+Style/PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%':  ()
+    '%i': '[]'
+    '%q': '[]'
+    '%Q': '[]'
+    '%r': '[]'
+    '%s': '[]'
+    '%w': '[]'
+    '%W': '[]'
+    '%x': '[]'
+
+Style/PredicateName:
+  NamePrefixBlacklist:
+    - is_
+    - has_
+    - have_
+    - the_
+    - a_
+    - should_
+
+Style/SignalException:
+  EnforcedStyle: only_raise
+
+Style/EmptyLinesAroundClassBody:
+  EnforcedStyle: empty_lines
+
+Metrics/LineLength:
+  Max: 140
+  AllowURI: true

data/.rubocop.yml

@@ -0,0 +1,2 @@
+inherit_from:
+  - https://raw.githubusercontent.com/dvmtn/house_style/master/rubocop.yml

data/.semver

@@ -0,0 +1,6 @@
+---
+:major: 1
+:minor: 0
+:patch: 0
+:special: ''
+:metadata: ''

data/Gemfile

@@ -0,0 +1,13 @@
+source 'https://rubygems.org'
+
+group :development do
+  gem 'guard-rspec'
+  gem 'rake-n-bake'
+end
+
+group :development, :test do
+  gem 'rspec'
+  gem 'simplecov'
+  gem 'rubocop'
+  gem 'pry-byebug'
+end

data/Gemfile.lock

@@ -0,0 +1,102 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.1.0)
+    astrolabe (1.3.1)
+      parser (~> 2.2)
+    byebug (4.0.5)
+      columnize (= 0.9.0)
+    coderay (1.1.1)
+    columnize (0.9.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    ffi (1.9.10)
+    formatador (0.2.5)
+    guard (2.13.0)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, <= 4.0)
+      lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.6.4)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    listen (3.0.6)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9.7)
+    lumberjack (1.0.10)
+    method_source (0.8.2)
+    multi_json (1.11.0)
+    nenv (0.3.0)
+    notiffany (0.0.8)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    parser (2.2.3.0)
+      ast (>= 1.1, < 3.0)
+    powerpack (0.1.1)
+    pry (0.10.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    pry-byebug (3.1.0)
+      byebug (~> 4.0)
+      pry (~> 0.10)
+    rainbow (2.0.0)
+    rake (10.5.0)
+    rake-n-bake (1.4.0)
+      rake (~> 10)
+      term-ansicolor (~> 1.3)
+    rb-fsevent (0.9.7)
+    rb-inotify (0.9.7)
+      ffi (>= 0.5.0)
+    rspec (3.4.0)
+      rspec-core (~> 3.4.0)
+      rspec-expectations (~> 3.4.0)
+      rspec-mocks (~> 3.4.0)
+    rspec-core (3.4.4)
+      rspec-support (~> 3.4.0)
+    rspec-expectations (3.4.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-mocks (3.4.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-support (3.4.1)
+    rubocop (0.35.1)
+      astrolabe (~> 1.3)
+      parser (>= 2.2.3.0, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.7)
+      tins (<= 1.6.0)
+    ruby-progressbar (1.7.5)
+    shellany (0.0.1)
+    simplecov (0.9.2)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.9.0)
+    simplecov-html (0.9.0)
+    slop (3.6.0)
+    term-ansicolor (1.3.2)
+      tins (~> 1.0)
+    thor (0.19.1)
+    tins (1.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  guard-rspec
+  pry-byebug
+  rake-n-bake
+  rspec
+  rubocop
+  simplecov
+
+BUNDLED WITH
+   1.12.3

data/Guardfile

@@ -0,0 +1,15 @@
+guard :rspec, cmd: "bundle exec rspec --color" do
+  clearing :on
+
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  watch(%r{^lib/(.+)\.rb}) { |m| "spec/#{m[1]}_spec.rb" }
+end

data/README.md

@@ -0,0 +1,37 @@
+Milight
+=======
+A gem for controlling Milight Wifi bulbs
+
+Usage
+-----
+1. Require the gem
+2. Initialise a new controller with the IP address of your controller
+3. Send commands to all groups, or just one
+
+For example, connecting to a controller on `192.168.0.10`, turning on group 1 and setting it to a teal colour at 50% brightness:
+
+```Ruby
+require 'milight'
+
+# Initialise a controller
+lights = Milight::Controller.new '192.168.0.10'
+
+# Turn a group of lights on and set their colour
+lights.group(1).on
+lights.group(1).colour '#ff00ff'
+
+# Or chain the commands to one group
+lights.group(1).on.hue('#f00').brightness(50)
+
+# Go to bed after happily messing with lights!
+lights.all.off
+```
+
+Take a look at [the example script](bin/example) for an example script using the gem.
+
+Things you should know
+----------------------
+* Colours can be set using the `colour` method via a HEX colour code (for example, `#f00` or `#a0f060`)
+* Brightness is given as a percentage (0-100)
+* Hue can also be set using a hex code (but doesn't change the brightness)
+* Everything is sent over UDP, as per the Milight spec. This means that some commands will get 'lost', especially if you send many in quick succession. The gem tries to account for this by adding very short delays between commands but it isn't guaranteed.

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rake/clean'
+require 'rake-n-bake'
+require 'bundler/gem_tasks'
+
+task default: [
+  :clean,
+  :"bake:code_quality:all",
+  :"bake:rspec",
+  :"bake:coverage:check_specs",
+  :"bake:rubocop",
+  :"bake:ok_rainbow"
+]

data/bin/example

@@ -0,0 +1,74 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+require 'milight'
+
+if ARGV.length != 1
+  puts "Usage: #{$PROGRAM_NAME} <ip_address>"
+  puts '  For example:', "  #{$PROGRAM_NAME} 192.168.0.10"
+  exit 1
+end
+
+ip = ARGV.shift
+lights = Milight::Controller.new ip
+
+red = '#f00'
+green = '#0f0'
+blue = '#00f'
+yellow = '#ff0'
+
+# Control all lights on all channels
+lights.all.on
+sleep 1
+lights.all.colour(red)
+sleep 1
+lights.all.colour(green)
+sleep 1
+lights.all.colour(blue)
+sleep 1
+lights.all.off
+sleep 1
+
+# Control each channel/group of lights
+lights.group(1).colour(red)
+lights.group(2).colour(green)
+lights.group(3).colour(yellow)
+lights.group(4).colour(blue)
+sleep 1
+
+# Assign the group to a variable for easier identification
+bedroom = lights.group(1)
+kitchen = lights.group(2)
+
+bedroom.colour('#2F22ff')
+kitchen.colour('#FFF')
+
+# Set either the hue or brightness without affecting the other
+lights.group(3).hue(yellow)
+lights.group(4).brightness(25) # given as a percentage
+sleep 1
+lights.all.off
+sleep 3
+
+# Lets simulate the sunrise!
+all = lights.all
+SUNRISE = %w[ #003 #026 #02A #23A #F50 #F92 #FC0 #FF4 #FFF]
+
+puts 'Sunrise!'
+SUNRISE.each do |colour|
+  all.colour(colour)
+  print '.'
+  sleep 2
+end
+
+puts 'Sunset!'
+SUNRISE.reverse_each do |colour|
+  all.colour(colour)
+  print '.'
+  sleep 2
+end
+
+sleep 1
+
+# ...and set everything back to white when we're done!
+lights.all.white

data/lib/milight.rb

@@ -0,0 +1,5 @@
+require 'milight/version'
+require 'milight/controller'
+
+module Milight
+end

data/lib/milight/brightness.rb

@@ -0,0 +1,27 @@
+module Milight
+  class Brightness
+
+    MIN = 2
+    MAX = 27
+
+    def initialize percent
+      raise invalid_brightness unless valid_brightness?(percent)
+      @percent = percent
+    end
+
+    def to_milight_brightness
+      MIN + ((MAX - MIN) * @percent / 100).round
+    end
+
+    private
+
+    def invalid_brightness
+      ArgumentError.new 'Brightness must be given as a percentage (0 - 100)'
+    end
+
+    def valid_brightness? percentage
+      percentage >= 0 && percentage <= 100
+    end
+
+  end
+end

data/lib/milight/colour.rb

@@ -0,0 +1,118 @@
+require_relative 'brightness'
+
+module Milight
+  class Colour
+
+    attr_reader :hue, :saturation, :luminosity, :red, :green, :blue
+
+    HUE_OFFSET = 176
+    VALID_HEX_REGEX = /^#?([0-9a-f]{3}){,2}$/i
+
+    def initialize(value)
+      case value
+      when String then from_hex(value)
+      when Array  then from_rgb(*value)
+      else
+        raise invalid_colour_error
+      end
+    end
+
+    def to_hsl
+      [@hue, @saturation, @luminosity]
+    end
+
+    def to_rgb
+      [@red, @green, @blue]
+    end
+
+    def to_milight_colour
+      ((256 + HUE_OFFSET - (hue / 360.0 * 255.0)) % 256).to_i
+    end
+
+    def to_milight_brightness
+      percent = [brightness_for_saturation, 100].min
+      Milight::Brightness.new(percent).to_milight_brightness
+    end
+
+    def greyscale?
+      @red == @green && @red == @blue
+    end
+
+    private
+
+    def from_rgb(r, g, b)
+      @red = r
+      @green = g
+      @blue = b
+      @hue, @saturation, @luminosity = rgb_to_hsl(r, g, b)
+    end
+
+    def from_hex(hex)
+      raise invalid_hex_colour_error unless valid_hex_colour? hex
+      r, g, b = hex_to_rgb(hex)
+      from_rgb(r, g, b)
+    end
+
+    def brightness_for_saturation
+      r, g, b = *to_rgb
+      (Math.sqrt(r * r + g * g + b * b) / 2.55).round
+    end
+
+    def hex_to_rgb(hex)
+      hex.sub('#', '')
+        .chars
+        .each_slice(hex.length / 3)
+        .map { |val| val.length == 1 ? val * 2 : val }
+        .map(&:join)
+        .map { |h| h.to_i(16) }
+    end
+
+    def rgb_to_hsl(r1, g1, b1)
+      r, g, b = [r1, g1, b1].map { |c| c / 255.0 }
+      h = rgb_to_hue(r, g, b)
+      l = rgb_to_luminosity(r, g, b)
+      s = rgbl_to_saturation(r, g, b, l)
+      [h, s, l]
+    end
+
+    def rgb_to_hue(r, g, b)
+      return 0 if greyscale?
+      delta = delta(r, g, b)
+      offset = case [r, g, b].max
+               when r then ((g - b) / delta)
+               when g then ((b - r) / delta) + 2
+               when b then ((r - g) / delta) + 4
+               end
+      60 * offset % 360
+    end
+
+    def rgb_to_luminosity(r, g, b)
+      [r, g, b].minmax.inject(:+) / 2
+    end
+
+    def rgbl_to_saturation(r, g, b, l)
+      return 0 if greyscale?
+      (delta(r, g, b) / 1 - (2 * l - 1)).abs
+    end
+
+    def delta(r, g, b)
+      [r, g, b].minmax.reverse.inject(:-)
+    end
+
+    def valid_hex_colour?(value)
+      value =~ VALID_HEX_REGEX
+    end
+
+    def invalid_colour_error
+      ArgumentError.new(
+        "Colours must be given as with a hex colour string ( #{self.class}.new('#11A401') )" \
+        " or a RGB array ( #{self.class}.new([r,g,b]) )"
+      )
+    end
+
+    def invalid_hex_colour_error
+      ArgumentError.new('Hex colours codes must be 3 or 6 0-9 or a-f characters')
+    end
+
+  end
+end

data/lib/milight/commander.rb

@@ -0,0 +1,22 @@
+require 'socket'
+
+module Milight
+  class Commander
+
+    def initialize(ip_address, port = 8899)
+      @ip_address = ip_address
+      @port = port
+    end
+
+    def send_command(cmd, arg1 = 0x00)
+      socket = UDPSocket.new
+      socket.send [cmd, arg1, 0x55].pack('C*'), 0, @ip_address, @port
+      socket.close
+    end
+
+    def command_delay
+      sleep 0.1
+    end
+
+  end
+end

data/lib/milight/controller.rb

@@ -0,0 +1,23 @@
+require 'milight/commander'
+require 'milight/rgbw_group'
+require 'milight/rgbw_all'
+
+module Milight
+  class Controller
+
+    attr_reader :commander
+
+    def initialize(ip_address, port = 8899)
+      @commander = Milight::Commander.new ip_address, port
+    end
+
+    def all
+      Milight::RgbwAll.new(@commander)
+    end
+
+    def group(channel)
+      Milight::RgbwGroup.new(@commander, channel)
+    end
+
+  end
+end

data/lib/milight/rgbw_all.rb

@@ -0,0 +1,73 @@
+require 'milight/colour'
+
+module Milight
+  class RgbwAll
+
+    ALL_OFF  = 0x41
+    ALL_ON   = 0x42
+    WHITE = 0xC2
+    COLOUR = 0x40
+    BRIGHTNESS = 0x4E
+
+    def initialize(commander, colour_helper: Milight::Colour)
+      @commander = commander
+      @colour_helper = colour_helper
+    end
+
+    def on
+      @commander.send_command ALL_ON
+      self
+    end
+
+    def off
+      @commander.send_command ALL_OFF
+      self
+    end
+
+    def white
+      send_white_cmd
+      self
+    end
+
+    def hue(hue)
+      colour = @colour_helper.new(hue)
+      send_colour_cmd colour
+      self
+    end
+
+    def brightness(value)
+      brightness = Milight::Brightness.new(value)
+      send_brightness_cmd brightness
+      self
+    end
+
+    def colour(colour)
+      colour_value = @colour_helper.new(colour)
+      colour_value.greyscale? ? send_white_cmd : send_colour_cmd(colour_value)
+      send_brightness_cmd colour_value
+      self
+    end
+
+    private
+
+    def send_white_cmd
+      select
+      @commander.send_command WHITE
+    end
+
+    def send_colour_cmd colour
+      select
+      @commander.send_command COLOUR, colour.to_milight_colour
+    end
+
+    def send_brightness_cmd brightness
+      select
+      @commander.send_command BRIGHTNESS, brightness.to_milight_brightness
+    end
+
+    def select
+      on
+    end
+
+  end
+end

data/lib/milight/rgbw_group.rb

@@ -0,0 +1,85 @@
+require 'milight/colour'
+
+module Milight
+  class RgbwGroup
+
+    attr_reader :commander
+
+    GROUP_ON = [0x45, 0x47, 0x49, 0x4B]
+    GROUP_OFF = [0x46, 0x48, 0x4A, 0x4C]
+    GROUP_WHITE = [0xC5, 0xC7, 0xC9, 0xCB]
+
+    BRIGHTNESS = 0x4E
+    COLOUR = 0x40
+
+    def initialize(commander, group, colour_helper: Milight::Colour)
+      raise invalid_group_error unless valid_group? group
+      @index = group - 1
+      @commander = commander
+      @colour_helper = colour_helper
+    end
+
+    def on
+      @commander.send_command GROUP_ON[@index]
+      self
+    end
+
+    def off
+      @commander.send_command GROUP_OFF[@index]
+      self
+    end
+
+    def white
+      send_white_cmd
+      self
+    end
+
+    def hue(hue)
+      colour = @colour_helper.new(hue)
+      send_colour_cmd colour
+      self
+    end
+
+    def brightness(value)
+      brightness = Milight::Brightness.new(value)
+      send_brightness_cmd brightness
+      self
+    end
+
+    def colour(colour)
+      colour_value = @colour_helper.new(colour)
+      colour_value.greyscale? ? send_white_cmd : send_colour_cmd(colour_value)
+      send_brightness_cmd colour_value
+      self
+    end
+
+    private
+
+    def send_white_cmd
+      @commander.send_command GROUP_WHITE[@index]
+    end
+
+    def send_colour_cmd colour
+      select
+      @commander.send_command COLOUR, colour.to_milight_colour
+    end
+
+    def send_brightness_cmd colour
+      select
+      @commander.send_command BRIGHTNESS, colour.to_milight_brightness
+    end
+
+    def select
+      on
+    end
+
+    def invalid_group_error
+      ArgumentError.new('Group must be between 1 and 4')
+    end
+
+    def valid_group?(value)
+      value.between?(1, 4)
+    end
+
+  end
+end

data/lib/milight/version.rb

@@ -0,0 +1,3 @@
+module Milight
+  VERSION = '1.0.0'
+end

data/milight.gemspec

@@ -0,0 +1,20 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'milight/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'milight-easybulb'
+  gem.version       = Milight::VERSION
+  gem.authors       = ['Adam Whittingham']
+  gem.email         = 'adam.whittingham@gmail.com'
+
+  gem.date          = '2014-05-15'
+  gem.summary       = 'A ruby interface for Milight and Easybulb LED lights'
+  gem.description   = 'A ruby interface for Milight and Easybulb LED lights'
+  gem.files         = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
+  gem.require_paths = ['lib']
+
+  gem.homepage      = 'https://github.com/AdamWhittingham/milight'
+  gem.license       = 'MIT'
+end

data/spec/milight/brightness_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+require production_code
+
+describe Milight::Brightness do
+  describe '#to_milight_brightness' do
+    {
+      100 => 27,
+      75  => 20,
+      50  => 14,
+      25  => 8,
+      0   => 2
+    }.each do |percent, milight|
+      it "converts #{percent}% to the milight code #{milight}" do
+        expect(described_class.new(percent).to_milight_brightness).to eq milight
+      end
+    end
+
+    it 'raises an exception for invalid numbers' do
+      expect { described_class.new(101) }.to raise_error ArgumentError
+    end
+  end
+end

data/spec/milight/colour_spec.rb

@@ -0,0 +1,84 @@
+require 'spec_helper'
+require 'ostruct'
+require production_code
+
+describe Milight::Colour do
+  let(:red)   { OpenStruct.new(milight: 176, rgb: [255, 0, 0], hsl: [0.0, 1.0, 0.5]) }
+  let(:green) { OpenStruct.new(milight:  85, rgb: [0, 255, 0], hsl: [120.0, 1.0, 0.5]) }
+  let(:blue)  { OpenStruct.new(milight:   0, rgb: [0, 0, 255], hsl: [240.0, 1.0, 0.5]) }
+
+  describe '#new' do
+    it 'takes valid 6-digit hex codes' do
+      expect(described_class.new('#FF0000').to_hsl).to eq red.hsl
+      expect(described_class.new('#00FF00').to_hsl).to eq green.hsl
+      expect(described_class.new('#0000FF').to_hsl).to eq blue.hsl
+    end
+
+    it 'takes valid 3-digit hex hsls' do
+      expect(described_class.new('#0F0').to_hsl).to eq green.hsl
+    end
+
+    it 'takes valid hex hsls without a leading hash' do
+      expect(described_class.new('0F0').to_hsl).to eq green.hsl
+      expect(described_class.new('00ff00').to_hsl).to eq green.hsl
+    end
+
+    it 'raises an arguement error for invalid hex codes' do
+      expect { described_class.new('#00112233') }.to raise_error ArgumentError
+    end
+
+    it 'raises an arguement error for invalid colour codes' do
+      expect { described_class.new(:hello) }.to raise_error ArgumentError
+    end
+
+    it 'takes an RGB array' do
+      expect(described_class.new([255, 0,   0]).to_hsl).to eq red.hsl
+      expect(described_class.new([0, 255,   0]).to_hsl).to eq green.hsl
+      expect(described_class.new([0, 0, 255]).to_hsl).to eq blue.hsl
+    end
+  end
+
+  describe '#to_milight_colour' do
+    it 'converts hex codes to milight colour codes' do
+      expect(described_class.new('#FF0000').to_milight_colour).to eq red.milight
+    end
+
+    it 'converts an array of RGB values to milight colour codes' do
+      expect(described_class.new([255, 0, 0]).to_milight_colour).to eq red.milight
+    end
+  end
+
+  describe '#to_milight_brightness' do
+    it 'converts hex codes to milight brightness codes' do
+      expect(described_class.new('#00FF00').to_milight_brightness).to eq 27
+      expect(described_class.new('#008800').to_milight_brightness).to eq 15
+      expect(described_class.new('#000000').to_milight_brightness).to eq 2
+    end
+  end
+
+  describe '#to_rgb' do
+    it 'outputs an array of RGB' do
+      expect(described_class.new('#FF0000').to_rgb).to eq red.rgb
+      expect(described_class.new('#00FF00').to_rgb).to eq green.rgb
+      expect(described_class.new('#0000FF').to_rgb).to eq blue.rgb
+    end
+  end
+
+  describe '#to_hsl' do
+    it 'outputs an array of HSL' do
+      expect(described_class.new('#FF0000').to_hsl).to eq red.hsl
+      expect(described_class.new('#00FF00').to_hsl).to eq green.hsl
+      expect(described_class.new('#0000FF').to_hsl).to eq blue.hsl
+    end
+  end
+
+  describe '#greyscale?' do
+    it 'returns true for greyscale colours' do
+      expect(described_class.new('#aaa').greyscale?).to eq true
+    end
+
+    it 'returns false for non-greyscale colours' do
+      expect(described_class.new('#f0f').greyscale?).to eq false
+    end
+  end
+end

data/spec/milight/commander_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+require production_code
+
+describe Milight::Commander do
+  let(:socket)     { instance_double(UDPSocket) }
+  let(:ip_address) { '127.0.0.1' }
+  let(:port)       { 8080 }
+
+  subject { described_class.new ip_address, port }
+
+  before do
+    allow(UDPSocket).to receive(:new).and_return(socket)
+    allow(socket).to receive(:close)
+  end
+
+  describe '#send_command' do
+    it 'sends the given bytes' do
+      payload = [0x42, 0x00, 0x55].pack('C*')
+      expect(socket).to receive(:send).with(payload, 0, ip_address, port)
+      subject.send_command 0x42
+    end
+
+    it 'sends the given argument if one is given' do
+      payload = [0x42, 0x01, 0x55].pack('C*')
+      expect(socket).to receive(:send).with(payload, 0, ip_address, port)
+      subject.send_command 0x42, 0x01
+    end
+  end
+
+  describe '#command_delay' do
+    it 'pauses for 100 milliseconds' do
+      before = Time.now
+      subject.command_delay
+      after = Time.now
+      expect(after - before).to be > 0.1
+    end
+  end
+end

data/spec/milight/controller_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+require production_code
+
+describe Milight::Controller do
+  let(:commander) { instance_double(Milight::Commander) }
+
+  subject { described_class.new '127.0.0.1', 8080 }
+
+  before { allow(Milight::Commander).to receive(:new).and_return(commander) }
+
+  describe '#all' do
+    it 'returns an RGBW all object' do
+      expect(subject.all).to be_a Milight::RgbwAll
+    end
+  end
+
+  describe '#group' do
+    it 'returns a RGBW group object' do
+      expect(subject.group(1)).to be_a Milight::RgbwGroup
+    end
+  end
+end

data/spec/milight/rgbw_all_spec.rb

@@ -0,0 +1,93 @@
+require 'spec_helper'
+require 'milight/commander'
+require production_code
+
+describe Milight::RgbwAll do
+  let(:commander) { double Milight::Commander, send_command: true, command_delay: true }
+
+  subject { described_class.new commander }
+
+  describe '#on' do
+    it 'sends the ON packet for the given group' do
+      expect(commander).to receive(:send_command).with(0x42)
+      subject.on
+    end
+
+    it 'is chainable' do
+      expect(subject.on).to eq subject
+    end
+  end
+
+  describe '#off' do
+    it 'sends the OFF packet for the given group' do
+      expect(commander).to receive(:send_command).with(0x41)
+      subject.off
+    end
+
+    it 'is chainable' do
+      expect(subject.off).to eq subject
+    end
+  end
+
+  describe '#white' do
+    it 'sends the WHITE packet for the given group' do
+      expect(commander).to receive(:send_command).with(0xC2)
+      subject.white
+    end
+
+    it 'is chainable' do
+      expect(subject.white).to eq subject
+    end
+  end
+
+  describe '#hue' do
+    it 'sends a COLOUR packet' do
+      expect(commander).to receive(:send_command).with(0x40, 176)
+      subject.hue '#f00'
+    end
+
+    it 'is chainable' do
+      expect(subject.hue('#f00')).to eq subject
+    end
+  end
+
+  describe '#brightness' do
+    it 'sends the BRIGHTNESS packet' do
+      expect(commander).to receive(:send_command).with(0x4E, 4)
+      subject.brightness 10
+    end
+
+    it 'is chainable' do
+      expect(subject.brightness(10)).to eq subject
+    end
+  end
+
+  describe '#colour' do
+    before do
+      allow(commander).to receive(:send_command).with(0x40, anything)
+      allow(commander).to receive(:send_command).with(0x4E, anything)
+    end
+
+    it 'sets the hue' do
+      expect(commander).to receive(:send_command).with(0x40, 219)
+      subject.colour '#880088'
+    end
+
+    it 'sets the brightness' do
+      expect(commander).to receive(:send_command).with(0x4E, 20)
+      subject.colour '#880088'
+    end
+
+    context 'for a greyscale colour' do
+      it 'sets the light to white' do
+        expect(commander).to receive(:send_command).with(0xC2)
+        subject.colour '#aaa'
+      end
+
+      it 'sets the brightness' do
+        expect(commander).to receive(:send_command).with(0x4E, 25)
+        subject.colour '#888'
+      end
+    end
+  end
+end

data/spec/milight/rgbw_group_spec.rb

@@ -0,0 +1,100 @@
+require 'spec_helper'
+require 'milight/commander'
+require production_code
+
+describe Milight::RgbwGroup do
+  let(:commander) { double Milight::Commander, send_command: true, command_delay: true }
+
+  subject { described_class.new commander, 1 }
+
+  describe '.new' do
+    it 'raises an ArguementError for groups not in the valid range' do
+      expect { described_class.new commander, 5 }.to raise_error ArgumentError
+    end
+  end
+
+  describe '#on' do
+    it 'sends the ON packet for the given group' do
+      expect(commander).to receive(:send_command).with(0x45)
+      subject.on
+    end
+
+    it 'is chainable' do
+      expect(subject.on).to eq subject
+    end
+  end
+
+  describe '#off' do
+    it 'sends the OFF packet for the given group' do
+      expect(commander).to receive(:send_command).with(0x46)
+      subject.off
+    end
+
+    it 'is chainable' do
+      expect(subject.off).to eq subject
+    end
+  end
+
+  describe '#white' do
+    it 'sends the WHITE packet for the given group' do
+      expect(commander).to receive(:send_command).with(0xC5)
+      subject.white
+    end
+
+    it 'is chainable' do
+      expect(subject.white).to eq subject
+    end
+  end
+
+  describe '#hue' do
+    it 'sends a COLOUR packet for the given group' do
+      expect(commander).to receive(:send_command).with(0x40, 176)
+      subject.hue '#f00'
+    end
+
+    it 'is chainable' do
+      expect(subject.hue('#f00')).to eq subject
+    end
+  end
+
+  describe '#brightness' do
+    it 'sends the BRIGHTNESS packet for the given group' do
+      expect(commander).to receive(:send_command).with(0x4E, 4)
+      subject.brightness 10
+    end
+
+    it 'is chainable' do
+      expect(subject.brightness(10)).to eq subject
+    end
+  end
+
+  describe '#colour' do
+    before do
+      allow(commander).to receive(:send_command).with(0x40, anything)
+      allow(commander).to receive(:send_command).with(0x4E, anything)
+      allow(commander).to receive(:send_command).with(0x45)
+    end
+
+    it 'sets the hue' do
+      expect(commander).to receive(:send_command).with(0x40, 219)
+      subject.colour '#880088'
+    end
+
+    it 'sets the brightness' do
+      expect(commander).to receive(:send_command).with(0x4E, 20)
+      subject.colour '#880088'
+    end
+
+    context 'for a greyscale colour' do
+      it 'sets the light to white' do
+        expect(commander).to receive(:send_command).with(0xC5)
+        subject.colour '#aaa'
+      end
+
+      it 'sets the brightness' do
+        expect(commander).to receive(:send_command).with(0x4E, 25)
+        subject.colour '#888'
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require 'pry'
+require 'simplecov'
+SimpleCov.coverage_dir 'log/coverage/spec'
+SimpleCov.start
+
+def production_code
+  spec = caller[0][/spec.+\.rb/]
+  './' + spec.gsub('_spec', '').gsub(/spec/, 'lib')
+end
+
+RSpec.configure do |config|
+  config.default_formatter = 'doc' if config.files_to_run.one?
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: milight-easybulb
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Adam Whittingham
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-15 00:00:00.000000000 Z
+dependencies: []
+description: A ruby interface for Milight and Easybulb LED lights
+email: adam.whittingham@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop-https---raw-githubusercontent-com-dvmtn-house-style-master-rubocop-yml"
+- ".rubocop.yml"
+- ".semver"
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- README.md
+- Rakefile
+- bin/example
+- lib/milight.rb
+- lib/milight/brightness.rb
+- lib/milight/colour.rb
+- lib/milight/commander.rb
+- lib/milight/controller.rb
+- lib/milight/rgbw_all.rb
+- lib/milight/rgbw_group.rb
+- lib/milight/version.rb
+- milight.gemspec
+- spec/milight/brightness_spec.rb
+- spec/milight/colour_spec.rb
+- spec/milight/commander_spec.rb
+- spec/milight/controller_spec.rb
+- spec/milight/rgbw_all_spec.rb
+- spec/milight/rgbw_group_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/AdamWhittingham/milight
+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.4.5
+signing_key: 
+specification_version: 4
+summary: A ruby interface for Milight and Easybulb LED lights
+test_files: []