Autotest Growl

• Author: Sven Schwyn (www.bitcetera.com)
• Homepage: www.bitcetera.com/products/autotest-growl
• Issues and forum: forge.bitcetera.com/projects/show/autotest-growl

DESCRIPTION:

This gem aims to improve support for Growl notifications by autotest. It comes with a nice and colorful icon sets and supports several testing frameworks on different platforms.

Furthermore the terminal running autotest is cleared on every cycle (unless configured otherwise). Don’t worry though, it’s still possible to scroll up to see the output of previous cycles - at least when using the Terminal.app bundled with Mac OS X.

REQUIREMENTS:

• autotest >= 4.2.4
• Growl >= 1.1.5 on Mac OS X -or-
• Growl for Windows >= 2.0b18 on Windows -or-
• libnotify >= 0.4.5 on Linux

INSTALL:

First install the gem:

  sudo gem install autotest-growl

Then add the following line to your ~/.autotest file:

  require 'autotest/growl'

Growl must be installed on your computer. You can download it from:

Mac OS X: growl.info Windows: growlforwindows.com

On Linux you can use libnotify instead, however, some of the features won’t work. The binary notify-send must be in your PATH:

Linux: www.galago-project.org

If you like this gem, please consider to recommend me on Working with Rails, thank you!

workingwithrails.com/recommendation/new/person/11706-sven-schwyn

UPDATE FROM 0.1.X

As of version 0.2.0 autotest-growl no longer requires the ZenTest gem but the lighter and improved autotest gem. To update do the following:

  sudo gem uninstall ZenTest
  sudo gem update autotest-growl

And only if you need all the functionality of ZenTest:

  sudo gem install zentest-without-autotest

CONFIGURATION:

Priorities

The priority of a notification is set according to the actual result so you can configure Growl to style the notifications differently based on these priorities:

• 2 for error or failed
• 0 for info
• -1 for pending, undefined or unknown
• -2 for passed

Icons

Two icon sets are bundled with this gem:

• ruby (default): The original Ruby logo dressed in traffic light colors.
• ampelmaennchen: The famous traffic light man from the now extinct GDR.

To choose an icon set, add the following to your ~/.autotest:

  Autotest::Growl::image_dir = 'ampelmaennchen'

Using your own icon set is pretty simple. Images should be named as follows: passed.png, pending.png, failed.png, error.png and info.png.

Place these images in a directory of your choosing and specify its location in your ~/.autotest, example:

  Autotest::Growl::image_dir = File.join(ENV['HOME'], '.autotest-growl')

Don’t Clear the Terminal

Add the following to your ~/.autotest if you don’t want the terminal to be cleared before running a test:

  Autotest::Growl::clear_terminal = false

Hide the Label

If you prefer the Growl notifications not to show labels such as "LABEL: All tests have passed", add the following to your ~/.autotest:

  Autotest::Growl::hide_label = true

One Notifications per Run

Allow only one test and one feature notification per run by adding the following to your ~/.autotest:

  Autotest::Growl::one_notification_per_run = true

Show Modified Files

Add the following to your ~/.autotest if you would like to receive a Growl notification listing the files modified before tests are re-run.

  Autotest::Growl::show_modified_files = true

TROUBLESHOOTING:

Loading the Plugin Seems to Fail

The reason may be ZenTest which must not be installed. See "Update from 0.1.X" for more on this.

Unreliable Growl Notifications on Mac OS X

Under some circumstances, Growl notifications seem to be swallowed randomly on Mac OS X. If this happens to you, try the following.

Add this to your ~/.autotest:

  Autotest::Growl::remote_notification = true

Now open "System Preferences -> Growl -> Network" and set the checkboxes "Listen for incoming notifications" and "Allow remote application registration”. Try whether remote notifications work with the following test:

  find /Library/Ruby /usr -name growlnotify -exec {} -H localhost -n autotest -m ok \;

If you get a NSPortTimeoutException, you should restart Growl and check whether a firewall is blocking the connection. Once the notification is displayed, go back to the System Preferences and disable the checkbox "Allow remote application registration" again.

No Notifications on Mac OS X 10.5

If you are still on Leopard and notifications don’t work for you, get your hands dirty and remove the "-n Autotest" argument from growl.rb. Make sure you submit a bug or comment on a related and existing bug, too.

DEVELOPMENT:

You can install the bleeding edge version as follows:

  git clone git://github.com/svoop/autotest-growl.git
  cd autotest-growl
  rake build
  sudo rake install

Please submit issues on:

forge.bitcetera.com/projects/show/autotest-growl

To contribute code, fork the project on Github, add your code and submit a pull request:

github.com/guides/fork-a-project-and-submit-your-modifications

CONTRIBUTIONS:

Thanks to the following folks who have contributed to this project:

• Michael Moen
• Graham Savage
• Karl O’Keeffe
• Konstantin Haase
• J. Edward Dewyea
• Martin Vielsmaier

LICENSE:

(The MIT License)

Copyright © 2009 Sven Schwyn

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.