Changeset 9502 in project


Ignore:
Timestamp:
03/12/08 01:06:24 (12 years ago)
Author:
Kon Lovett
Message:

Rmvd fold-* proc from -results. Added 'failure-exit' to -driver.

Location:
wiki
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • wiki/testbase-driver

    r9378 r9502  
    3333    --results-expectation-specifics    Enable inclusion of the actual values for expectation test results
    3434    --results-mode=all|errors|none     How are test results stored [default: errors]
    35     -q, --quiet                        Do not print messages
    36     -v, --verbose                      Print phase messages
    37     -n, --dry-run                      Just show commands to be executed, don't run them
    38     -V, --version                      Display version
    39     -h, --help                         Display this text
     35    --failure-exit=CODE                Upon test failure exit with {{CODE}}
     36-q, --quiet                            Do not print messages
     37-v, --verbose                          Print phase messages
     38-n, --dry-run                          Just show commands to be executed, don't run them
     39-V, --version                          Display version
     40-h, --help                             Display this text
    4041
    4142; test-file : Pathname of test file; missing directory and extension components default to "{{files-repository}}" and "scm".
     
    4445
    4546; results-repository : default  {{(repository-path)}}/testbase/results
     47
    4648=== TestBase Test Results Database
    4749
     
    177179=== Version History
    178180
     181; 1.2.0 : Added 'failure-exit'
    179182; 1.1.0 : 'misc-extn' 3.003 requirement
    180183; 1.0   : Initial release
  • wiki/testbase-results

    r9495 r9502  
    1717==== default-test-file-extension
    1818
    19  [parameter] (default-test-file-extension [EXTENSION])
     19<parameter>(default-test-file-extension [EXTENSION])</parameter>
    2020
    2121Get or set the test file source filename extension. {{EXTENSION}} is a string.
     
    2323==== test-files-directory
    2424
    25  [parameter] (test-files-directory [DIRECTORY])
     25<parameter>(test-files-directory [DIRECTORY])</parameter>
    2626
    2727Get or set the test file source repository directory. {{DIRECTORY}} is an
     
    3030==== test-results-directory
    3131
    32  [parameter] (test-results-directory [DIRECTORY])
     32<parameter>(test-results-directory [DIRECTORY])</parameter>
    3333
    3434Get or set the test file results repository directory. {{DIRECTORY}} is an
     
    4040==== load-test-results-reader-extension
    4141
    42  [procedure] (load-test-results-reader-extension EXTENSIONS)
     42<procedure>(load-test-results-reader-extension EXTENSIONS)</procedure>
    4343
    4444==== test-results-reader-setup
    4545
    46  [procedure] (test-results-reader-setup EXPRESSIONS)
     46<procedure>(test-results-reader-setup EXPRESSIONS)</procedure>
    4747
    4848
     
    5151==== make-test-file-pathname
    5252
    53  [procedure] (make-test-file-pathname FILENAME)
     53<procedure>(make-test-file-pathname FILENAME)</procedure>
    5454
    5555Returns an absolute pathname of a test file for {{FILENAME}}.
     
    5757==== make-test-results-pathname
    5858
    59  [procedure] (make-test-results-pathname FILENAME)
     59<procedure>(make-test-results-pathname FILENAME)</procedure>
    6060
    6161Returns an absolute pathname of a results file for {{FILENAME}}.
     
    6666==== create-test-results-file
    6767
    68  [procedure] (create-test-results-file FILENAME)
     68<procedure>(create-test-results-file FILENAME)</procedure>
    6969
    7070Creates a test results file {{FILENAME}}. If necessary an absolute pathname
     
    7373==== delete-test-results-file
    7474
    75  [procedure] (delete-test-results-file FILENAME)
     75<procedure>(delete-test-results-file FILENAME)</procedure>
    7676
    7777Deletes the test results file {{FILENAME}}. If necessary an absolute pathname
     
    8080==== read-test-results-file
    8181
    82  [procedure] (read-test-results-file FILENAME [FOLD-PROCEDURE])
     82<procedure>(read-test-results-file FILENAME [FOLD-PROCEDURE [INITIAL-VALUE]])</procedure>
    8383
    8484Reads the contents of the test results file {{FILENAME}} and returns the last
     
    8888{{FOLD-PROCEDURE}} is a two argument procedure where the first argument is the
    8989current row and the second argument is the result of the previous call. The
    90 initial second argument is the empty list, {{'()}}. The default procedure is
    91 {{cons}}.
     90initial second argument is the empty list, {{'()}}.
     91
     92Default {{FOLD-PROCEDURE}} is {{cons}}.
     93
     94Default {{INITIAL-VALUE}} is {{'()}}.
    9295
    9396==== append-test-results-row
    9497
    95  [procedure] (append-test-results-row FILENAME ROW [HEADER '()])
     98<procedure>(append-test-results-row FILENAME ROW [HEADER '()])</procedure>
    9699
    97100Write the test results file entry {{ROW}} to the test results file
     
    105108=== Test Results Open Port Procedures
    106109
    107 ==== fold-test-results-rows
    108 
    109  [procedure] (fold-test-results-rows FOLD-PROCEDURE INITIAL-VALUE PORT)
    110 
    111 Calls the {{FOLD-PROCEDURE}} for every test results file entry from the open
    112 input {{PORT}}, passing the current entry and the result of last call, or the
    113 {{INITIAL-VALUE}} when the first call.
    114 
    115110==== read-test-results-rows
    116111
    117  [procedure] (read-test-results-rows PORT [FOLD-PROCEDURE])
     112<procedure>(read-test-results-rows PORT [FOLD-PROCEDURE [INITIAL-VALUE]])</procedure>
    118113
    119114Reads the contents of the test results file from the open input {{PORT}} and
     
    122117{{FOLD-PROCEDURE}} is a two argument procedure where the first argument is the
    123118current row and the second argument is the result of the previous call. The
    124 initial second argument is the empty list, {{'()}}. The default procedure is
    125 {{cons}}.
     119initial second argument is the empty list, {{'()}}.
     120
     121Default {{FOLD-PROCEDURE}} is {{cons}}.
     122
     123Default {{INITIAL-VALUE}} is {{'()}}.
    126124
    127125
     
    130128==== make-test-results-row
    131129
    132  [procedure] (make-test-results-row knd RESULTS . FIELDS)
     130<procedure>(make-test-results-row knd RESULTS . FIELDS)</procedure>
    133131
    134132Returns a test results file entry for the test results {{RESULTS}} and the
     
    137135==== test-results-row-field
    138136
    139  [procedure] (test-results-row-field ROW KEY)
     137<procedure>(test-results-row-field ROW KEY)</procedure>
    140138
    141139Returns the test results file entry {{ROW}} field of the given name {{KEY}}.
     
    143141==== test-results-row-model
    144142
    145  [procedure] (test-results-row-model ROW)
     143<procedure>(test-results-row-model ROW)</procedure>
    146144
    147145Returns the test results file entry {{ROW}} {{model}} field, a string.
     
    149147==== test-results-row-when
    150148
    151  [procedure] (test-results-row-when ROW)
    152 
    153 Returns the test results file entry {{ROW}} {{when}} field, a vector.
     149<procedure>(test-results-row-when ROW)</procedure>
     150
     151Returns the test results file entry {{ROW}} {{when}} field, a vector as
     152returned by {{seconds->local-time}}.
    154153
    155154==== test-results-row-results
    156155
    157  [procedure] (test-results-row-results ROW)
     156<procedure>(test-results-row-results ROW)</procedure>
    158157
    159158Returns the test results file entry {{ROW}} {{results}} field, a list.
     
    164163==== test-results-failures
    165164
    166  [procedure] (test-results-failures RESULTS [TYPE-LIST '(expectation error)])
     165<procedure>(test-results-failures RESULTS [TYPE-LIST '(expectation error)])</procedure>
    167166
    168167Returns a list of the test failures in the {{RESULTS}} list for the given test
     
    173172==== test-results-remove!
    174173
    175  [procedure] (test-results-remove! RESULTS IDENTIFIER-LIST)
     174<procedure>(test-results-remove! RESULTS IDENTIFIER-LIST)</procedure>
    176175
    177176Returns the {{RESULTS}} list with all tests from the {{IDENTIFIER-LIST}}
     
    218217==== make-test-abnormal-exit-result
    219218
    220  [procedure] (make-test-abnormal-exit-result EXIT-CODE ERROR-STRING)
     219<procedure>(make-test-abnormal-exit-result EXIT-CODE ERROR-STRING)</procedure>
    221220 
    222221Returns a test result object that indicates a test process failed.
     
    225224==== test-result-field
    226225
    227  [procedure] (test-result-field RESULT KEY)
     226<procedure>(test-result-field RESULT KEY)</procedure>
    228227
    229228Returns the test result {{RESULT}} field of the given name {{KEY}}.
     
    231230==== test-result-fields
    232231
    233  [procedure] (test-result-fields RESULT [KEY ...])
     232<procedure>(test-result-fields RESULT [KEY ...])</procedure>
    234233
    235234Returns the test result {{RESULT}} fields of the given name {{KEY}} as a list.
     
    237236==== test-result-finding
    238237
    239  [procedure] (test-result-finding RESULT)
     238<procedure>(test-result-finding RESULT)</procedure>
    240239
    241240Returns the test result {{RESULT}} finding field, which could be any object but
     
    245244==== test-result-identifier
    246245
    247  [procedure] (test-result-identifier RESULT)
     246<procedure>(test-result-identifier RESULT)</procedure>
    248247
    249248Returns the test result {{RESULT}} name, message, or id field, which could be
     
    253252==== test-result-passed?
    254253
    255  [procedure] (test-result-passed? RESULT)
     254<procedure>(test-result-passed? RESULT)</procedure>
    256255
    257256Does the test result {{RESULT}} finding field indicate this test passed?
     
    259258==== test-result-type
    260259
    261  [procedure] (test-result-type RESULT)
     260<procedure>(test-result-type RESULT)</procedure>
    262261
    263262Returns the test result {{RESULT}} type field, a symbol.
     
    272271==== print-test-result
    273272
    274  [procedure] (print-test-result RESULT)
     273<procedure>(print-test-result RESULT)</procedure>
    275274
    276275Print the test result {{RESULT}} to the current output port.
     
    278277==== print-test-results
    279278
    280  [procedure] (print-test-results RESULTS)
     279<procedure>(print-test-results RESULTS)</procedure>
    281280
    282281Print the test results list {{RESULTS}} to the current output port.
     
    284283==== print-test-results-row
    285284
    286  [procedure] (print-test-results-row ROW)
     285<procedure>(print-test-results-row ROW)</procedure>
    287286
    288287Print the test results file entry {{ROW}} to the current output port.
     
    290289==== print-test-results-rows
    291290
    292  [procedure] (print-test-results-rows ROWS)
     291<procedure>(print-test-results-rows ROWS)</procedure>
    293292
    294293Print the test results file entry list {{ROWS}} to the current output port.
     
    296295==== print-test-results-file
    297296
    298  [procedure] (print-test-results-file FILENAME)
     297<procedure>(print-test-results-file FILENAME)</procedure>
    299298
    300299Print the test results file {{FILENAME}} to the current output port. If
     
    338337== Version History
    339338
     339; 2.0.0 : Removed 'fold-test-results-rows' & added optional folding paramters to 'read-test-results-rows' & 'read-test-results-file'
    340340; 1.1   : Split out print procedures into own file
    341341; 1.0   : Initial release
Note: See TracChangeset for help on using the changeset viewer.