Test::AutoBuild::Monitor::CommandLine(3pm)

1Test::AutoBuild::MonitoUrs:e:rCoCmomnatnrdiLbiuntee(d3T)Peesrtl::DAouctuomBeunitladt:i:oMnonitor::CommandLine(3)
2
3
4

NAME

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

SYNOPSIS

9         use Test::AutoBuild::Monitor::CommandLine
10
11         my $monitor = Test::AutoBuild::CommandLine->new()
12
13         # Emit some events
14         $monitor->notify("beginStage", "build", time);
15         $monitor->notify("endStage", "build", time, $status);
16

DESCRIPTION

18       This module changes the process command line to reflect the current
19       status. Thus the status can be viewed simply by running the 'ps' com‐
20       mand. For example, after a single beginStage event for stage name
21       'build' it will show
22
23          auto-build [running build]
24
25       After a second beginStage for stage name 'isos'
26
27          auto-build [running build->isos]
28
29       After the second finishes
30
31          auto-build [running build]
32
33       If there is a nested beginBuild event for module 'foo':
34
35          auto-build [running build (foo)]
36
37       etc, etc.
38

CONFIGURATION

40       This module merely uses the standard configuration parameters for
41       "Test::AutoBuild::Monitor", no options are neccessary
42
43       EXAMPLE
44
45         cmd = {
46           label = Command line monitor
47           module = Test::AutoBuild::Monitor::CommandLine
48         }
49

METHODS

51       $monitor->init(%params);
52           This method initializes a new monitor & is called automatically by
53           the "new" method. The %params parameters are passed through from
54           the "new" method.
55
56       $monitor->process($event_name, @args);
57           This method changes the contents of $0 to reflect current build
58           state. It understands the following events (which can be nested):
59           "beginStage", "completeStage", "failStage", "abortStage", "begin‐
60           Build", "endBuild". "beginCheckout", "endCheckout". All other
61           events are ignored.
62

AUTHORS

64       Daniel Berrange <dan@berrange.com>
65

COPYRIGHT

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