NAME

Agent::TCLI::Package::Tail::Test - A class for an individual test on Lines.

SYNOPSIS

An internal object for storing Agent::TCLI::Test item information. Used to facilitate Agent::TCLI::Test::Tail.

ATTRIBUTES

The following attributes are accessible through standard accessor/mutator methods unless otherwise noted

code

The actual test subroutine to run. sub will only contain Code values.

name

The name of the test, as output on the TAP line. name will only contain scalar values.

max_lines

The number of lines to observe before failing. Defaults to the test_max_lines value in Tail. max_lines will only contain numeric values.

match_times

The number of times the test should match before passing. Defaults to the value of test_matchtimes in Tail. match_times will only contain numeric values.

test_verbose

A flag to make the test output more information. This applies to the test and not to the underlying code which has its own verbose setting. test_verbose will only contain numeric values.

feedback

A value to indicate how frequently the test should report. Zero is for only when complete. One will report on every match.

feedback will only contain Numeric values.

birth_time

The activation time for the test. As a time() value. birth_time will only contain numeric values.

handler

To handle event....

log_name

Name of the SimpleLog event that is being watched. 'none' for no log. log_name will only contain scalar values.

match_count

The counter for the number of times it has matched, or passed. match_count will only contain numeric values.

line_count

A counter for the number of lines seen. line_count will only contain numeric values.

last_line

The last line number processed. last_line will only contain numeric values.

success

A boolean for whether the test passed or failed. success should only contain boolean values.

complete

A boolean that indicates whether the test has completed. complete should only contain boolean values.

num

The relative position within the current test run of all tests. num will only contain numeric values.

ttl

Line time to live. Set as an offset to time() upon creation, so this is the actual time the test should expire. ttl will only contain numeric values.

ordered

A flag indicating if the test is ordered. ordered should only contain boolean values.

request

The TCLI request object that set the test, for returning results. request will only contain Request objects.

METHODS

new ( hash of attributes )

See attributes for their descriptions.

INHERITED METHODS

This module is an Object::InsideOut object that inherits from Agent::TCLI::Base. It inherits methods from both. Please refer to their documentation for more details.

AUTHOR

Eric Hacker <hacker at cpan.org>

BUGS

SHOULDS and MUSTS are currently not enforced.

Test scripts not thorough enough.

Probably many others.

LICENSE

Copyright (c) 2007, Alcatel Lucent, All rights resevred.

This package is free software; you may redistribute it and/or modify it under the same terms as Perl itself.