NAME
Integrator::Test::ConfigData - Configuration information transfered in the TAP output
VERSION
$Revision: 1.11 $
SYNOPSIS
This module provides test functions to automate measurement and state information gathering from a test script to the TAP output with the intent of loading the information in the Integrator tool from Cydone Solutions. These functions are mostly wrappers around ok functions. See Test::Simple on www.cpan.org as a reference. If you need more information for the TAP format see Test::TAP::Model on www.cpan.org.
Each of these functions is considered a single test statement and must be counted in your test plan. This module is a sub-class of Test::Builder.
#... your typical test.t file ...
#!/usr/bin/perl
# a test to produce a measurement in the TAP output.
my
$fan_speed
= function_that_returns_some_fan_speed();
measure(
'fan speed on FAN1'
,
'FAN_TACH1'
,
$fan_speed
,
'RPM'
, 0.1,
'TACH_123'
);
# a test to declare a component state in the TAP output.
component(
'locking a blade in place'
,
'CPU_BLADE'
,
'SN0010023'
,
'HANDLE'
,
'LOCKED'
);
# a test to store a config file in the TAP output.
config_file(
'last night temperature log'
,
'/var/log/heat.log.00'
);
# a test to store config data in the TAP output.
my
$string
=
'SERIAL_NUMER=1234;18Sept1970'
;
config_data(
'last night temperature log'
,
'serial_number_and_date'
,
$string
);
EXPORT
FUNCTIONS
measure
This function is used to generate integrator_measurement tags in the TAP output. In turn, this data will be interpreted by Cydone Integrator as a measurement. The arguments to the function are:
measurement ( COMMENT, MEASURMENT_NAME, VALUE, UNIT, TOLERANCE, EQUIPMENT );
Where COMMENT, MEASURMENT_NAME and VALUE are required. Fields are evaluated as SCALARs.
If fields are empty, the corresponding values in the test results will be blank, which is valid but not a good practice since the measurement is not traceable.
component
This function is used to generate integrator_component tags in the TAP output. In turn, this data will be interpreted by Cydone Integrator as a component and state declaration. The arguments to the function are:
component ( COMMENT, COMPONENT_NAME, COMPONENT_SERIAL_NUMBER,STATE_NAME, STATE_VALUE );
Where COMMENT and COMPONENT_NAME are required. Fields are evaluated as SCALARs
If fields are empty, the corresponding values in the test results will be blank, which is valid but not a good practice since the declaration is not complete.
config_data
This function is used to attach text data from a string in the TAP output. The string will be encoded and the data will be interpreted by Cydone Integrator as a log file with a name coresponding to the NAME parameter for the current test case. The arguments to the function are:
config_data ( COMMENT, NAME, STRING );
Notes: No string size limit is specified in this version. Use with care...
config_file
This function is used to attach a file in the TAP output. The file will be encoded and the data will be interpreted by Cydone Integrator as a log file for the current test case. The arguments to the function are:
config_file ( COMMENT, FILE_NAME );
Notes: No file size limit is specified in this version. Use with care...
Other Note: If you must specify a file in a different directory, beware that your test might not be portable because different path specifier conventions (forward slashes versus backslashes).
AUTHOR
Cydone Solutions Inc, <fxfx at cydone.com>
BUGS
Please report any bugs or feature requests to bug-integrator-test-configdata at rt.cpan.org
, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Integrator-Test-ConfigData. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Integrator::Test::ConfigData
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
CPAN Ratings
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Integrator-Test-ConfigData
Search CPAN
ACKNOWLEDGEMENTS
COPYRIGHT & LICENSE
Copyright 2007 Cydone Solutions Inc, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.