Introduction

There are lots of stuff we can do to make fun with Continuous Integration. We can make our computer shout 'build-------failed!', or we can make keyboard light blink randomly and quickly, or we just pop up a message to tell ourselves what's happened with build...

CC Monitor works on RSS of CruiseControl. It also can work on any CI Build Tool which provides RSS to report build status. The default rule to assert successful build is rss item title contains 'success', 'fixed' or 'passed'.

"100% CLEAN" Softpedia award

CC Monitor 1.2 released

Fixed bug: can't update widget panel UI when refresh widget panel has error

Changed: command "say" will not be asynchronism

Upgrade: can get committers while monitoring CruiseControl 2.7.x.

CC Monitor 1.1 released

Fixed bug: refresh settings page while configuring setting first time

Upgrade: default notifications including display message by Growl, say and display build status will be triggered asynchronism.

CC Monitor 1.0 released

CC Monitor is upgraded to be a ruby internal DSL runner and needs ruby installed. For previous versions built on javascript eat too much memory and CPU time, the core of CC Monitor is rebuilt on ruby, and the widget will be only used as a view to display build status. After start CC Monitor, a ruby process will be running background.

The simplest script for monitoring a build

observe build mingle => 'http://server/projects/minlge.rss'

This script will display build status icon on your widget.

How CC Monitor works

map committer names:

committers: For user name used to commit code is always abbreviated, you can redefine committer names by keyword 'committers'. The user name should be unique in the script and should not be keywords of CC Monitor DSL and ruby, otherwise please put it into double-quotes, see example below.

define build:

build, def_build: Example: build mingle => 'http://server/projects/minlge.rss', mingle is build name and should be unique so that we can use it later, and it also works with ruby string, 'http://server/projects/minlge.rss' is the rss feed of project.

observe build status:

keep eyes on, keep one eye on, observe, observes: See example below.

get build status and info:

build: Except to defined build, this keyword can used to get build infos when it is inside block of observing build status. See example below.
cant load: Example: say growl build message if cant load build
new?: Return true if it is first time to get the recentest build.
failed?: Return true if the recentest build is failed
succeeded?: Return true if the recentest build is succeeded.
loaded_error?: Return true if cant load build
message: Build message string includes build name and build status.
status: Return 'loaded error', 'succeeded' or 'failed'
link: Return build report link url after loaded build. Return build rss url defined if cant load build
committers: It is parsed from the recentest build rss item description. It is only supported well when observing CruiseControl.rb build now.
refresh: Refresh build status, build will be refreshed automatically when observing it by keywords of observing build status.
rss item title: Return the build rss item title.
rss item description: Return the build rss item description.
succeeded=: Reset build succeeded status, if the default parser can't parse your CruiseControl rss item title correctlly, you can check rss item title by yourself and use this to reset build result.

send out build status message:

display: used to display build status icon or link on widget. Example: display build status icon, display build message link
growl: used to send message to Growl Application. Example: tell growl build message
say: same with "say" on Mac. Example: say build message, committers

any other ruby code

Custom CC Monitor script

committers xli => lee, pwang => wpc, "build" => "bu def"

build mingle => 'http://server/projects/minlge.rss'
build rubyworks => 'http://server/projects/rubyworks.rss'

# the build name followed monitoring keywords should be defined above
keep eyes on mingle, rubyworks do
  display build status icon

  tell growl build message if cant load build

  if build new?
    tell growl build message, committers
    if build succeeded?
      say "stand clear, #{build message, committers}" #use the message and committers info get from build as a string
    else
      say build message, committers
    end
  end
end

previous version 0.6