Mercurial > hg > nginx-tests
annotate README @ 602:1177e4dd249a
Tests: read in full-size SSL records in ssl_proxy_upgrade.t.
author | Sergey Kandaurov <pluknet@nginx.com> |
---|---|
date | Tue, 09 Jun 2015 17:10:45 -0400 |
parents | b350a2cdbf58 |
children | d39e98893265 |
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 |
266
b350a2cdbf58
Tests: fixed spelling errors in README.
Ruslan Ermilov <ru@nginx.com>
parents:
134
diff
changeset
|
28 If set, temporary directory with configs and logs won't be deleted on test |
b350a2cdbf58
Tests: fixed spelling errors in README.
Ruslan Ermilov <ru@nginx.com>
parents:
134
diff
changeset
|
29 completion. Useful 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 |
266
b350a2cdbf58
Tests: fixed spelling errors in README.
Ruslan Ermilov <ru@nginx.com>
parents:
134
diff
changeset
|
33 Cat error log to stdout after test completion. Useful 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! |