Name | Modified | Size | Downloads / Week |
---|---|---|---|
Parent folder | |||
varexistsincaller.test | 2014-11-04 | 371 Bytes | |
upvarexistingordie.test | 2014-11-04 | 544 Bytes | |
tobackslashesb.test | 2014-11-04 | 404 Bytes | |
tobackslashes.test | 2014-11-04 | 216 Bytes | |
test.pre | 2014-11-04 | 787 Bytes | |
subtractfrom.test | 2014-11-04 | 369 Bytes | |
setzeroifempty.test | 2014-11-04 | 566 Bytes | |
retzeroifempty.test | 2014-11-04 | 345 Bytes | |
README.txt | 2014-11-04 | 4.2 kB | |
printvar.test | 2014-11-04 | 327 Bytes | |
notempty.test | 2014-11-04 | 335 Bytes | |
mashb.test | 2014-11-04 | 372 Bytes | |
mash.test | 2014-11-04 | 224 Bytes | |
isnegative.test | 2014-11-04 | 281 Bytes | |
isempty.test | 2014-11-04 | 325 Bytes | |
isdatetime.test | 2014-11-04 | 311 Bytes | |
isdate.test | 2014-11-04 | 275 Bytes | |
dictderef.test | 2014-11-04 | 325 Bytes | |
decr.test | 2014-11-04 | 310 Bytes | |
arrangedictb.test | 2014-11-04 | 594 Bytes | |
arrangedict.test | 2014-11-04 | 415 Bytes | |
all.tcl | 2014-11-04 | 165 Bytes | |
addto.test | 2014-11-04 | 347 Bytes | |
Totals: 23 Items | 12.4 kB | 0 |
APPNAME/tests README CONTENTS OF THIS FILE --------------------- 01| HOW TO USE THIS DOCUMENT 02| INTRO 03| RUNNING TESTS 04| BUG REPORTING 05| CONTRIBUTING 06| CATALOG 07| CREDITS ---01| HOW TO USE THIS DOCUMENT What is the point of these tests? What are they for? What do they accomplish? See INTRO. How can I find out what files should be in this directory and what are they for? See CATALOG. How do I run the tests myself? See RUNNING TESTS. What if I find problems with the tests? See REPORTING ISSUES. How can I contribute back tests? See CONTRIBUTING. ---02| INTRO Gen includes a moderate suite of tests which double as code samples. The purpose of the tests is not to be exhaustive and guarantee the code is perfect so much as establish a baseline of confidence in the library. The goal of the tests is to be able to say that if you find an error caused by the library code itself, you are doing something out-of-the-ordinary; all the typical ways things can go wrong, we should have checked. Note that we do not include every possible test for the core TCL commands invoked. For instance, we do not include tests to check whether the TCL regexp command works correctly or to check the input you pass in to ensure it is valid before passing it along to commands. For instance, suppose you were to enter this -- % set MyDict [ArrangeDict {one uno two dos three} {three two one}] -- here the dict is invalid. The ArrangeDict command does not check your input but rather the error "missing value to go with key" will be generated by the dict exists command, which you will see with puts $::errorInfo. So we do not have any functionality in ArrangeDict that tries to ensure a call to dict exists will not generate an error and we also do not have any corresponding tests. ---02| RUNNING TESTS To run all tests from the command line: > tclsh85 all.tcl To run all tests from the tcl shell: % source all.tct To run tests for a given proc (for instance, AddTo) from the command line: > tclsh85 addto.test To run tests for a given proc (for instance, AddTo) from the tcl shell: % source addto.test ---03| BUG REPORTING If you find bugs in tests or missing tests, please let us know. Visit http://www.robertbrogan.com/gen/feedback.html to use the form. Alternatively, send an email to: gen.bugreport@robertbrogan.com and we will try to get back to you ASAP. ---04| CONTRIBUTING Nothing formal has been set up for governing this project, yet. If you like, you may change the test code yourself or write a new test and submit a patch to: gen.bugreport@robertbrogan.com (for bug fixes) -or- gen.wishlist@robertbrogan.com (for tests you implemented) A roadmap (scheduled changes) and wishlist (not yet scheduled) are available at: http://www.robertbrogan.com/gen/roadmap.html http://www.robertbrogan.com/gen/wishlist.html You may want to get involved by submitting wishlist items and/or offering to do work listed in the above two sites. ---05| CATALOG all.tcl Test suite. addto.test Tests for command AddTo. arrangedict.test Tests for command ArrangeDict. arrangedictb.test Tests for command ArrangeDictB. decr.test Tests for command Decr. dictderef.test Tests for command DictDeref. isdate.test Tests for command IsDate. isdatetime.test Tests for command IsDateTime. isempty.test Tests for command IsEmpty. isnegative.test Tests for command IsNegative. mash.test Tests for command Mash. mashb.test Tests for command MashB. notempty.test Tests for command NotEmpty. printvar.test Tests for command PrintVar. retzeroifempty.test Tests for command RetZeroIfEmpty. setzeroifempty.test Tests for command SetZeroIfEmpty. subtractfrom.test Tests for command SubtractFrom. tobackslashes.test Tests for command ToBackslashes. upvarexistingordie.test Tests for command UpvarExistingOrDie. varexistsincaller.test Tests for command VarExistsInCaller. ---06| CREDITS Testing was done using the tcltest package included with ActiveTcl 8.5.4.0. Information posted at wiki.tcl.tk was helpful.