Previous: testsuite procedure, Up: Core Internal Procedures [Contents][Index]
The testcase procedure is a multiplex call for retrieving or
providing information about the state of the testing process.
The testcase group command provides support for grouping tests
into hierarchical groups within a test script.
Group names are internally tracked as Tcl lists, but are reported as strings delimited using forward slash (‘/’) characters. Individual name elements may not contain whitespace, but may contain forward slash. A group entered by traversing intermediate levels must be left by traversing those same levels. Groups must properly nest.
There are three uses:
testcase group
Return the current group as a string delimited with forward slash (‘/’) characters.
testcase group begin name
testcase group end name
These forms allow a group to be explicitly entered and left. The
name parameter must be identical across a pair of these calls, and
both the begin and end calls must be in the same file.
testcase group eval name {code}
This form is available to wrap the begin and end calls
around the execution of the provided code. This form is preferred
for convenience in top-level scripts, but the begin and
end calls are preferred in helper procedures for performance.