git.sur5r.net Git - openldap/blob - tests/data/regressions/README

   1 This directory contains test related to regression tracking that require
   2 a specific setup and a complete test.  Each regression test must be
   3 contained in a test directory whose name is "its<number>", where <number>
   4 is the ITS number, and it must be entirely executed by a script, contained
   5 in that directory and with the same name of the directory.  It can exploit
   6 all the helpers provided for common tests (variables in scripts/defines.sh,
   7 data files in data/, ...), but it should simultaneously be as self contained
   8 and as general as possible.  Warning: occasionally, data files and
   9 shell variables may change, so limit their use to real needs.
  10
  11 For example, if an issue only appears with a certain database type, the
  12 test itself should only run when invoked for that database type;
  13 otherwise, if the issue appears whatever backend is used, the test should
  14 be parameteric, so that it is run with the backend selected at run-time
  15 via the "-b" switch of the "run" script.
  16
  17 Regression tests are prepared on a voluntary basis, so don't expect all
  18 bugs to have a test any soon.  When the issue reporter provides a simple,
  19 yet complete means to reproduce the bug she's reporting, this may speed up
  20 the process.  In case, only put neutral data in bug exploitation reports.