diff options
author | Eric Wong <normalperson@yhbt.net> | 2010-02-17 18:53:52 -0800 |
---|---|---|
committer | Eric Wong <normalperson@yhbt.net> | 2010-02-17 18:53:52 -0800 |
commit | 5cef71dc6c640db414c41f59a5016fd3f5326bf9 (patch) | |
tree | 500cd48b0d92ba8b847ce6839d6889d5304fa11b /t/README | |
parent | 13598f977ec3b707bd1a8f2abb99825cb8f85b58 (diff) | |
download | unicorn-5cef71dc6c640db414c41f59a5016fd3f5326bf9.tar.gz |
Diffstat (limited to 't/README')
-rw-r--r-- | t/README | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/t/README b/t/README new file mode 100644 index 0000000..095f106 --- /dev/null +++ b/t/README @@ -0,0 +1,42 @@ += Unicorn integration test suite + +These are all integration tests that start the server on random, unused +TCP ports or Unix domain sockets. They're all designed to run +concurrently with other tests to minimize test time, but tests may be +run independently as well. + +We write our tests in Bourne shell because that's what we're +comfortable writing integration tests with. + +== Requirements + +* {Ruby 1.8 or 1.9}[http://www.ruby-lang.org/] (duh!) +* {GNU make}[http://www.gnu.org/software/make/] +* {socat}[http://www.dest-unreach.org/socat/] +* {curl}[http://curl.haxx.se/] +* standard UNIX shell utilities (Bourne sh, awk, sed, grep, ...) + +We do not use bashisms or any non-portable, non-POSIX constructs +in our shell code. We use the "pipefail" option if available and +mainly test with {ksh}[http://kornshell.com/], but occasionally +with {dash}[http://gondor.apana.org.au/~herbert/dash/] and +{bash}[http://www.gnu.org/software/bash/], too. + +== Running Tests + +To run the entire test suite with 8 tests running at once: + + make -j8 + +To run one individual test: + + make t0000-simple-http.sh + +You may also increase verbosity by setting the "V" variable for +GNU make. To disable trapping of stdout/stderr: + + make V=1 + +To enable the "set -x" option in shell scripts to trace execution + + make V=2 |