/usr/share/slsh/local-packages/help/tess.hlp is in slang-tess 0.3.0-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 | tess
DESCRIPTION
TESS is the (Te)st (S)ystem for (S)-Lang, which aims at reducing the
workload and ad-hoc nature of regression testing S-Lang software by
by collecting common testing elements into a single, easy-to-use
framework. TESS provides the S-Lang developer nominal mechanisms
for tailoring the S-Lang environment and invoking functions with
arbitrary inputs, while transparently inspecting and cleaning the
stack, gathering pass/fail statistics, and providing error recovery
from exceptions.
Copyright (C) 2004-2007 Massachusetts Institute of Technology
Michael S. Noble <mnoble@space.mit.edu>
SEE ALSO
tess_invoke, tess_summary, tess_add_eval_paths
--------------------------------------------------------------
tess_auto_summarize
SYNOPSIS
Turn automatic test suite summarization on or off
USAGE
tess_add_eval_paths( [0 | 1.])
DESCRIPTION
NOTES
SEE ALSO
tess_summary
--------------------------------------------------------------
tess_add_eval_paths
SYNOPSIS
Add one or more directories to the S-Lang evalfile() search path
USAGE
tess_add_eval_paths( path1, [path2, ...])
DESCRIPTION
This function is a convenience wrapper around the set_slang_load_path()
function, making it cleaner and simpler to augment the list of directories
searched by the S-Lang interpreter when evalfile() is invoked with an
ambiguous file specification.
NOTES
TESS automatically appends the current working directory, as well as ../src,
../share, and ../packages to the load path.
SEE ALSO
tess_add_import_paths
--------------------------------------------------------------
tess_add_import_paths
SYNOPSIS
Add one or more directories to the S-Lang import() search path
USAGE
tess_add_import_paths( path1, [path2, ...])
DESCRIPTION
This function is a convenience wrapper around the set_import_module_path()
function, making it cleaner and simpler to augment the list of directories
searched by the S-Lang interpreter when import() is invoked.
NOTES
TESS automatically appends ../src to the import path.
SEE ALSO
tess_add_eval_paths
--------------------------------------------------------------
tess_catch_type_errors
SYNOPSIS
Give S-Lang ERROR block mechanism the ability to catch type mismatch errors
USAGE
tess_catch_type_errors( [yes_or_no] )
DESCRIPTION
This function augments the S-Lang ERROR block mechanism, giving it the
ability to catch type mismatch exceptions (which S-Lang 1.x formally
considers uncatchably fatal). This feature is useful for a test
framework, since it allows functions to be safely exercised against
a wide variety of types.
If the first passed argument evaluates to a boolean TRUE then the function
will enable type error catching. If either zero arguments are passed,
or the first argument evaluates to boolean FALSE, then type error catching
will be disabled.
NOTES
This function is deprecated, as in S-Lang 2 all exceptions may be caught.
SEE ALSO
tess_invoke
--------------------------------------------------------------
tess_invoke
SYNOPSIS
Execute a test case
USAGE
tess_invoke( expected_to_fail, function_ref [, arg1, arg2, ...])
DESCRIPTION
Invoke the given function (by dereference), optionally passing in one
or more arguments. The first parameter, whose value should be either
zero or one, indicates whether the function is expected to signal an
error when invoked in the manner given.
If the actual result of the call matches the expected result then the test
case is said to "pass," otherwise it is said to "fail". It is important
to understand this: a failed test case is not indicated by an error
signal itself, but rather by whether or not the test case expected an
error to be signaled.
NOTES
SEE ALSO
tess_catch_type_errors, tess_summary
--------------------------------------------------------------
tess_load_component
SYNOPSIS
Evaluate the named S-Lang script, and set the test component name accordingly
USAGE
tess_load_component(filename)
DESCRIPTION
This function attempts to evalfile() the named script, using the usual
S-Lang load mechansism, and will set the TESS test component name to
the filename if found.
The test component name is printed in the heading of results summaries,
and uniquely identifies a given test script. Typically the test component
name is set to the "basename" of the test script itself (e.g. a script
add.t sets Component = "add"). This function provides a means of
customizing that default behavior while loading additional functionality
to be exercised within the test script.
NOTES
SEE ALSO
--------------------------------------------------------------
tess_summary
SYNOPSIS
Summarize the results of a suite of tests
USAGE
Integer_Type tess_summary()
DESCRIPTION
TESS automatically records the pass/fail result of each test case
executed by tess_invoke. By default the results of this tally
are emitted to stdout when tess_summary is called, although this may
be disabled by calling tess_auto_summarize(0). The return value
indicates the number of failed tests.
NOTES
Under normal circumstances it should not be necessary to call this
function explicitly, since TESS transparently installs an exit handler
which calls tess_summary at application termination. Its return value
is then passed to the operating so that, for example, a non-zero status
may be used to fatally terminate a "make test" goal.
SEE ALSO
tess_invoke
--------------------------------------------------------------
|