NAME

Test::AutoBuild::Monitor::CommandLine - Monitor progress from 'ps'

SYNOPSIS

  use Test::AutoBuild::Monitor::CommandLine

  my $monitor = Test::AutoBuild::CommandLine->new()

  # Emit some events
  $monitor->notify("beginStage", "build", time);
  $monitor->notify("endStage", "build", time, $status);

DESCRIPTION

This module changes the process command line to reflect the current status. Thus the status can be viewed simply by running the 'ps' command. For example, after a single beginStage event for stage name 'build' it will show

   auto-build [running build]

After a second beginStage for stage name 'isos'

   auto-build [running build->isos]

After the second finishes

   auto-build [running build]

If there is a nested beginBuild event for module 'foo':

   auto-build [running build (foo)]

etc, etc.

CONFIGURATION

This module merely uses the standard configuration parameters for Test::AutoBuild::Monitor, no options are neccessary

EXAMPLE

  cmd = {
    label = Command line monitor
    module = Test::AutoBuild::Monitor::CommandLine
  }

METHODS

$monitor->init(%params);

This method initializes a new monitor & is called automatically by the new method. The %params parameters are passed through from the new method.

$monitor->process($event_name, @args);

This method changes the contents of $0 to reflect current build state. It understands the following events (which can be nested): beginStage, completeStage, failStage, abortStage, beginBuild, endBuild. beginCheckout, endCheckout. All other events are ignored.

AUTHORS

Daniel Berrange <dan@berrange.com>

COPYRIGHT

Copyright (C) 2005 Daniel Berrange <dan@berrange.com>

SEE ALSO

perl(1), Test::AutoBuild::Monitor