| Roger Meier | f85fdd7 | 2014-03-01 17:00:46 +0100 | [diff] [blame] | 1 | # Apache Thrift - integration test suite |
| 2 | |
| 3 | This is the cross everything integration test suite for Apache Thrift. |
| 4 | executed by |
| 5 | |
| 6 | make cross |
| 7 | |
| 8 | at the moment, this starts the test.sh script which does the real cross test |
| 9 | with different transports, protocols and languages. |
| 10 | |
| 11 | Unit tests for languages ar usually located under lib/<lang>/test/ |
| 12 | cross language tests acording to [ThriftTest.thrift](ThriftTest.thrift) shall be |
| 13 | provided for every language including executables with the following command |
| 14 | line interface for servers: |
| 15 | |
| 16 | $ ./cpp/TestServer -h |
| 17 | Allowed options: |
| 18 | -h [ --help ] produce help message |
| 19 | --port arg (=9090) Port number to listen |
| 20 | --domain-socket arg Unix Domain Socket (e.g. /tmp/ThriftTest.thrift) |
| 21 | --server-type arg (=simple) type of server, "simple", "thread-pool", |
| 22 | "threaded", or "nonblocking" |
| 23 | --transport arg (=buffered) transport: buffered, framed, http |
| 24 | --protocol arg (=binary) protocol: binary, compact, json |
| 25 | --ssl Encrypted Transport using SSL |
| 26 | --processor-events processor-events |
| 27 | -n [ --workers ] arg (=4) Number of thread pools workers. Only valid for |
| 28 | thread-pool server type |
| 29 | |
| 30 | and this for clients: |
| 31 | |
| 32 | $ ./cpp/TestClient -h |
| 33 | Allowed options: |
| 34 | -h [ --help ] produce help message |
| 35 | --host arg (=localhost) Host to connect |
| 36 | --port arg (=9090) Port number to connect |
| 37 | --domain-socket arg Domain Socket (e.g. /tmp/ThriftTest.thrift), |
| 38 | instead of host and port |
| 39 | --transport arg (=buffered) Transport: buffered, framed, http, evhttp |
| 40 | --protocol arg (=binary) Protocol: binary, compact, json |
| 41 | --ssl Encrypted Transport using SSL |
| 42 | -n [ --testloops ] arg (=1) Number of Tests |
| 43 | |
| 44 | If you have executed the **make check** or **make cross** then you will be able to browse |
| 45 | [gen-html/ThriftTest.html](gen-html/ThriftTest.html) with the test documentation. |
| 46 | |
| 47 | ## SSL |
| 48 | Test Keys and Certificates are provided in multiple formats under the following |
| 49 | directory |
| 50 | |
| 51 | test/keys |
| 52 | |