ceph/src/civetweb/ci/test/README.md

   1 == Travis CI Tests
   2
   3 Travis is a service which will build your project when you commit or get pull requests on Github.
   4
   5 I have fixed and extended the travis configuration to build on the new sudo-less docker infrastructure.
   6
   7 === CI Process
   8
   9 * On Check-in or Pull Requests clone the repo
  10 * Run make WITH_LUA=1 WITH_DEBUG=1 WITH_IPV6=1 WITH_WEBSOCKET=1
  11 * Build a standalone lua installation (seperate from civetweb or the OS)
  12 * Build LuaRocks in standalone installation
  13 * Install a few rocks into the standalone installation
  14 * Start the test script
  15
  16 === test/ci_tests/01_basic/basic_spec.lua
  17
  18 On the initial checkin, there is only one test which demonstrates:
  19
  20 * reliably starting civetweb server on travis infrastructure
  21 * waiting (polling) with lua.socket to establish the server is up and running
  22 * using libcurl via lua to test that files in the specified docroot are available
  23 * kill the civetweb server process
  24 * waiting (polling) the server port to see that the server has freed it
  25
  26 === Adding Tests
  27
  28 * Create a directory under ci_tests
  29 * Add a spec file, so now we have ci_tests/02_my_awesome_test/awesome_spec.lua
  30 * Any file under ci_tests which ends in _spec.lua will be automatically run
  31 * Check out the 'busted' and lua-curl3 docs for more info
  32 * https://github.com/Lua-cURL/Lua-cURLv3
  33 * http://olivinelabs.com/busted/
  34