build_status_server 0.4

data/Gemfile

@@ -0,0 +1,14 @@
+source :rubygems
+
+gemspec
+
+gem "json"
+
+group :test do
+  gem "rspec"
+end
+
+group :development do
+  gem "ruby-debug"
+  gem "sinatra"
+end

data/Gemfile.lock

@@ -0,0 +1,46 @@
+PATH
+  remote: .
+  specs:
+    build_status_server (0.3)
+      json
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    columnize (0.3.6)
+    diff-lcs (1.1.3)
+    json (1.6.5)
+    linecache (0.46)
+      rbx-require-relative (> 0.0.4)
+    rack (1.4.0)
+    rack-protection (1.2.0)
+      rack
+    rbx-require-relative (0.0.5)
+    rspec (2.9.0)
+      rspec-core (~> 2.9.0)
+      rspec-expectations (~> 2.9.0)
+      rspec-mocks (~> 2.9.0)
+    rspec-core (2.9.0)
+    rspec-expectations (2.9.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.9.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    sinatra (1.3.2)
+      rack (~> 1.3, >= 1.3.6)
+      rack-protection (~> 1.2)
+      tilt (~> 1.3, >= 1.3.3)
+    tilt (1.3.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  build_status_server!
+  json
+  rspec
+  ruby-debug
+  sinatra

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Juan C. Muller <jcmuller@gmail.com>
+
+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,45 @@
+# Build Notifier
+
+This utility is part of an XFD (eXtreeme Feedback Device) solution designed and
+built for my employer [ChallengePost](http://challengepost.com). It works in
+conjunction with our [Jenkins](http://jenkins-ci.org) Continuous Integration
+server (and its
+[Notification Plugin](https://wiki.jenkins-ci.org/display/JENKINS/Notification+Plugin))
+and an [Arduino](http://arduino.cc) powered
+[Traffic Light controller](https://github.com/jcmuller/TrafficLightController)
+with a
+pseudo-[REST](http://en.wikipedia.org/wiki/Representational_state_transfer)ful
+API.
+
+To run, you need to copy `config/config-example.yml` into `config/config.yml`
+and mofify accordingly.
+
+# Configuration file
+## UDP Server
+This section defines what interface and port should the UDP server listen at.
+The Jenkins' Notification Plugin should be set to this parameters as well.
+
+## TCP Client
+This section is where we tell the server how to communicate with the web
+enabled XFD. In the example case, there is a web server running somewhere
+listening on port 4567 that responds to `/green` and `/red`.
+
+On our installation, this represents the Traffic Light's Arduino web server.
+
+## Store
+Where the persistent state will be stored.
+
+## Mask (optional)
+You can decide to either include or ignore certain builds whose names match a
+given [Regular Expression](http://en.wikipedia.org/wiki/Regular_expression).
+
+# Development
+
+`bin/build_status_server_traffic_light_mock` is provided for development
+purposes only.
+
+# Finished product
+![my image](http://i.imgur.com/aK5rs.jpg)
+
+# Wiring the traffic light
+![my image](http://i.imgur.com/gUpWe.jpg)

data/bin/build_status_server

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+
+require 'getoptlong'
+
+possible_arguments = [
+  ['--config', '-c', GetoptLong::OPTIONAL_ARGUMENT],
+  ['--development', '-d', GetoptLong::NO_ARGUMENT],
+  ['--help', '-h', GetoptLong::NO_ARGUMENT],
+  ['--verbose', '-v', GetoptLong::NO_ARGUMENT]
+]
+
+opts = GetoptLong.new(*possible_arguments)
+
+options = {}
+showhelp = false
+
+opts.each do |opt, arg|
+  case opt
+  when '--development'
+    $:.push 'lib'
+  when '--help'
+    puts <<-EOT
+    #{File.basename(__FILE__)} [#{possible_arguments.map{|arg| arg[0] + (arg[2] == GetoptLong::OPTIONAL_ARGUMENT ? ' argument' : '')}.join('], [')}]
+
+    All the arguments are optional.
+
+      --config, -c      Specify what configuration file to load
+      --development, -d Whether we should load libraries from ./lib
+      --help, -h        Display this very helpful text
+      --verbose, -v     Be more informative about what's going on
+
+    EOT
+    exit
+  when '--config'
+    options[:config] = arg
+  when '--verbose'
+    options[:verbose] = true
+  end
+end
+
+require 'build_status_server'
+
+BuildStatusServer::Server.new(options).listen

data/build_status_server.gemspec

@@ -0,0 +1,29 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "build_status_server/version"
+
+Gem::Specification.new do |s|
+  s.name = "build_status_server"
+  s.version = BuildStatusServer::VERSION
+  s.platform = Gem::Platform::RUBY
+
+  s.author = "Juan C. Muller"
+  s.email = "jcmuller@gmail.com"
+  s.homepage = "http://github.com/jcmuller/build_status_server"
+  s.license = "GPL"
+  s.summary = "A build notifier server for Jenkins CI that controls an XFD over HTTP"
+  s.description = "A build notifier server for Jenkins CI that controls an XFD over HTTP"
+
+  s.files = Dir["{lib/**/*,spec/**/*}"] + %w(bin/build_status_server config/config-example.yml LICENSE README.md Gemfile Gemfile.lock build_status_server.gemspec)
+  s.require_path = "lib"
+  s.bindir = "bin"
+  s.executables = %w(build_status_server)
+
+  s.homepage = "http://github.com/jcmuller/build_status_server"
+  s.test_files = Dir["spec/**/*_spec.rb"]
+
+  s.add_development_dependency("ruby-debug")
+  s.add_development_dependency("sinatra")
+
+  s.add_dependency("json")
+end
+

data/config/config-example.yml

@@ -0,0 +1,14 @@
+    udp_server:
+      address: '127.0.0.1'
+      port: 1234
+    tcp_client:
+      host: '127.0.0.1'
+      port: 4567
+      pass: "/green"
+      fail: "/red"
+    store:
+      filename: "/tmp/build_result.yml"
+    mask:
+      regex: ".*master.*"
+      policy: "include"
+    verbose: true

data/lib/build_status_server/requirements.rb~

@@ -0,0 +1,8 @@
+require "rubygems"
+require "bundler/setup"
+
+Bundler.require(:default)
+
+require "socket"
+require "timeout"
+require "yaml"

data/lib/build_status_server/server.rb

@@ -0,0 +1,199 @@
+module BuildStatusServer
+  class Server
+    attr_reader   :config, :store_file, :mask_policy, :verbose
+    attr_accessor :store, :mask
+
+    def initialize(options = {})
+      load_config_file(options[:config])
+      @verbose     = options[:verbose] || config["verbose"]
+      @store_file  = File.expand_path(".", config["store"]["filename"])
+      @mask        = Regexp.new(config["mask"]["regex"])
+      @mask_policy = config["mask"]["policy"] || "exclude"
+    end
+
+    def load_store
+      @store = begin
+                 YAML.load_file(store_file)
+               rescue
+                 {}
+               end
+      @store = {} unless store.class == Hash
+    end
+
+    def listen
+      sock = UDPSocket.new
+      udp_server = config["udp_server"]
+
+      begin
+        sock.bind(udp_server["address"], udp_server["port"])
+      rescue Errno::EADDRINUSE
+        STDERR.puts <<-EOT
+There appears that another instance is running, or another process
+is listening at the same port (#{udp_server["address"]}:#{udp_server["port"]}
+
+        EOT
+        exit
+      end
+
+      puts "Listening on UDP #{udp_server["address"]}:#{udp_server["port"]}" if verbose
+
+      while true
+        data, addr = sock.recvfrom(2048)
+        #require "ruby-debug"; debugger
+        if process_job(data)
+          status = process_all_statuses
+          notify(status)
+        end
+      end
+
+      sock.close
+    end
+
+    def process_job(data = "{}")
+      job = JSON.parse(data)
+
+      build_name = job["name"]
+
+      unless should_process_build(build_name)
+        STDOUT.puts "Ignoring #{build_name} (#{mask}--#{mask_policy})" if verbose
+        return false
+      end
+
+      if job.class != Hash or
+        job["build"].class != Hash
+        STDERR.puts "Pinged with an invalid payload"
+        return false
+      end
+
+      phase      = job["build"]["phase"]
+      status     = job["build"]["status"]
+
+      if phase == "FINISHED"
+        STDOUT.puts "Got #{status} for #{build_name} on #{Time.now} [#{job.inspect}]" if verbose
+        case status
+        when "SUCCESS", "FAILURE"
+          load_store
+          store[build_name] = status
+          File.open(store_file, "w") { |file| YAML.dump(store, file) }
+          return true
+        end
+      else
+        STDOUT.puts "Started for #{build_name} on #{Time.now} [#{job.inspect}]" if verbose
+      end
+
+      return false
+    end
+
+    # Ensure config file exists. If not, copy example into it
+    def load_config_file(config_file)
+      curated_file = nil
+
+      if config_file
+        f = File.expand_path(config_file)
+        if File.exists?(f)
+          curated_file = f
+        else
+          puts "Supplied config file (#{config_file}) doesn't seem to exist" if verbose
+          exit
+        end
+      else
+        locations_to_try = %w(
+          ~/.config/build_status_server/config.yml
+          config/config.yml
+          /etc/build_status_server/config.yml
+          /usr/local/etc/build_status_server/config.yml
+        )
+
+        locations_to_try.each do |possible_conf_file|
+          f = File.expand_path(possible_conf_file)
+          if File.exists?(f)
+            puts "Using #{possible_conf_file}!" if verbose if verbose
+            curated_file = f
+            break
+          end
+        end
+
+        puts <<-EOT
+  Looks like there isn't an available configuration file for this program. You
+  can create one in any of the following locations:
+
+   #{locations_to_try.map{|l| File.expand_path(l)}.join("\n   ")}
+
+   Here is a sample of the contents for that file:
+
+#{File.open("#{File.dirname(File.expand_path(__FILE__))}/../../config/config-example.yml").read}
+
+        EOT
+
+        exit
+      end
+
+      puts "Using #{curated_file}!" if verbose
+      @config = YAML.load_file(curated_file)
+    end
+
+    def should_process_build(build_name)
+      # If mask exists, then ...
+      ! (!!mask && ((mask_policy == "include" && build_name !~ mask) ||
+                    (mask_policy != "include" && build_name =~ mask)))
+    end
+
+    def process_all_statuses
+      pass = true
+
+      @store.values.each do |val|
+        pass &&= (val == "pass" || val == "SUCCESS")
+      end
+
+      pass
+    end
+
+    def notify(status)
+      tcp_client = config["tcp_client"]
+
+      attempts = 0
+      light  = status ? tcp_client["pass"] : tcp_client["fail"]
+
+      begin
+        timeout(5) do
+          attempts += 1
+          client = TCPSocket.new(tcp_client["host"], tcp_client["port"])
+          client.print "GET #{light} HTTP/1.0\n\n"
+          answer = client.gets(nil)
+          STDOUT.puts answer if verbose
+          client.close
+        end
+      rescue Timeout::Error => ex
+        STDERR.puts "Error: #{ex} while trying to send #{light}"
+        retry unless attempts > 2
+      rescue Errno::ECONNREFUSED, Errno::EHOSTUNREACH => ex
+        STDERR.puts "Error: #{ex} while trying to send #{light}"
+        STDERR.puts "Will wait for 2 seconds and try again..."
+        sleep 2
+        retry unless attempts > 2
+      end
+    end
+  end
+end
+
+__END__
+
+Example payload:
+{
+  "name":"test",
+  "url":"job/test/",
+  "build":{
+    "full_url":"http://cronus.local:3001/job/test/20/",
+    "number":20,
+    "phase":"FINISHED",
+    "status":"SUCCESS",
+    "url":"job/test/20/"
+  }
+}
+
+We're getting this error once in a while:
+/usr/local/lib/ruby/1.8/timeout.rb:64:in `notify': execution expired (Timeout::Error)
+        from /home/jcmuller/build_notifier/lib/server.rb:102:in `notify'
+        from /home/jcmuller/build_notifier/lib/server.rb:33:in `listen'
+        from bin/server:5
+

data/lib/build_status_server/server.rb~

@@ -0,0 +1,189 @@
+module BuildStatusServer
+  class Server
+    attr_reader   :config, :store_file, :mask_policy, :verbose
+    attr_accessor :store, :mask
+
+    def initialize(options = {})
+      load_config_file(options[:config])
+      @verbose     = options[:verbose] || config["verbose"]
+      @store_file  = File.expand_path(".", config["store"]["filename"])
+      @mask        = Regexp.new(config["mask"]["regex"])
+      @mask_policy = config["mask"]["policy"] || "exclude"
+    end
+
+    def load_store
+      @store = begin
+                 YAML.load_file(store_file)
+               rescue
+                 {}
+               end
+      @store = {} unless store.class == Hash
+    end
+
+    def listen
+      sock = UDPSocket.new
+      udp_server = config["udp_server"]
+      sock.bind(udp_server["address"], udp_server["port"])
+
+      puts "Listening on UDP #{udp_server["address"]}:#{udp_server["port"]}" if verbose
+
+      while true
+        data, addr = sock.recvfrom(2048)
+        #require "ruby-debug"; debugger
+        if process_job(data)
+          status = process_all_statuses
+          notify(status)
+        end
+      end
+
+      sock.close
+    end
+
+    def process_job(data = "{}")
+      job = JSON.parse(data)
+
+      build_name = job["name"]
+
+      unless should_process_build(build_name)
+        STDOUT.puts "Ignoring #{build_name} (#{mask}--#{mask_policy})" if verbose
+        return false
+      end
+
+      if job.class != Hash or
+        job["build"].class != Hash
+        STDERR.puts "Pinged with an invalid payload"
+        return false
+      end
+
+      phase      = job["build"]["phase"]
+      status     = job["build"]["status"]
+
+      if phase == "FINISHED"
+        STDOUT.puts "Got #{status} for #{build_name} on #{Time.now} [#{job.inspect}]" if verbose
+        case status
+        when "SUCCESS", "FAILURE"
+          load_store
+          store[build_name] = status
+          File.open(store_file, "w") { |file| YAML.dump(store, file) }
+          return true
+        end
+      else
+        STDOUT.puts "Started for #{build_name} on #{Time.now} [#{job.inspect}]" if verbose
+      end
+
+      return false
+    end
+
+    # Ensure config file exists. If not, copy example into it
+    def load_config_file(config_file)
+      curated_file = nil
+
+      if config_file
+        f = File.expand_path(config_file)
+        if File.exists?(f)
+          curated_file = f
+        else
+          puts "Supplied config file (#{config_file}) doesn't seem to exist" if verbose
+          exit
+        end
+      else
+        locations_to_try = %w(
+          ~/.config/build_status_server/config.yml
+          config/config.yml
+          /etc/build_status_server/config.yml
+          /usr/local/etc/build_status_server/config.yml
+        )
+
+        locations_to_try.each do |possible_conf_file|
+          f = File.expand_path(possible_conf_file)
+          if File.exists?(f)
+            puts "Using #{possible_conf_file}!" if verbose if verbose
+            curated_file = f
+            break
+          end
+        end
+
+        puts <<-EOT
+  Looks like there isn't an available configuration file for this program. You
+  can create one in any of the following locations:
+
+   #{locations_to_try.map{|l| File.expand_path(l)}.join("\n   ")}
+
+   Here is a sample of the contents for that file:
+
+#{File.open("#{File.dirname(File.expand_path(__FILE__))}/../../config/config-example.yml").read}
+
+        EOT
+
+        exit
+      end
+
+      puts "Using #{curated_file}!" if verbose
+      @config = YAML.load_file(curated_file)
+    end
+
+    def should_process_build(build_name)
+      # If mask exists, then ...
+      ! (!!mask && ((mask_policy == "include" && build_name !~ mask) ||
+                    (mask_policy != "include" && build_name =~ mask)))
+    end
+
+    def process_all_statuses
+      pass = true
+
+      @store.values.each do |val|
+        pass &&= (val == "pass" || val == "SUCCESS")
+      end
+
+      pass
+    end
+
+    def notify(status)
+      tcp_client = config["tcp_client"]
+
+      attempts = 0
+      light  = status ? tcp_client["pass"] : tcp_client["fail"]
+
+      begin
+        timeout(5) do
+          attempts += 1
+          client = TCPSocket.new(tcp_client["host"], tcp_client["port"])
+          client.print "GET #{light} HTTP/1.0\n\n"
+          answer = client.gets(nil)
+          STDOUT.puts answer if verbose
+          client.close
+        end
+      rescue Timeout::Error => ex
+        STDERR.puts "Error: #{ex} while trying to send #{light}"
+        retry unless attempts > 2
+      rescue Errno::ECONNREFUSED, Errno::EHOSTUNREACH => ex
+        STDERR.puts "Error: #{ex} while trying to send #{light}"
+        STDERR.puts "Will wait for 2 seconds and try again..."
+        sleep 2
+        retry unless attempts > 2
+      end
+    end
+  end
+end
+
+__END__
+
+Example payload:
+{
+  "name":"test",
+  "url":"job/test/",
+  "build":{
+    "full_url":"http://cronus.local:3001/job/test/20/",
+    "number":20,
+    "phase":"FINISHED",
+    "status":"SUCCESS",
+    "url":"job/test/20/"
+  }
+}
+
+We're getting this error once in a while:
+/usr/local/lib/ruby/1.8/timeout.rb:64:in `notify': execution expired (Timeout::Error)
+        from /home/jcmuller/build_notifier/lib/server.rb:102:in `notify'
+        from /home/jcmuller/build_notifier/lib/server.rb:33:in `listen'
+        from bin/server:5
+

data/lib/build_status_server/version.rb

@@ -0,0 +1,3 @@
+module BuildStatusServer
+  VERSION = "0.4"
+end

data/lib/build_status_server/version.rb~

@@ -0,0 +1,3 @@
+module BuildStatusServer
+  VERSION = "0.4"
+end

data/lib/build_status_server.rb

@@ -0,0 +1,10 @@
+require "rubygems"
+require "json"
+require "sinatra"
+require "socket"
+require "timeout"
+require "yaml"
+
+module BuildStatusServer
+  autoload :Server, 'build_status_server/server'
+end

data/lib/build_status_server.rb~

@@ -0,0 +1,11 @@
+require "rubygems"
+require "getoptlong"
+require "json"
+require "sinatra"
+require "socket"
+require "timeout"
+require "yaml"
+
+module BuildStatusServer
+  autoload :Server, 'build_status_server/server'
+end

data/spec/lib/build_status_server_spec.rb

@@ -0,0 +1,124 @@
+$:.push File.expand_path("lib", __FILE__)
+
+require 'spec_helper'
+require 'build_status_server'
+
+describe BuildStatusServer::Server, :pending => true do
+  let!(:server) { BuildStatusServer::Server.new(:config => '/dev/null') }
+
+  describe "#load_config_file" do
+    it "should use the supplied argument" do
+      config_file = '/dev/null'
+      File.should_receive(:exists?).and_return(true)
+      server.load_config_file(config_file)
+    end
+  end
+
+  describe "#load_store" do
+
+    before do
+      server.stub!(:store_file).and_return("/tmp/build")
+    end
+
+    it "initializes an empty hash if store file doesn't exist" do
+      server.load_store
+      server.store.should == {}
+    end
+
+    it "initializes an empty hash if store file is empty" do
+      require "tempfile"
+      f = Tempfile.new("server_spec")
+      server.stub!(:store_file).and_return(f.path)
+
+      server.load_store
+      server.store.should == {}
+    end
+
+    it "initializes a hash with the contents of the store file" do
+      server.stub!(:store_file).and_return("spec/support/build_result.yml")
+      server.load_store
+
+      server.store.should == {"blah" => "SUCCESS", "test" => "SUCCESS"}
+    end
+  end
+
+  describe "#notify"
+  describe "#process_all_statuses"
+  describe "#process_job"
+
+  describe "#should_process_build" do
+    context "when mask exists" do
+      before do
+        server.stub!(:mask).and_return(/.*master.*/)
+      end
+
+      context "when policy is include" do
+        before do
+          server.stub!(:mask_policy).and_return("include")
+        end
+
+        it "ignores builds if mask doesn't match build name" do
+          server.should_process_build("blah-development").should be_false
+        end
+
+        it "processes builds if mask matches build name" do
+          server.should_process_build("blah-master").should be_true
+        end
+      end
+
+      context "when policy is exclude" do
+        before do
+          server.stub!(:mask_policy).and_return("exclude")
+        end
+
+        it "ignores builds if mask matches build name" do
+          server.should_process_build("blah-master").should be_false
+        end
+
+        it "processes builds if mask doesn't match build name" do
+          server.should_process_build("blah-development").should be_true
+        end
+      end
+
+      context "when policy is undefined" do
+        before do
+          server.stub!(:mask_policy).and_return(nil)
+        end
+
+        it "ignores builds if mask matches build name" do
+          server.should_process_build("blah-master").should be_false
+        end
+
+        it "processes builds if mask doesn't match build name" do
+          server.should_process_build("blah-development").should be_true
+        end
+      end
+
+      context "when policy is unexpected" do
+        before do
+          server.stub!(:mask_policy).and_return("trash")
+        end
+
+        it "ignores builds if mask matches build name" do
+          server.should_process_build("blah-master").should be_false
+        end
+
+        it "processes builds if mask doesn't match build name" do
+          server.should_process_build("blah-development").should be_true
+        end
+      end
+    end
+
+    context "when mask doesn't" do
+      before do
+        server.stub!(:mask).and_return(nil)
+      end
+
+      it "should process all jobs" do
+        server.should_process_build("blah-development").should be_true
+      end
+    end
+  end
+end
+
+# vim:set foldmethod=syntax foldlevel=1:

data/spec/lib/build_status_server_spec.rb~

@@ -0,0 +1,124 @@
+$:.push File.expand_path("lib", __FILE__)
+
+require 'spec_helper'
+require 'build_status_server'
+
+describe BuildStatusServer::Server do
+  let!(:server) { BuildStatusServer::Server.new(:config => '/dev/null') }
+
+  describe "#load_config_file" do
+    it "should use the supplied argument" do
+      config_file = '/dev/null'
+      File.should_receive(:exists?).and_return(true)
+      server.load_config_file(config_file)
+    end
+  end
+
+  describe "#load_store" do
+
+    before do
+      server.stub!(:store_file).and_return("/tmp/build")
+    end
+
+    it "initializes an empty hash if store file doesn't exist" do
+      server.load_store
+      server.store.should == {}
+    end
+
+    it "initializes an empty hash if store file is empty" do
+      require "tempfile"
+      f = Tempfile.new("server_spec")
+      server.stub!(:store_file).and_return(f.path)
+
+      server.load_store
+      server.store.should == {}
+    end
+
+    it "initializes a hash with the contents of the store file" do
+      server.stub!(:store_file).and_return("spec/support/build_result.yml")
+      server.load_store
+
+      server.store.should == {"blah" => "SUCCESS", "test" => "SUCCESS"}
+    end
+  end
+
+  describe "#notify"
+  describe "#process_all_statuses"
+  describe "#process_job"
+
+  describe "#should_process_build" do
+    context "when mask exists" do
+      before do
+        server.stub!(:mask).and_return(/.*master.*/)
+      end
+
+      context "when policy is include" do
+        before do
+          server.stub!(:mask_policy).and_return("include")
+        end
+
+        it "ignores builds if mask doesn't match build name" do
+          server.should_process_build("blah-development").should be_false
+        end
+
+        it "processes builds if mask matches build name" do
+          server.should_process_build("blah-master").should be_true
+        end
+      end
+
+      context "when policy is exclude" do
+        before do
+          server.stub!(:mask_policy).and_return("exclude")
+        end
+
+        it "ignores builds if mask matches build name" do
+          server.should_process_build("blah-master").should be_false
+        end
+
+        it "processes builds if mask doesn't match build name" do
+          server.should_process_build("blah-development").should be_true
+        end
+      end
+
+      context "when policy is undefined" do
+        before do
+          server.stub!(:mask_policy).and_return(nil)
+        end
+
+        it "ignores builds if mask matches build name" do
+          server.should_process_build("blah-master").should be_false
+        end
+
+        it "processes builds if mask doesn't match build name" do
+          server.should_process_build("blah-development").should be_true
+        end
+      end
+
+      context "when policy is unexpected" do
+        before do
+          server.stub!(:mask_policy).and_return("trash")
+        end
+
+        it "ignores builds if mask matches build name" do
+          server.should_process_build("blah-master").should be_false
+        end
+
+        it "processes builds if mask doesn't match build name" do
+          server.should_process_build("blah-development").should be_true
+        end
+      end
+    end
+
+    context "when mask doesn't" do
+      before do
+        server.stub!(:mask).and_return(nil)
+      end
+
+      it "should process all jobs" do
+        server.should_process_build("blah-development").should be_true
+      end
+    end
+  end
+end
+
+# vim:set foldmethod=syntax foldlevel=1:

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper.rb"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require "rspec/core"
+require "rspec/mocks"
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

data/spec/spec_helper.rb~

@@ -0,0 +1,15 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper.rb"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+#require "rspec/core"
+#require "rspec/mocks"
+#
+#RSpec.configure do |config|
+#  config.treat_symbols_as_metadata_keys_with_true_values = true
+#  config.run_all_when_everything_filtered = true
+#  config.filter_run :focus
+#end

data/spec/support/build_result.yml

@@ -0,0 +1,3 @@
+--- 
+blah: SUCCESS
+test: SUCCESS

data/spec/support/sample.json

@@ -0,0 +1,11 @@
+{
+  "name":"test-master",
+  "url":"job/test/",
+  "build":{
+    "full_url":"http://cronus.local:3001/job/test/20/",
+    "number":20,
+    "phase":"FINISHED",
+    "status":"SUCCESS",
+    "url":"job/test/21/"
+  }
+}

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification 
+name: build_status_server
+version: !ruby/object:Gem::Version 
+  hash: 3
+  prerelease: 
+  segments: 
+  - 0
+  - 4
+  version: "0.4"
+platform: ruby
+authors: 
+- Juan C. Muller
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-04-26 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruby-debug
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: A build notifier server for Jenkins CI that controls an XFD over HTTP
+email: jcmuller@gmail.com
+executables: 
+- build_status_server
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/build_status_server/requirements.rb~
+- lib/build_status_server/server.rb
+- lib/build_status_server/server.rb~
+- lib/build_status_server/version.rb
+- lib/build_status_server/version.rb~
+- lib/build_status_server.rb
+- lib/build_status_server.rb~
+- spec/lib/build_status_server_spec.rb
+- spec/lib/build_status_server_spec.rb~
+- spec/spec_helper.rb
+- spec/spec_helper.rb~
+- spec/support/build_result.yml
+- spec/support/sample.json
+- bin/build_status_server
+- config/config-example.yml
+- LICENSE
+- README.md
+- Gemfile
+- Gemfile.lock
+- build_status_server.gemspec
+has_rdoc: true
+homepage: http://github.com/jcmuller/build_status_server
+licenses: 
+- GPL
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A build notifier server for Jenkins CI that controls an XFD over HTTP
+test_files: 
+- spec/lib/build_status_server_spec.rb