Test Driven Lighting

Overview

Red / Green / Refractor! Share and control HUE lights with your remote pairing partner as you run your tests.

Philips HUE lights can be controlled over wifi. It's pretty trivial to make your test suite change your lights to be red or green (or blue or yellow or anything) ...as long as you controlling your own lights over your own wifi.

But what if you are remote pairing, and you run your tests on your partner's machine? Wouldn't you want your lights to still update?

What if you both had HUE lights for watching your tests run?

Installation

#glhf

TL;DR Grab Dave or Ashton or DJ or Brian and we can help you. Or just see how far you get with this:

• Prerequisites
  • If you have HUE lights, you need them set up and working, and you'll need to know your HUE API id and the IP address of your HUE hub.
  • You'll need a RabbitMQ server running somewhere, and you'll need the host, username and password to connect to that.
• 1. Get Stuff. Clone this repo and bundle install. You could ALSO just gem install test_driven_lighting, but you won't have an example config file to start from. Your call.
• 2: Set Up Your Config File. Clone this repo and copy examples/example_config.yml to ~/.test_driven_lighting.conf. Edit the file and fill in your HUE settings and your RabbitMQ settings in the bunny config section.
• 3: Start the Listener. If your partner has HUE lights and you do not, you can skip this step. Just run tdl-pairing-start in its own terminal window. Leave this window open and leave the program running. If all is set up correctly, it will listen for events from the RabbitMQ server and change your light(s) accordingly.
• 4: Test Your Listener. Run tdl-test-lighting while you have the listener running. (And/or after your pair has their listener running.) It will go through the run/fail/pending/pass light stages and leave the lights green.
• 5: Run Your Specs With -f LightingFormatter. That's it--you're all set!

gem install test_driven_lighting

Running Tests

bundle exec rspec spec -f LightingFormatter
#=> {'color':'green','type':'test'}`

Include the gem

gem 'test_driven_lighting'

Example Receiver Code

require 'test_driven_lighting'
include TestDrivenLighting

hue_config = { :hue_ip => '<your_hue_ip>',
               :hue_api_id => '<your_hue_api_id>' }
bunny_config = { :bunny_username => '<bunny_username>',
                 :bunny_password =>'<bunny_password>',
                 :bunny_host => '<bunny_host>'}

hue = Hue.new(hue_config)
lamp = Lamp.new(1)
receiver = Receiver.new(bunny_config)

receiver.listen(`whoami`) do |payload|
    puts "setting bulbs using #{payload}..."
    case payload['status']
    when 'fail'
      lamp.color = 'red'
    when 'pending'
      lamp.color = 'yellow'
    when 'pass'
      lamp.color = 'green'
    end
    hue.change!(lamp)
end

Example Sender Code

require 'test_driven_lighting'
include TestDrivenLighting

bunny_config = { :bunny_username => '<bunny_username>',
                 :bunny_password =>'<bunny_password>',
                 :bunny_host => '<bunny_host>'}

sender = Sender.new(bunny_config)
sender.message_send("fail","test")
sender.message_send("pass","test")
sender.message_send("fail","suite")
sender.close_connection

TODO:

• [ ] MiniTest Formatter
• [ ] MiniTest Pride Formatter - Photosensitive Epilepsy FTW
• [ ] Test::Unit Formatter

Database

Test Driven Lighting does not require any database, but of course we recommend using a SQL Light database. If you've got a magic marker it only takes about ten seconds to set up.

Just make sure it's the right color--I hear mauve has the most RAM.