TetJournal


NAME

TetJournal - Interpret TET Journal File


DESCRIPTION

This class reads a supplied TET journal file and provides methods for interpreting the journal to varying levels of detail.


METHODS

new Create a TetJournal object.
Input: Journal file name Returns: Object handle (zero if error)

dump Return array containing entire journal file
Input: none Returns: @journal array

status Return failure count within journal
Input: none Returns: Number of TPs that did not record a PASS result

nextBlock Fetch next logical block from journal
Input: none Returns: @block array. Unformatted contents of current block

resetBlockPtr Reset block pointer to start of journal
Input: none Returns: empty

blockOutput
Input: none Returns: Output text contained in the current block

blockStatus
Input: none Returns: Failure count within current block (if block is a Test Case)

blockType
Input: none Returns: Text string identifying type of current block. One of: "header","build","TC","clean","scenario" or "unknown"

blockTimes
Input: none Returns: 2 element array of start and end times for current block. Times are in HH:MM:SS format

times
Input: none Returns: 2 element array of start and end times for entire journal

modes
Input: none Returns: Array of tcc execution modes used. (Selected from: 'build', 'execute','clean')

TClist
Input: none Returns: List of Test Cases encountered in journal

TCname
Input: none Returns: Name of test case processed by current block

IClist
Input: Optional test case name. If not specified, current block is used to determine test case (TC). Returns: 1. If test case is specified: Array of all IC numbers processed by all invocations of specified test case 2. If no test case specified: Array of IC numbers processed by current test case

getIC
Input: IC number within current test case. Returns: Array of journal entries for IC

ICpassCount
Input: (Test Case, IC number) Returns: Array of total pass counts for each TP within specified IC

ICrunCount
Input: (Test Case, IC number) Returns: Total number of times this IC has been run

ICstatus
Input: IC number within current test case Returns: Failure count for IC

ICtimes
Input: IC number within current test case Returns: Start and end times for specified IC

TPcount
Input: IC number within current test case Returns: Number of Test Purposes for the specified IC

getTP
Input: (IC number, TP number) Returns: Unformated journal entries for specified Test Purpose

TPresult
Input: (IC number, TP number) Returns: Result code (PASS, FAIL, NORESULT etc) for specified Test Purpose

TPoutput
Input: (IC number, TP number) Returns: Information text for a specified Test Purpose

TPtimes
Input: (IC number, TP number) Returns: Start and End times for specified Test Purpose


AUTHOR

Geoff Smith