Mercurial > hg > nginx-tests

annotate README @ 215:7f5095965c88

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Tests: added rewrite tests for ticket #162.
author Maxim Dounin <mdounin@mdounin.ru>
date Thu, 03 May 2012 14:48:30 +0400
parents c4021ebb41b6
children b350a2cdbf58
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
38
9a7158a8609a Tests: fix typo.
Maxim Dounin <mdounin@mdounin.ru>
parents: 29
diff changeset
1 Test suite for nginx.
10
6d6776623948 Add some basic docs and license information.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
6d6776623948 Add some basic docs and license information.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3 Use prove to run tests as one usually do for perl tests. Individual tests
6d6776623948 Add some basic docs and license information.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
4 may be run as well.
6d6776623948 Add some basic docs and license information.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
5
134
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
6 Note: tests run nginx (and backend daemons if needed) listening on localhost
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
7 and may use various ports in 8000 .. 8999 range.
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
8
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
9 Usage:
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
10
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
11 $ TEST_NGINX_BINARY=/path/to/nginx prove .
26
0880e0fafde4 Tests: implement smtp test backend and use it.
Maxim Dounin <mdounin@mdounin.ru>
parents: 18
diff changeset
12
134
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
13 By default tests expect nginx binary to be at ../nginx/objs/nginx.
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
14
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
15 Environment variables:
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
16
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
17 TEST_NGINX_BINARY
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
18
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
19 Sets path to nginx binary to be tested, defaults to "../nginx/objs/nginx".
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
20
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
21 TEST_NGINX_VERBOSE
10
6d6776623948 Add some basic docs and license information.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22
134
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
23 Be a bit more verbose (in particular, print requests sent and responses
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
24 got from nginx). Note that this requires prove -v (or HARNESS_VERBOSE).
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
25
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
26 TEST_NGINX_LEAVE
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
27
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
28 If set temporary directory with configs and logs won't be deleted on test
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
29 completion. Usefull for debugging.
29
71ea39729fa0 Tests: memcached module generic tests.
Maxim Dounin <mdounin@mdounin.ru>
parents: 26
diff changeset
30
134
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
31 TEST_NGINX_CATLOG
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
32
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
33 Cat error log to stdout after test completion. Usefull for debugging.
13
e8edb765595d Tests: document ports required for tests.
Maxim Dounin <mdounin@mdounin.ru>
parents: 10
diff changeset
34
134
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
35 TEST_NGINX_UNSAFE
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
36
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
37 Run unsafe tests.
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
38
c4021ebb41b6 Tests: rewrite README to be more complete.
Maxim Dounin <mdounin@mdounin.ru>
parents: 133
diff changeset
39 Happy testing!