Subversion Repositories Kolibri OS

Rev

Go to most recent revision | Blame | Last modification | View Log | Download | RSS feed

  1. LibCSS testcases
  2. ===============
  3.  
  4. Testcases for LibCSS are self-contained binaries which test various parts
  5. of the CSS library. These may make use of external data files to drive
  6. the testing.
  7.  
  8. Testcase command lines
  9. ----------------------
  10.  
  11. Testcase command lines are in a unified format, thus:
  12.  
  13.         <aliases_file> [ <data_file> ]
  14.  
  15. The aliases file parameter will always be specified (as it is required for
  16. the library to work at all).
  17.  
  18. The data file parameter is optional and may be provided on a test-by-test
  19. basis.
  20.  
  21. Testcase output
  22. ---------------
  23.  
  24. Testcases may output anything at all to stdout. The final line of the
  25. output must begin with either PASS or FAIL (case sensitive), indicating
  26. the success status of the test.
  27.  
  28. Test Index
  29. ----------
  30.  
  31. In the test sources directory, is a file, named INDEX, which provides an
  32. index of all available test binaries. Any new test applications should be
  33. added to this index as they are created.
  34.  
  35. The test index file format is as follows:
  36.  
  37.         file         = *line
  38.  
  39.         line         = ( entry / comment / blank ) LF
  40.  
  41.         entry        = testname 1*HTAB description [ 1*HTAB datadir ]
  42.         comment      = "#" *non-newline
  43.         blank        = 0<OCTET>
  44.  
  45.         testname     = 1*non-reserved
  46.         description  = 1*non-reserved
  47.         datadir      = 1*non-reserved
  48.  
  49.         non-newline  = VCHAR / WSP
  50.         non-reserved = VCHAR / SP
  51.  
  52. Each entry contains a mandatory binary name and description followed by
  53. an optional data directory specifier. The data directory specifier is
  54. used to state the name of the directory containing data files for the
  55. test name. This directory will be searched for within the "data"
  56. directory in the source tree.
  57.  
  58. If a data directory is specified, the test binary will be invoked for
  59. each data file listed within the data directory INDEX, passing the
  60. filename as the second parameter (<data_file>, above).
  61.  
  62. Data Index
  63. ----------
  64.  
  65. Each test data directory contains a file, named INDEX, which provides an
  66. index of all available test data files.
  67.  
  68. The data index file format is as follows:
  69.  
  70.         file         = *line
  71.  
  72.         line         = ( entry / comment / blank ) LF
  73.  
  74.         entry        = dataname 1*HTAB description
  75.         comment      = "#" *non-newline
  76.         blank        = 0<OCTET>
  77.  
  78.         dataname     = 1*non-reserved
  79.         description  = 1*non-reserved
  80.  
  81.         non-newline  = VCHAR / WSP
  82.         non-reserved = VCHAR / SP
  83.  
  84. Each entry contains a mandatory data file name and description.
  85.