NAME

Test::AutoBuild::Monitor::Pipe - Monitor progress through a pipe

SYNOPSIS

  use Test::AutoBuild::Monitor::Pipe

  my $monitor = Test::AutoBuild::Pipe->new(
                      options => {
                        path => "/var/lib/builder/monitor",
                        mode = 0644
                      },
                      env => \%env);

  # Emit some events
  $monitor->notify("begin-stage", "build", time);
  $monitor->notify("end-stage", "build", time, $status);

DESCRIPTION

This module sends events down a pipe, one line per event. The data is formatted in the scheme:

   begin-stage('build', '12450052')
   end-stage('build', '12452345', 'failed')

CONFIGURATION

Along with the standard configuration parameters for Test::AutoBuild::Monitor, this module expects two options to be set:

path

The full path to the FIFO pipe. The pipe will be created if it does not already exist

mask

The permissions mask to use when creating the file, in decimal, not octal. Defaults to 493, which is 0755 in octal, if not specified.

EXAMPLE

  pipe = {
    label = FIFO monitor
    module = Test::AutoBuild::Monitor::Pipe
    options = {
      path = /var/lib/builder/monitor
      # 0755 in decimal
      mask = 493
    }
  }

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 writes the event to the FIFO pipe and flushes the output stream

AUTHORS

Daniel Berrange <dan@berrange.com>

COPYRIGHT

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

SEE ALSO

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