test/integration/README

   1 Each subdirectory here is an integration test.
   2
   3 == Requirements ==
   4
   5 - xserver-xorg-video-dummy
   6 - lposix (aka lua-posix in Debian)
   7
   8 == Running the tests ==
   9
  10 Install notion and run 'make test'
  11
  12 == How it works ==
  13
  14 Each integration test basically looks like this:
  15 - Start a dummy X server (Xdummy)
  16 - Start notion with the configuration in $test/config
  17   - basically $test/config behaves like the ~user/.notion dir for this test
  18   - Right now this starts the currenly *installed* notion.
  19     It would be better if it could start the version that was
  20     built but not neccessarily installed
  21 - Execute each .lua script in $test
  22   - the .lua script is executed through notionflux, so:
  23     - it has access to the notion internals
  24     - I'm not sure whether it can 'require' stuff etc
  25   - scripts return "ok" upon success, an error message otherwise
  26
  27 == Limitations ==
  28
  29 - the x.org dummy driver does not appear to support RandR
  30   - .. but we might be able to test some of the mod_xinerama stuff with fakexinerama
  31 - there might be some SELINUX noise, probably due to the way Xdummy works
  32 - Xdummy doesn't properly autodetect which X ports are free, so we use a fixed
  33   value of :7