README.md
1== Travis CI Tests
2
3Travis is a service which will build your project when you commit or get pull requests on Github.
4
5I 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 (separate 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
18On 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
35
