Mercurial > hg > nginx-tests
annotate README @ 217:ea574aae77cb
Tests: unbreak geo and realip tests in jails.
There is no real 127.0.0.1 in jails, skip these tests if 127.0.0.1 isn't
here.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Sat, 12 May 2012 14:27:02 +0400 |
parents | c4021ebb41b6 |
children | b350a2cdbf58 |
rev | line source |
---|---|
38 | 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! |