| 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.
