Mercurial > hg > nginx-tests

comparison README @ 134:c4021ebb41b6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Tests: rewrite README to be more complete.
author Maxim Dounin <mdounin@mdounin.ru>
date Thu, 11 Mar 2010 04:17:48 +0300
parents 342b31c8f3af
children b350a2cdbf58
comparison
equal deleted inserted replaced
133:342b31c8f3af 134:c4021ebb41b6
1 Test suite for nginx. 1 Test suite for nginx.
2 2
3 Use prove to run tests as one usually do for perl tests. Individual tests 3 Use prove to run tests as one usually do for perl tests. Individual tests
4 may be run as well. 4 may be run as well.
5 5
6 Tests assume that nginx sources are in directory nginx at the same level 6 Note: tests run nginx (and backend daemons if needed) listening on localhost
7 as directory with tests, and nginx was already configured and built (i.e. 7 and may use various ports in 8000 .. 8999 range.
8 nginx binary available as ../nginx/objs/nginx from test directory).
9 8
10 Note: some tests may fail since they are for bugs not fixed in public code. 9 Usage:
11 10
12 Note: tests run nginx (and backend daemons if needed) listening on localhost. 11 $ TEST_NGINX_BINARY=/path/to/nginx prove .
13 Currently this includes following ports: 8025, 8026, 8080, 8081, 8110, 8111,
14 8143, 8144.
15 12
16 Tests for memcached required memcached itself and Cache::Memcached to be 13 By default tests expect nginx binary to be at ../nginx/objs/nginx.
17 installed.
18 14
19 Currently each test creates it's own temporary directory and uses it for 15 Environment variables:
20 logs etc. One may instruct tests not to remove the temp directory (e.g. 16
21 for analysis of failed test) by setting TEST_NGINX_LEAVE environment 17 TEST_NGINX_BINARY
22 variable. 18
19 Sets path to nginx binary to be tested, defaults to "../nginx/objs/nginx".
20
21 TEST_NGINX_VERBOSE
22
23 Be a bit more verbose (in particular, print requests sent and responses
24 got from nginx). Note that this requires prove -v (or HARNESS_VERBOSE).
25
26 TEST_NGINX_LEAVE
27
28 If set temporary directory with configs and logs won't be deleted on test
29 completion. Usefull for debugging.
30
31 TEST_NGINX_CATLOG
32
33 Cat error log to stdout after test completion. Usefull for debugging.
34
35 TEST_NGINX_UNSAFE
36
37 Run unsafe tests.
38
39 Happy testing!